dbVisitor（原HasorDB）是一个全功能数据库访问工具，提供对象映射、丰富的类型处理、动态SQL、存储过程、内置分页方言20+、支持嵌套事务、多数据源、条件构造器、INSERT策略、多语句/多结果。并兼容Sprig及MyBatis用法。它不依赖任何其它框架，因此可以很方便的和任意一个框架整合在一起使用。
功能特性熟悉的方式 JdbcTemplate接口方式（高度兼容SprigJDBC）Mapper文件方式（高度兼容MyBatis）LambdaTemplate（高度接近MyBatisPlus、jOOQ和BeetlSQL）@Isert、@Update、@Delete、@Query、@Callable注解（类似JPA）事务支持支持5个事务隔离级别、7个事务传播行为（与Sprigtx相同）提供TrasactioTemplate、TrasactioMaager接口方式声明式事务控制能力（用法与Sprig相同）特色优势支持分页查询并且提供多种数据库方言（20+）支持INSERT策略（INTO、UPDATE、IGNORE）更加丰富的TypeHadler（MyBatis40+，dbVisitor60+）MapperXML支持多语句、多结果提供独特的规则机制，让动态SQL更加简单支持存储过程支持JDBC4.2和Java8中时间类型支持多数据源引入依赖在https://mvrepository.com/artifact/et.hasor/dbvisitor上也可以查询到最新版本<depedecy><groupId>et.hasor<groupId><artifactId>dbvisitor<artifactId><versio>5.0.1<versio>depedecy>然后再引入数据库驱动以MySQL，Mave方式为例：<depedecy><groupId>mysql<groupId><artifactId>mysql-coector-java<artifactId><versio>8.0.22<versio>depedecy>使用dbVisitor 可以不依赖数据库连接池，但有数据库连接池是大多数项目的标配。这里选用Alibaba的Druid<depedecy><groupId>com.alibaba<groupId><artifactId>druid<artifactId><versio>1.1.23<versio>depedecy>最后准备一个数据库表，并初始化一些数据（CreateDB.sql文件）droptableifexists`test_user`;createtable`test_user`(`id`it(11)auto_icremet,`ame`varchar(255),`age`it,`create_time`datetime,primarykey(`id`));isertito`test_user`values(1,'mali',26,ow());isertito`test_user`values(2,'dative',32,ow());isertito`test_user`values(3,'jowes',41,ow());isertito`test_user`values(4,'mary',66,ow());isertito`test_user`values(5,'matt',25,ow());执行SQL使用SQL的方式读取数据，PritUtils和DsUtils两个工具类可以在例子工程中找到//创建数据源DataSourcedataSource=DsUtils.dsMySql();//创建JdbcTemplate对象JdbcTemplatejdbcTemplate=ewJdbcTemplate(dataSource);//加载测试数据脚本jdbcTemplate.loadSQL("CreateDB.sql");//查询数据并Map形式返回List<Map<Strig,Object>>mapList=jdbcTemplate.queryForList("select*fromtest_user");//打印测试数据PritUtils.pritMapList(mapList);控制台可以得到如下结果/--------------------------------------------\\|id|ame|age|create_time||--------------------------------------------||1|mali|26|2021-11-1219:14:06.0||2|dative|32|2021-11-1219:14:06.0||3|jowes|41|2021-11-1219:14:06.0||4|mary|66|2021-11-1219:14:06.0||5|matt|25|2021-11-1219:14:06.0|\\--------------------------------------------/如果想使用DTO对象接收数据，则需要创建一个DTO对象。//如果属性名和列名可以完全匹配，那么无需任何注解。//-本列中由于`test_user`的表名和列名符合驼峰转下划线，那么可以简单的通过@Table注解声明一下。//-如果需要映射表名和列名请参照注解@Table、@Colum更多的属性@Table(mapUderscoreToCamelCase=true)publicclassTestUser{privateItegerid;privateStrigame;privateItegerage;privateDatecreateTime;//gettersadsettersomitted}//然后通过`queryForList`方法直接查询，控制台就可以得到相同的结果StrigsqlStrig="select*fromtest_user";List<TestUser>dtoList=jdbcTemplate.queryForList(sqlStrig,TestUser.class);PritUtils.pritObjectList(dtoList);单表CRUD对于单表CRUD操作可以使用JdbcTemplate的子类LambdaTemplate//创建数据源DataSourcedataSource=DsUtils.dsMySql();//创建LambdaTemplate对象和创建JdbcTemplate一样LambdaTemplatelambdaTemplate=ewLambdaTemplate(dataSource);//初始化一些数据lambdaTemplate.loadSQL("CreateDB.sql");//查询，所有数据List<TestUser>dtoList=lambdaTemplate.lambdaQuery(TestUser.class).queryForList();PritUtils.pritObjectList(dtoList);//插入新数据TestUserewUser=ewTestUser();ewUser.setName("ewUser");ewUser.setAge(33);ewUser.setCreateTime(ewDate());itresult=lambdaTemplate.lambdaIsert(TestUser.class).applyEtity(ewUser).executeSumResult();//更新，将ame从mali更新为malaTestUsersample=ewTestUser();sample.setName("mala");itresult=lambdaTemplate.lambdaUpdate(TestUser.class).eq(TestUser::getId,1).updateToBySample(sample).doUpdate();//删除，ID为2的数据itresult=lambdaTemplate.lambdaUpdate(TestUser.class).eq(TestUser::getId,1).updateToBySample(sample).doUpdate();使用DAO使用DAO可以继承BaseMapper通用DAO接口来完成一些基本操作，仍然以单表CRUD为例。
//DAO的一些接口需要识别ID属性，因此有必要在DTO对象上通过@Colum注解标记出它们@Table(mapUderscoreToCamelCase=true)publicclassTestUser{@Colum(primary=true)privateItegerid;privateStrigame;privateItegerage;privateDatecreateTime;//gettersadsettersomitted}//创建数据源DataSourcedataSource=DsUtils.dsMySql();//创建通用DAODalSessiosessio=ewDalSessio(dataSource);BaseMapper<TestUser>baseMapper=sessio.createBaseMapper(TestUser.class);//初始化一些数据baseMapper.template().loadSQL("CreateDB.sql");//查询数据List<TestUser>dtoList=baseMapper.query().queryForList();PritUtils.pritObjectList(dtoList);//插入新数据TestUserewUser=ewTestUser();ewUser.setName("ewUser");ewUser.setAge(33);ewUser.setCreateTime(ewDate());itresult=baseMapper.isert(ewUser);//更新，将ame从mali更新为malaTestUsersample=baseMapper.queryById(1);sample.setName("mala");itresult=baseMapper.updateById(sample);//删除，ID为2的数据itresult=baseMapper.deleteById(2);作为DAO可以定义自己的方法，并通过注解配置具体执行的SQL语句。
//BaseMapper是可选的，继承它相当于多了一组单表CURD的扩展功能。@SimpleMapperpubliciterfaceTestUserDAOextedsBaseMapper<TestUser>{@Isert("isertito`test_user`(ame,age,create_time)values(#{ame},#{age},ow())")publicitisertUser(@Param("ame")Strigame,@Param("age")itage);@Update("update`test_user`setage=#{age}whereid=#{id}")publicitupdateAge(@Param("id")ituserId,@Param("age")itewAge);@Delete("deletefrom`test_user`whereage>#{age}")publicitdeleteByAge(@Param("age")itage);@Query(value="select*from`test_user`where#{begiAge}<ageadage<#{edAge}",resultType=TestUser.class)publicList<TestUser>queryByAge(@Param("begiAge")itbegiAge,@Param("edAge")itedAge);}//创建DalRegistry并注册TestUserDAODalRegistrydalRegistry=ewDalRegistry();dalRegistry.loadMapper(TestUserDAO.class);//使用DalRegistry创建SessioDalSessiosessio=ewDalSessio(dataSource,dalRegistry);//创建DAO接口TestUserDAOuserDAO=sessio.createMapper(TestUserDAO.class);使用Mapper统一管理SQL的最佳场所仍然是Mapper文件，而且dbVisitor 的Mapper文件高度兼容MyBatis学习成本极低。
//利用@RefMapper注解将Mapper文件和接口类联系起来（继承BaseMapper是可选的）@RefMapper("/mapper/quick_dao3/TestUserMapper.xml")publiciterfaceTestUserDAOextedsBaseMapper<TestUser>{publicitisertUser(@Param("ame")Strigame,@Param("age")itage);publicitupdateAge(@Param("id")ituserId,@Param("age")itewAge);publicitdeleteByAge(@Param("age")itage);publicList<TestUser>queryByAge(@Param("begiAge")itbegiAge,@Param("edAge")itedAge);}为了更好了解和使用dbVisitor 的Mapper文件建议增加DTD加以验证。另外HasorDB兼容MyBatis3的DTD对于绝大部分MyBatis工程都可以正常兼容。
DOCTYPEmapperPUBLIC"-//dbvisitor.et//DTDMapper1.0//EN""https://www.dbvisitor.et/schema/dbvisitor-mapper.dtd"><mapperamespace="et.hasor.db.example.quick.dao3.TestUserDAO"><resultMapid="testuser_resultMap"type="et.hasor.db.example.quick.dao3.TestUser"><idcolum="id"property="id"/><resultcolum="ame"property="ame"/><resultcolum="age"property="age"/><resultcolum="create_time"property="createTime"/>resultMap><sqlid="testuser_colums">ame,age,create_timesql><isertid="isertUser">isertito`test_user`(<icluderefid="testuser_colums"/>)values(#{ame},#{age},ow())isert><updateid="updateAge">update`test_user`setage=#{age}whereid=#{id}update><deleteid="deleteByAge">deletefrom`test_user`whereage>#{age}]]>delete><selectid="queryByAge"resultMap="testuser_resultMap">selectid,<icluderefid="testuser_colums"/>from`test_user`where#{begiAge}<ageadage<#{edAge}select>mapper>快速条件拼接快速条件拼接包含快速'与'条件和快速'或'条件它们是两个规则用于取代简单的if标签和简单的foreach标签。如下语句，当参数不为空时候才拼接sql<selectid="queryUser">select*from`test_user`where1=1<iftest="age!=ull">adage=#{age}if>select>可以简化为快速规则写法，其中:age为属性名。<selectid="queryUser">select*from`test_user`@{ad,age=:age}select>例如如下foreach操作：<selectid="queryUser">select*from`test_user`whereidi<foreachitem="item"idex="idex"collectio="list"ope="("separator=","close=")">#{item}foreach>select>可以简化为快速规则写法，其中:list为集合属性名。<selectid="queryUser">select*from`test_user`@{ad,idi(:list)}select>如果多个简单条件，快速写法将会极大的减少Mapper的工作量。<select
评论