summer-data

summer-data是一个数据库操作包，使用orm方式进行持久化操作，使用sql进行查询。

核心概念有3个：Table 、Jql 和 Jsql

Table :
- 是对数据库表的映射
- 持久化操作都是通过对 Table 的操作完成
Jql : 借助 Table，Jql 以 java 的语法对 sql语句进行映射
Jsql : Table的持久化操作和Jql的查询操作最终都是转换成Jsql执行的

1、映射数据表 -- Table

有 t_prod 和 t_prod_detail 两个表，我们使用类将2个表映射到Java。


@TableName("t_prod")
public class Prod extends Table {
  public StringColumn res_id;
  public StringColumn prod_name;
}

@TableName("t_prod_detail")
public class ProdDetail extends Table {
  public StringColumn res_id;
  public StringColumn prod_res_id;
  public StringColumn detail_name;
}

所有的字段都要定义成 public，这样

2、设定数据库连接

import cn.org.summer.SummerData;

// 设定默认数据源
DefaultDataSource.setDataSource(dataSource);

3、持久化 -- Table

insert

Prod t1 = new Prod();
t1.prod_name.setValue("walker");
Integer result = t1.insert();

update

Prod t1 = new Prod();
t1.prod_name.setValue("walker");
Integer result = t1.update(t1.id.eq("123"));

delete

Prod t1 = new Prod();
Integer result = t1.delete(t1.id.eq("123"));

4、查询 -- Jql


List<Map<String, Object>> data = Jql.with(Prod.class, ProdDetail.class).then((t1, t2) -> {
    new Jql() {{
        select(t1.prod_name, t2,detail_name);
        from(t1);
        join(t2).on(t1.res_id.eq(t2.prod_res_id));
        where(t1.res_id.lt(1));
        orderBy(t1.prod_name);
    }}
}).queryForMap();

5、查询 -- Jsql

在一些特殊场景下，Jql 无法完成业务目标时，可以使用 Jsql 。 Jsql 是 sql + 参数的组合，因此可以实现所有的业务目标。


Jsql jsql = new Jsql("select * from t_prod")
if (true) {
  jsql.append(" where res_id < ? ", 100)
}}

List<Map<String, Object>> data = jsql.queryForMap();

6、总结

Table 好理解，不赘述了
Jql 是面向 java 对象的，是强类型的，有几点好处：
- 1、能获得 java 编译器支持，基本避免了字符串拼写错误的问题
- 2、对修改和重构友好，比如：表名拼写错误 pord 要修正成 prod，这在以往的系统中就是灾难，在 jql 不用做任何修改
- 3、异构数据库支持，jql 会根据数据库的不同，生成与之对应的 sql 执行

hahan2020 / summer-data

summer-data

1、映射数据表 -- Table

2、设定数据库连接

3、持久化 -- Table

insert

update

delete

4、查询 -- Jql

5、查询 -- Jsql

6、总结

简介

发行版

贡献者

近期动态

hahan2020 / summer-data .gitee-modal { width: 500px !important; }

summer-data

1、映射数据表 -- Table

2、设定数据库连接

3、持久化 -- Table

insert

update

delete

4、查询 -- Jql

5、查询 -- Jsql

6、总结

简介

发行版

贡献者

近期动态

搜索帮助

hahan2020 / summer-data