最新版本 V1.3.1_6
1 简介
ThinkJD,又名ThinkJDBC,一个简洁而强大的开源JDBC操作库。你可以使用Java像ThinkPHP框架的M方法一样,一行代码搞定数据库操作。ThinkJD会自动管理数据库连接,使用完毕或程序异常都会关闭连接以免造成内存溢出。
先睹为快:
//数据库配置(只需调用一次)
D.setDbConfig("jdbc:mysql://127.0.0.1:3306/DbName?characterEncoding=UTF-8","root","root");
//插入数据
long id=D.M("user").field("name,weight","Tom",60).add();
//更新数据
D.M("user").field("weight",100).where("id=?",id).save();
//查询数据
User user=D.M("user").find(User.class,id);
//删除数据
D.M("user").delete(id);
2 使用方法
0x01 添加依赖
将ThinkJDBC-x.x.x.jar和下面的两个依赖库添加到项目编译路径里。
mysql-connector-java-5.1.39.jar
0x02 定义数据库
ThinkJD支持直接定义用户名密码访问数据库,也支持使用Hikari、C3P0等数据库连接池。
数据库连接方式有三种:
(1)配置文件方式
在项目根目录下添加文件(跟Hikari配置文件格式一样)
程序第一次启动时会自动加载读取配置文件,如果文件不存在则忽略。【V1.2.4_5 增加功能】
thinkjdbc.properties
jdbcUrl = jdbc:mysql://127.0.0.1:3306/thinkjdbc?useUnicode=true&characterEncoding=UTF-8
dataSource.user = root
dataSource.password = root
(2)帐号密码方式
D.setDbConfig("jdbc:mysql://127.0.0.1:3306/database?useUnicode=true&characterEncoding=UTF-8","root","root");
(3)使用数据库连接池
例如使用Hikari连接池:
HikariConfig config = new HikariConfig("/hikari.properties");
HikariDataSource dataSource = new HikariDataSource(config);
D.setDataSource(dataSource);
注:如果定义了数据库连接池,ThinkJD会优先使用。
(3)配置表前缀
只需调用一次,配置表前缀不是必需的
D.setTablePrefix("jd_");
//D.M('user') 将会操作 `jd_user` 表
注:D.M('user').prefix('jd_')方法可单独指定表前缀【V1.2.3新增】
0x03 过滤方法
操作
参数
示例
说明
table
table(String table)
table(“user”)
join
join(String join)
join(“left join machine on user.id=user_id and machine_status=1”)
field
①field(String filed)
②field(String filed, Object… dataParam)
①field(“id,username”)
②field(“id,username”,1111,”Leytton”)
①用于查询操作
②用于更新操作
where
①where(String where)
②where(String where, Object… whereParam)
①where(“id=1111 and username=’Leytton’”)
②where(“id=? and username=?”,1111,”Leytton”)
group
group(String group)
group(“type”)
having
having(String having)
having(“id>1234”)
order
order(String order)
order(“id desc”)
page
page(long page, long rows)
page(1,10)
limit
①limit(long rows)
②limit(long offset, long rows)
①limit(10)
②limit(1,10)
union
union(String union,Boolean isAll)
①union(“select * from user_two where id>1234”,false)
②union(“select * from user_two where id>1234”,true)
0x04 查询数据
操作
参数
说明
select
List select(Class type)
find
① T find(Class type)
② T find(Class type, long id)
③ T find(Class type, String key, Object value)
count
①long count()
②long count(String field)
max
double max(String field)
min
double min(String field)
avg
double avg(String field)
sum
double sum(String field)
//find查询
//select id,name from jd_user where id>4 order by id asc limit 0,1
User res = D.M("user").field("id,name").where("id>?",4).order("id asc").find(User.class);
//find 根据id查询
//select * from user where id=3 limit 0,1
User user = D.M("user").find(User.class,3);
//find根据字段查询
//select * from jd_user where name='Tom' limit 0,1
User user=D.M("user").fetchSql(true).find(User.class,"name","Bob");
//where,field过滤
//select id,name,weight from jd_user where id>3
List res = new M("user").field("id,name,weight").where("id>3").select(User.class);
//group分组查询
//select sex,sum(weight) as weight,avg(age) as age,count(id) as num from jd_user where id>5 group by sex order by sex desc limit 0,10
res = new M("user").field("sex,sum(weight) as weight,avg(age) as age,count(id) as num").where("id>?",5).group("sex").order("sex desc").page(1, 10).select(User.class);
//join联表查询
//select jd_user.id,name,weight,sum(gold) as num from jd_user left join jd_gold on user_id=jd_user.id where jd_user.id>3 group by jd_user.id
res = new M("user").field("jd_user.id,name,weight,sum(gold) as num").join("left join jd_gold on user_id=jd_user.id").where("jd_user.id>3").group("jd_user.id").select(User.class);
//union联表查询
//(select id,name from jd_user where id=4 ) union all (select id,name from jd_user where id<3) union (select id,name from jd_user where id=3)
res = new M("user").field("id,name").where("id=4").union("select id,name from jd_user where id<3",true)
.union("select id,name from jd_user where id=3",false).select(User.class);
//统计查询
long num= new M("user").where("id>3").count();
num= D.M("user").fetchSql(true).where("id>3").count("id");
num= (long) D.M("user").fetchSql(false).where("id<0").max("id");
num= (long) D.M("user").where("id<3").max("id");
num= (long) D.M("user").min("id");
num= (long) D.M("user").where("id>3").min("id");
num= (long) D.M("user").fetchSql(false).where("id>3").avg("id");
double avg= D.M("user").fetchSql(false).where("id>3").avg("id");
num= (long) D.M("user").where("id>13441").sum("age");
通过调用fetchSql(true)方法,可以获取到 ThinkJD产生的SQL语句(Exception形式)并且不会执行数据库操作。
user表结构:
字段名
数据类型
备注
id
int
用户id,自增长主键
name
varchar
用户名
age
tinyint
年龄
weight
float
体重
sex
tinyint
性别 0女/1男
time
int
时间
select()和 find()查询结果封装到JavaBean里返回:
public class User {
private long id;
private int age;
private String name;
private float weight;
private int sex;
private int num;
private long time;
public long getId() {
return id;
}
public void setId(long id) {
this.id = id;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public float getWeight() {
return weight;
}
public void setWeight(float weight) {
this.weight = weight;
}
public int getSex() {
return sex;
}
public void setSex(int sex) {
this.sex = sex;
}
public int getNum() {
return num;
}
public void setNum(int num) {
this.num = num;
}
public long getTime() {
return time;
}
public void setTime(long time) {
this.time = time;
}
}
0x05 插入数据
操作
参数
说明
add
long add()
前提方法:field()
返回自动生成的主键值;
//指定插入字段
long id=D.M("user").field("name,weight","Tom",60).add();
/*不指定插入字段,第一个参数固定为""或null,第二个参数对应id为null
*/
id=D.M("user").field("",null,"Tom",60).add();
0x06 更新数据
操作
参数
说明
save
long save()
前提方法:field(),where();
返回执行生效行数
long num=D.M("user").field("name,weight","Mike",100).where("id=?",1234).save();
num=D.M("user").field("weight",100).where("id>?",1234).save();
0x07 删除数据
操作
参数
说明
delete
long delete()
前提方法:field()
返回执行生效行数
注:为防止误删除,where条件不能为空。
long num=D.M("user").delete(13424);
num=D.M("user").delete("time",1523681398);
num=D.M("user").where("id>=?",13421).delete();
0x08 执行SQL
操作
参数
说明
execute
void execute(String… sqls)
直接执行SQL语句
D.M().execute( sql1 [ sql2 , sql3 ... ] );
0x09 事务支持
数据库表引擎应该为InnoDB以支持事务操作。
代码示例:
Connection conn=null;
try {
//获取已开启事务的数据库连接
conn = D.M().startTrans();
//使用事务连接操作数据库
long id=new M("gold").trans(conn).field("user_id,gold,type,time",3,5,0,System.currentTimeMillis()/1000).add();
System.out.println(id);
if(id>0) {
throw new SQLException("Transaction Rollback Test");
}
id=new M("gold").trans(conn).field("user_id,gold,type,time",3,5,0,System.currentTimeMillis()/1000).add();
System.out.println(id);
//提交事务
D.M().commit(conn);
} catch (SQLException e) {
e.printStackTrace();
try {
//事务回滚
D.M().rollback(conn);
} catch (SQLException e1) {
e1.printStackTrace();
}
}
3 许可证
4 关于
如果喜欢的话,请点个赞让我知道哦~在找到比它用得更顺手的JDBC库之前,这个项目会持续更新。