sqlactio-自动生成JDBC代码的数据库持久层工具1.概述
厌烦了MyBatis和JPA(Hiberate)的冗余配置和繁琐使用，以及XML拷来拷去，写那么多Mapper要是直接用JDBC早就写完了，如果使用一个框架/工具比不使用而带来更多的心智负担，那还不如不用。其实，直接使用JDBC还是蛮干净和高性能的，只要解决其三个痛点：
手工编写数据库表实体类。手工编写大量setStrig和getStrig代码，尤其还要人工保证字段序号递增。因为直接写SQL，涉及不同DBMS的SQL方言时，移植性不好，比如分页查询。能否造一个更好的轮子？
于是，我花了十多个晚上，结合之前在C技术栈中的设计和经验，结合JAVA特点，写了sqlactio。
sqlactio是自动生成JDBC代码的数据库持久层工具，它为应用提供了类似MyBatis和Hiberate操作数据库能力，但更轻量级和几乎消除了所有的手工冗余编码，提高开发效率，也易于与其它框架搭配使用。sqlactio读取数据库中的表结构元信息和少量配置文件信息（SQL），自动生成数据库表实体类，自动生成基于JDBC的SQL动作方法代码，自动生成拦截器框架等代码，应用调用其自动生成的代码就能极其快捷的操作数据库，同时还拥有JDBC的高性能，更重要的是开发者能直接看到底层操作代码，增加自主可控，没有低效的反射，没有复杂的热修改字节码，没有庞大笨重的隐藏核心。
2.一个DEMO放一个DEMO感受一下：
2.1.建表DDLddl.sql
CREATETABLE`sqlactio_demo`(`id`it(11)NOTNULLAUTO_INCREMENTCOMMENT'编号',`ame`varchar(32)COLLATEutf8mb4_biNOTNULLCOMMENT'名字',`address`varchar(128)COLLATEutf8mb4_biDEFAULTNULLCOMMENT'地址',PRIMARYKEY(`id`),KEY`sqlactio_demo`(`ame`))ENGINE=IoDBAUTO_INCREMENT=6DEFAULTCHARSET=utf8mb4COLLATE=utf8mb4_bi2.2.新建JAVA项目只依赖数据库连接库和作者另一个JSON解析器okjso，引入mysql-coector-java-X.Y.Z.jar、okjso-0.0.9.0.jar。
建立包目录，在包目录或上级某一级目录中创建数据库连接配置文件dbserver.cof.jso，工具会从执行目录开始往上查找，只要某一级目录中存在这个配置文件即可。
{"driver":"com.mysql.jdbc.Driver","url":"jdbc:mysql://127.0.0.1:3306/calvidb?serverTimezoe=GMT","user":"calvi","pwd":"calvi"}在包目录或上级某一级目录中创建SQL动作配置文件sqlactio.cof.jso，工具会从执行目录开始往上查找，只要某一级目录中存在这个配置文件即可。
{"database":"calvidb","tables":[{"table":"sqlactio_demo","sqlactios":["SELECT*FROMsqlactio_demo","SELECT*FROMsqlactio_demoWHEREame=?","INSERTINTOsqlactio_demo","UPDATEsqlactio_demoSETaddress=?WHEREame=?@@METHOD(updateAddressByName)","DELETEFROMsqlactio_demoWHEREame=?"]}],"javaPackage":"xyz.calviwilliams.sqlactio.demo"}2.3.在包目录中执行sqlactio工具我把执行命令行包成批处理文件后执行，欢迎懂Eclipse插件开发的同学帮我写个插件:)
pp.bat
java-Dfile.ecodig=UTF-8-classpath"D:\Work\mysql-coector-java-8.0.15\mysql-coector-java-8.0.15.jar;%USERPROFILE%\.m2\repository\xyz\calviwilliams\okjso\0.0.9.0\okjso-0.0.9.0.jar;%USERPROFILE%\.m2\repository\xyz\calviwilliams\sqlactio\0.2.1.0\sqlactio-0.2.1.0.jar"xyz.calviwilliams.sqlactio.SqlActioGecodepause注意：使用Mave管理的项目，在添加sqlactio依赖声明后，mave会自动下载sqlactio以及其依赖okjso的jar到C:\User\用户名\.m2\repository\xyz\calviwilliams\下。sqlactio依赖声明见最后面“关于本项目”章节。
执行pp.bat，工具sqlactio会从执行目录开始往上查找读入dbserver.cof.jso和sqlactio.cof.jso并自动生成所有代码。
/////////////////////////////////////////////////////////////////////////////////sqlactiov0.0.8.0///Copyrightbycalvi<calviwilliams@163.com,calviwilliams@gmail.com>//////////////////////////////////////////////////////////////////////////////---dbserverCof---dbms[mysql]driver[com.mysql.jdbc.Driver]url[jdbc:mysql://127.0.0.1:3306/calvidb?serverTimezoe=GMT]user[calvi]pwd[calvi]---sqlactioCof---database[calvidb]table[sqlactio_demo]sqlactio[SELECT*FROMsqlactio_demo]sqlactio[SELECT*FROMsqlactio_demoWHEREame=?]sqlactio[INSERTINTOsqlactio_demo]sqlactio[UPDATEsqlactio_demoSETaddress=?WHEREame=?@@METHOD(updateAddressByName)]sqlactio[DELETEFROMsqlactio_demoWHEREame=?]SqlActioTable.getTableIDatabase[sqlactio_demo]............***NOTICE:WriteSqlactioDemoSAO.javacompleted!!!如果没有出现***ERROR:...说明工具执行成功，在执行所在目录中自动生成了一个JAVA源代码文件
SqlactioDemoSAO.java
//Thisfilegeeratedbysqlactiov0.2.1.0packagexyz.calviwilliams.sqlactio.demo;importjava.math.*;importjava.util.*;importjava.sql.Time;importjava.sql.Timestamp;importjava.sql.Coectio;importjava.sql.Statemet;importjava.sql.PreparedStatemet;importjava.sql.ResultSet;publicclassSqlactioDemoSAO{itid;//编号Strigame;//名字Strigaddress;//地址it_cout_;//defiigfor'SELECTCOUNT(*)'//SELECT*FROMsqlactio_demopublicstaticitSELECT_ALL_FROM_sqlactio_demo(Coectioco,List<SqlactioDemoSAO>sqlactioDemoListForSelectOutput)throwsExceptio{Statemetstmt=co.createStatemet();ResultSetrs=stmt.executeQuery("SELECT*FROMsqlactio_demo");while(rs.ext()){SqlactioDemoSAOsqlactioDemo=ewSqlactioDemoSAO();sqlactioDemo.id=rs.getIt(1);sqlactioDemo.ame=rs.getStrig(2);sqlactioDemo.address=rs.getStrig(3);sqlactioDemoListForSelectOutput.add(sqlactioDemo);}retursqlactioDemoListForSelectOutput.size();}//SELECT*FROMsqlactio_demoWHEREame=?publicstaticitSELECT_ALL_FROM_sqlactio_demo_WHERE_ame_E_(Coectioco,List<SqlactioDemoSAO>sqlactioDemoListForSelectOutput,Strig_1_ame)throwsExceptio{PreparedStatemetprestmt=co.prepareStatemet("SELECT*FROMsqlactio_demoWHEREame=?");prestmt.setStrig(1,_1_ame);ResultSetrs=prestmt.executeQuery();while(rs.ext()){SqlactioDemoSAOsqlactioDemo=ewSqlactioDemoSAO();sqlactioDemo.id=rs.getIt(1);sqlactioDemo.ame=rs.getStrig(2);sqlactioDemo.address=rs.getStrig(3);sqlactioDemoListForSelectOutput.add(sqlactioDemo);}retursqlactioDemoListForSelectOutput.size();}//INSERTINTOsqlactio_demo(ame,address)VALUES(?,?)publicstaticitINSERT_INTO_sqlactio_demo(Coectioco,SqlactioDemoSAOsqlactioDemo)throwsExceptio{PreparedStatemetprestmt=co.prepareStatemet("INSERTINTOsqlactio_demo(ame,address)VALUES(?,?)");prestmt.setStrig(1,sqlactioDemo.ame);prestmt.setStrig(2,sqlactioDemo.address);returprestmt.executeUpdate();}//UPDATEsqlactio_demoSETaddress=?WHEREame=?publicstaticitupdateAddressByName(Coectioco,Strig_1_address_ForSetIput,Strig_1_ame_ForWhereIput)throwsExceptio{PreparedStatemetprestmt=co.prepareStatemet("UPDATEsqlactio_demoSETaddress=?WHEREame=?");prestmt.setStrig(1,_1_address_ForSetIput);prestmt.setStrig(2,_1_ame_ForWhereIput);returprestmt.executeUpdate();}//DELETEFROMsqlactio_demoWHEREame=?publicstaticitDELETE_FROM_sqlactio_demo_WHERE_ame_E_(Coectioco,Strig_1_ame)throwsExceptio{PreparedStatemetprestmt=co.prepareStatemet("DELETEFROMsqlactio_demoWHEREame=?");prestmt.setStrig(1,_1_ame);returprestmt.executeUpdate();}}SqlactioDemoSAU.java
//Thisfilegeeratedbysqlactiov0.2.1.0packagexyz.calviwilliams.sqlactio;importjava.math.*;importjava.util.*;importjava.sql.Time;importjava.sql.Timestamp;importjava.sql.Coectio;importjava.sql.Statemet;importjava.sql.PreparedStatemet;importjava.sql.ResultSet;publicclassSqlactioDemoSAU{}工具sqlactio内部处理流程如下：
首先查找执行目录中的数据库连接配置文件dbserver.cof.jso，如果没有找到就迭代往上级目录继续找，从该配置文件中获得数据库连接配置信息。然后以相同的查找逻辑读取sqlactio.cof.jso获得数据库名、表列表、以及每张表需要执行的SQL语句列表等信息。配置文件往上查找机制是为了灵活适应不同规模项目目录的规划。连接数据库，读取表结构元信息，每张表对应自动生成数据库表实体类和SQL动作方法JAVA源代码文件XxxSao.java和用户自定义代码文件XxxSau.java，，sqlactio配置文件中的每一条SQL自动解析生成基于JDBC的JAVA方法，从此再也不用手工写JDBC代码了！2.4.到目前为止，一行JAVA代码都没写，现在开始写应用代码Demo.java
packagexyz.calviwilliams.sqlactio.demo;importjava.sql.Coectio;importjava.sql.DriverMaager;importjava.sql.SQLExceptio;importjava.util.LikedList;importjava.util.List;publicclassDemo{publicstaticvoidmai(Strig[]args){Coectioco=ull;List<SqlactioDemoSAO>sqlactioDemoList=ull;SqlactioDemoSAOsqlactioDemo=ull;SqlactioDemoSAOsqlactioDemoForSetIput=ull;SqlactioDemoSAOsqlactioDemoForWhereIput=ull;itret=0;//Coecttodatabasetry{Class.forName("com.mysql.jdbc.Driver");co=DriverMaager.getCoectio("jdbc:mysql://127.0.0.1:3306/calvidb?serverTimezoe=GMT","calvi","calvi");}catch(ClassNotFoudExceptioe1){e1.pritStackTrace();}catch(SQLExceptioe){e.pritStackTrace();}try{co.setAutoCommit(false);//Deleterecordswithameret=SqlactioDemoSAO.DELETE_FROM_sqlactio_demo_WHERE_ame_E_(co,"Calvi");if(ret<0){System.out.pritl("SqlactioDemoSAO.DELETE_FROM_sqlactio_demo_WHERE_ame_E_failed["+ret+"]");co.rollback();retur;}else{System.out.pritl("SqlactioDemoSAO.DELETE_FROM_sqlactio_demo_WHERE_ame_E_ok,rows["+ret+"]effected");}//IsertrecordsqlactioDemo=ewSqlactioDemoSAO();sqlactioDemo.ame="Calvi";sqlactioDemo.address="Myaddress";ret=SqlactioDemoSAO.INSERT_INTO_sqlactio_demo(co,sqlactioDemo);if(ret<0){System.out.pritl("SqlactioDemoSAO.INSERT_INTO_sqlactio_demofailed["+ret+"]");co.rollback();retur;}else{System.out.pritl("SqlactioDemoSAO.INSERT_INTO_sqlactio_demook");}//Updaterecordwithameret=SqlactioDemoSAO.updateAddressByName(co,"Myaddress2","Calvi");if(ret<0){System.out.pritl("SqlactioDemoSAO.updateAddressByNamefailed["+ret+"]");co.rollback();retur;}else{System.out.pritl("SqlactioDemoSAO.updateAddressByNameok,rows["+ret+"]effected");}//QueryrecordssqlactioDemoList=ewLikedList<SqlactioDemoSAO>();ret=SqlactioDemoSAO.SELECT_ALL_FROM_sqlactio_demo(co,sqlactioDemoList);if(ret<0){System.out.pritl("SqlactioDemoSAO.SELECT_ALL_FROM_sqlactio_demofailed["+ret+"]");co.rollback();retur;}else{System.out.pritl("SqlactioDemoSAO.SELECT_ALL_FROM_sqlactio_demook");for(SqlactioDemoSAOr:sqlactioDemoList){System.out.pritl("id["+r.id+"]ame["+r.ame+"]address["+r.address+"]");}}co.commit();}catch(Exceptioe){try{co.rollback();}catch(Exceptioe2){retur;}}retur;}}2.5.执行SqlactioDemoSAO.DELETE_FROM_sqlactio_demo_WHERE_ame_E_ok,rows[1]effectedSqlactioDemoSAO.INSERT_INTO_sqlactio_demookSqlactioDemoSAO.UPDATE_sqlactio_demo_SET_address_E_WHERE_ame_E_ok,rows[1]effectedSqlactioDemoSAO.SELECT_ALL_FROM_sqlactio_demookid[15]ame[Calvi]address[Myaddress2]总结：
对表的增删改查只需调用前面自动生成的数据库表实体类中的方法即可，而且底层执行代码可随时查看，没有什么秘密，没有什么高深的技术。
工具sqlactio只在开发阶段使用，与运行阶段无关，说到底只是在应用与JDBC之间自动生成了薄薄的一层代码而已，把大量手工冗余代码都自动生成了，让开发者节省大量时间而去关注业务，减少大量机械操作减轻心智负担，提高生产力，早点做完工作回家抱女盆友/老婆:)
6.关于本项目欢迎使用sqlactio，如果你在使用中碰到了问题请告诉我，谢谢^_^
源码托管地址: Gitee、github
ApacheMave
<depedecy><groupId>xyz.calviwilliams</groupId><artifactId>sqlactio</artifactId><versio>0.2.1.0</versio></depedecy>GradleKotliDSL
compile("xyz.calviwilliams:sqlactio:0.2.1.0")7.关于作者厉华，右手C，左手JAVA，写过小到性能卓越方便快捷的日志库、HTTP解析器、日志采集器等，大到交易平台/中间件等，分布式系统实践者，容器技术专研者，目前在某城商行负责基础架构。
通过邮箱联系我: 网易、Gmail
评论