内容简介:jSqlBox是一个Java全功能数据库持久层工具,主页 https://gitee.com/drinkjava2/jsqlbox jSqlBox主要特点是架构优、尺寸小、功能全,基本上所有与数据库操作相关的功能,jSqlBox都已提供。其它数据库工具的主要功...
jSqlBox是一个 Java 全功能数据库持久层工具,主页 https://gitee.com/drinkjava2/jsqlbox
jSqlBox主要特点是架构优、尺寸小、功能全,基本上所有与数据库操作相关的功能,jSqlBox都已提供。其它数据库 工具 的主要功能,jSqlBox通常都有对应的方案提供,不提供的往往是不重要甚至是反模式的功能,不信可以随便找一个其它持久层工具的功能,而jSqlBox却没有提供或无法轻易实现的功能来,我会给一个合理解释。反之,如下jSqlBox具备的功能其它持久层工具往往并不提供:
1.支持在Java里存放和定位多行(SQL)文本
2.参数内嵌式 SQL 写法
3.自带分库分表
4.自带声明式事务、分布式事务
5.ActiveRecord模式实体类可以只声明接口,不占用宝贵的单继承
6.支持多种数据库方言的DDL生成
jSqlBox的目标是做最好的通用持久层工具,正如我喜欢给别的项目找缺点一样,也欢迎大家来找出jSqlBox的缺点。开源项目就是在不断的对比和相互学习中进步的。另外如果有谁想听我唠叨其它持久层工具优缺点的,也可以在评论里提出,一起来讨论,jSqlBox是因为无法忍受现有持久层工具的缺点而诞生的,但是缺点是不是都找对了是值得花时间讨论的。
本次更新(4.0.3.jre8版)内容:
1. [I19WO0] 添加@CreateTimestamp和@UpdateTimestamp两个实体注解,前者在实体插入到数据库时自动写入当前时间戳,后者在实体更新时自动更新对应字段的时间戳,这两个注解添加在Date或Timestamp类型上,一个使用示例如下:
public class SomeEntity {
@CreateTimestamp
java.sql.TimeStamp createTime;
@Temporal(TemporalType.TIMESTAMP) //指定Date的映射类型,可选
@UpdateTimestamp
java.util.Date updateTime;
...
}
2. 添加@CreatedBy和@LastModifiedBy两个实体注解,前者在实体插入到数据库时自动写入当前创建者ID,后者在实体更新时自动更新对应字段的编辑者ID,这两个注解添加在实体的String类型属性上,一个使用示例如下:
public class SomeEntity {
@CreatedBy
String creator;
@LastModifiedBy
String modifier;
...
}
因为这两个注解的当前创建者或修改者ID是在运行期动态获取的,所以如果用到这两个注解,必须在jSqlBox的DbContext上下文初始化时,先设置一个编辑者ID获取类的实例,这个类中必须有一个名为getCurrentAuditor的方法。示例如下:
public static class GetUserIdDemo {
public Object getCurrentAuditor() {
//从Spring Security或Shiro之类的单点登录工具中获取当前用户ID值
return SomeSecurityUtil.getCurrentUserID();
}
}
DbContext db=new DbContext(dataSource);
db.setAuditorGetter(new GetUserIdDemo());
3. 添加一个@COLUMN实体注解
@COLUMN这个全大写的注解表示它是非标的,与标准JPA的@Column注解的区别是多了creationTimestamp, cpdateTimestamp, createdBy, lastModifiedBy, comment, tail这几个私房货字段。所以@CreationTimestamp注解也可以写成@COLUMN(creationTimestamp=true),效果等同。
@COLUMN注解中的comment和tail不会覆盖掉columnDefinition的内容,而是累加在后面。comment顾名思义是数据表collumn列定义的comment片段,tail则可以加入任意字符串内容到column的DDL列定义未尾。
4. 增强了从数据库生成Java实体源代码功能,将细节配置放在map里作为参数,并增加了linkStyle和fieldFlags两个选项。使用示例如下,以下语句会读取数据库所有表格并在指定的"c:\temp"目录下生成与所有数据库表格对应的实体类源码:
Map<String, Object> setting = new HashMap<String, Object>();
setting.put("packageName", "somepackage");
setting.put("imports",
"import com.github.drinkjava2.jdialects.annotation.jdia.*;\n"
+ "import com.github.drinkjava2.jdialects.annotation.jpa.*;\n"
+ "import com.github.drinkjava2.jsqlbox.*;\n"
+ "import static com.github.drinkjava2.jsqlbox.DB.*;\n");
setting.put("classDefinition", "public class $1 extends ActiveRecord<$1>");
setting.put("linkStyle", true);
setting.put("fieldFlags", true);
...
TableModelUtils.db2JavaSrcFiles(dataSource, Dialect.MySqlDialect, "c:/temp", setting);
db2JavaSrcFiles方法的第一个参数是数据池,第二个参数是方言,第三个参数是输出目录,第四个参数是一个细节配置Map,其中的设定有:
packageName: 实体类的包名
imports: 要引入哪些外部包
classDefinition: 类定义模板,$1占位符会被类名替换,类可以是POJO,也可以继承于jSqlBox的ActiveRecord或只声明实现ActiveEntity接口(限Java8)。
linkStyle:生成链式风格的setter, 即settter方法不再是void声明,而是会返回类实例本身。链式风格的优点是可以写出非常简洁高效的语句,如:
new User().setId("张三").load().setAge(13).update();
fieldFlags: 为每一个实体属性生成一个字符串常量,常量名为为属性的大写,值为数据表的列名。有了这个字段,可以利用它来拼写支持重构的SQL。
以下是一个实际由jSqlBox的源码生成程序生成的实体类示例,它的linkStyle属性和fieldFlags属性都设为了true:
package somepackage;
import com.github.drinkjava2.jdialects.annotation.jdia.*;
import com.github.drinkjava2.jdialects.annotation.jpa.*;
import com.github.drinkjava2.jsqlbox.*;
import static com.github.drinkjava2.jsqlbox.DB.*;
@Table(name="entity1")
public class Entity1 extends ActiveRecord<Entity1> {
public static final String ID = "id";
@Id
@Column(name=ID)
private Integer id;
public static final String NAME = "name";
@Id
@Column(name=NAME, length=10)
private String name;
public static final String CUSTID = "cust_id";
@Column(name=CUSTID)
private Integer custId;
public Integer getId(){
return id;
}
public Entity1 setId(Integer id){
this.id=id;
return this;
}
public String getName(){
return name;
}
public Entity1 setName(String name){
this.name=name;
return this;
}
public Integer getCustId(){
return custId;
}
public Entity1 setCustId(Integer custId){
this.custId=custId;
return this;
}
}
实体源码自动生成功能在项目开发初期比较有用,尤其是以数据库建模驱动而不是以实体建模驱动开发的项目,但是不能过分依赖它,代码生成工具到了项目后期就成了鸡肋,实体字段的增减、重构,直接在IDE里修改反而更简单稳当。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 码农网
猜你喜欢:- 基于关系数据库的数据库功能依赖性
- 评论模块 - 后端数据库设计及功能实现
- Azure云MySQL数据库受限功能列表
- FoundationDB Record Layer 宣布开源,提供关系数据库功能
- vue实现的上传图片到数据库并显示到页面功能示例
- PHP 文件数据库 CuteDB v1.1 发布,增加迭代器功能
本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。
卓有成效的程序员
Neal Ford / 熊节 / 机械工业出版社 / 2009-3 / 45.00元
《卓有成效的程序员》就是讲述如何在开发软件的过程中变得更加高效。同时,《卓有成效的程序员》的讲述将会跨语言和操作系统:很多技巧的讲述都会伴随多种程序语言的例子,并且会跨越三种主要的操作系统,Windows(多个版本),Mac OS X以及 *-nix (Unix或者Linux)。 《卓有成效的程序员》讨论的是程序员个体的生产力,而不是团队的生产力问题,所以它不会涉及方法论(好吧,可能总会在......一起来看看 《卓有成效的程序员》 这本书的介绍吧!