https://gitee.com/LeeFJ/foxnic
关于 Foxnic-SQL 解决的痛点与设计初衷，可以跟进 Foxnic-SQL 的相关视频。
视频地址：http://foxnicweb.com/docs/doc.html#0,4
Foxnic-SQL 即支持以实体模型为中心的开发模式，也支持以SQL语句为中心(DBA视角)的开发模式。
Foxnic-SQL 在技术和代码层面简化开发过程，目的是使开发人员由技术聚焦转到业务聚焦和数据聚焦，专注业务落地，体现系统价值。
引入依赖
第一步：加入 Foxnic Repository 到 pom 文件
foxnic
Foxnic Repository
http://foxnicweb.com:9091/repository/maven-releases/
第二步：引入 Foxnic-SQL 依赖
com.github.foxnic
foxnic-sql
1.6.0.RELEASE
第三步：引入其它依赖包(可选)
com.github.foxnic
foxnic-generator
1.6.0.RELEASE
com.github.foxnic
foxnic-dao
1.6.0.RELEASE
Insert insert = new Insert("bpm_demo_leave");
insert.set("id", id)
.set("type", "type-1")
.set("begin_time", new Date())
.set("end_time", new Date())
.set("reason", "天气不错，出去旅游");
System.out.println(insert.getSQL());
//输出 : INSERT INTO bpm_demo_leave ( id , type , begin_time , end_time , reason ) VALUES ( '001' , 'type-1' , str_to_date('2022-12-01 10:13:35','%Y-%m-%d %H:%i:%s') , str_to_date('2022-12-01 10:13:35','%Y-%m-%d %H:%i:%s') , '天气不错，出去旅游' )public class WhereDemo {
public Where makeWhere(String name,Integer height) {
Where where = new Where("valid = ?" ,1);
where.andLike("name",name);
where.andIf("height > ?",height);
return where;
}
public static void main(String[] args) {
WhereDemo demo=new WhereDemo();
Where wh1=demo.makeWhere("leefj",18);
System.out.println(wh1);
//输出 : WHERE valid = 1 AND name like '%leefj%' AND height > 18
Where wh2=demo.makeWhere("leefj",null);
System.out.println(wh2);
//输出 : WHERE valid = 1 AND name like '%leefj%'
Where wh3=demo.makeWhere(null,18);
System.out.println(wh3);
//输出 : WHERE valid = 1 AND height > 18
}
}
// 在外部文件中定义语句
[query-root-orgs]
select m.*,(select count(1) from hrm_organization cm where m.id=cm.parent_id and cm.deleted=0) child_count,(select count(1) from hrm_position cm where m.id=cm.org_id and cm.deleted=0) position_count from hrm_organization m
where m.parent_id='0' and company_id=? and tenant_id=? and m.deleted=0 order by type asc, sort ascprivate RcdSet queryChildOrgs(String parentId,String targetType) {
RcdSet nodes=null;
String tenantId= SessionUser.getCurrent().getActivatedTenantId();
String companyId=SessionUser.getCurrent().getActivatedCompanyId();
if(parentId==null || parentId.equals(IOrganizationService.ROOT_ID)) {
// 使用外部文件已经定义的 ID 执行语句
nodes=dao.query("#query-root-orgs",companyId,tenantId);
} else {
nodes=dao.query("#query-orgs-by-parent-id",companyId,tenantId,parentId);
}
return nodes;
}// 默认数据库执行的语句
[update-org-hierarchy-step2]
UPDATE hrm_organization c, hrm_organization p
SET c.hierarchy=CONCAT(p.hierarchy,'/',c.id)
WHERE c.tenant_id=? and p.id=c.parent_id and c.hierarchy is null and p.hierarchy is not null
// 在达梦数据库时执行该语句
[update-org-hierarchy-step2:dm]
UPDATE hrm_organization c SET
c.hierarchy=CONCAT((select p.hierarchy from hrm_organization p WHERE p.id=c.parent_id and p.hierarchy is not null),'/',c.id)
where c.hierarchy is nullFoxnic-SQL 从 DAO 出发，扩展出数据库元数据、序列生成、增删改查、SQL构建、数据集、实体、全局关系与Join等方面的特性。
public static void main(String[] args) {
// 创建DAO
DAO dao=DBInstance.DEFAULT.dao();
// 获得所有表名
String[] tableNames=dao.getTableNames();
// 遍历表名
for (String tableName : tableNames) {
System.out.println(tableName);
}
// 获得指定表的元数据
DBTableMeta tm=dao.getTableMeta("sys_user");
// 遍历列
for (DBColumnMeta column : tm.getColumns()) {
System.out.println(column.getColumn()+"\t"+column.getLabel());
}
}public static void main(String[] args) {
// 创建DAO
DAO dao=DBInstance.DEFAULT.dao();
String name="my-sample-demo";
DBSequence sequence=dao.getSequence(name);
// 如果不存在就创建
if(!sequence.exists()) {
// 创建序列
sequence.create(SequenceType.AI,10,4);
}
// 循环取数
for (int i = 0; i < 100; i++) {
System.out.println(i+" = "+sequence.nextLong());
}
}public static void main(String[] args) {
// 创建DAO
DAO dao = DBInstance.DEFAULT.dao();
RcdSet rs = dao.queryPage("select * from sys_dict where code like ?", 50, 1, "%o%");
for (Rcd r : rs) {
System.out.println(r.toJSONObject());
}
}/**
* 实体类生成器
* */
public class EntityGenerator {
private static final String BASE_PACKAGE = "com.leefj.foxnic.sql.demo";
private DAO dao = null;
/**
* 需要首先运行 ExampleDBMetaGenerator 生成 ExampleTables 类
* */
public static void main(String[] args) {
EntityGenerator generator = new EntityGenerator();
generator.generate(ExampleTables.EXAMPLE_GOODS.$TABLE);
generator.generate(ExampleTables.EXAMPLE_ORDER.$TABLE);
generator.generate(ExampleTables.EXAMPLE_ORDER_ITEM.$TABLE);
generator.generate(ExampleTables.EXAMPLE_ADDRESS.$TABLE);
}
public EntityGenerator() {
dao = DBInstance.DEFAULT.dao();
}
public void generate(DBTable table) {
String pkg = table.name().split("_")[0];
String prefix = pkg + "_";
ModuleContext context = new ModuleContext(GeneratorUtil.initGlobalSettings(),table,prefix,BASE_PACKAGE + "." + pkg);
context.setDomainProject(GeneratorUtil.getProject());
context.setDAO(dao);
context.buildPo();
}
}
public static void demo1() {
DAO dao = DBInstance.DEFAULT.dao();
// 创建实体对象，并设置属性值
Goods goods = new Goods();
String id = IDGenerator.getSnowflakeIdString();
goods.setId(id)
.setName("大红枣")
.setPrice(new BigDecimal(2.5));
// 插入数据
dao.insertEntity(goods);
// 查询数据
goods = dao.queryEntityById(Goods.class,id);
// 修改后保存
goods.setPrice(new BigDecimal(2.6));
dao.updateEntity(goods, SaveMode.DIRTY_FIELDS);
// 再次查询
goods = dao.queryEntityById(Goods.class, id);
System.out.println(JSON.toJSON(goods));
}public static void demo_relation() {
DAO dao = DBInstance.DEFAULT.dao();
// 创建订单
Order order=new Order();
String orderId=IDGenerator.getSnowflakeIdString();
order.setId(orderId);
order.setOrderNo(IDGenerator.getNanoId(8));
order.setAmount(new BigDecimal(800));
// 创建订单的收件地址
Address address=new Address();
address.setId(IDGenerator.getSnowflakeIdString());
address.setRegionType("国内");
address.setRegionLocation("华东");
address.setAddress("宁波");
address.setName("LeeFJ");
address.setPhoneNumber("13444025142");
// 指定订单的地址ID
order.setAddressId(address.getId());
// 保存地址和订单
dao.insertEntity(address);
dao.insertEntity(order);
// 从数据库查询订单
Order orderFromDB=dao.queryEntityById(Order.class,orderId);
// 使用 join 方法关联并填充地址对象
dao.join(orderFromDB, OrderMeta.ADDRESS);
// 打印输出的数据
System.out.println(JSON.toJSON(orderFromDB));
System.out.println(JSON.toJSON(orderFromDB.getAddress()));
} Foxnic-SQL 支持 Pojo 实体，也可以将 Pojo 类继承 Foxnic-SQL 的 Entity 类以获得更强大的功能 。以上示例中的实体数据操作、关系的Join特性就是一个很好的佐证。
Foxnic-SQL 目前已经支持的数据库类型有 Oracle、MS SQL Server，MySQL、PG、DB2、达梦、OceanBase。
接下来，让我们一起感受一下 Foxnic-SQL 带来的开发之旅吧。