-
Notifications
You must be signed in to change notification settings - Fork 0
Java客户端 帮助类说明
这里主要介绍了一些开发过程中可能会用到的帮助类。大部分是针对Dla框架里面用到的接口的实现。位于package: com.ctrip.platform.dal.dao.helper。
Code Gen生成的代码会直接或间接的用到这里的部分类。还有一部分没用到的类在使用恰当的情况下可以满足特殊需求。
帮助类按照DalRowMapper实现类,DalParser实现类,ResultMerger实现类和其他帮助类来分别说明。
实现DalRowMapper接口,在遍历查询结果集的时候把每一行返回为一个Map。在希望快速验证查询结果,又不想通过code gen生成正式的Entity class的时候很有用。
与DalColumnMapRowMapper类似,唯一的不同是DalColumnMapRowMapper会自己找到所有列名,而这个类可以指定列名。两者用处也类似。对于不希望将返回的所有列都转化为Map里面的entry的时候可以选择。
提供一个静态方法将ResultSet里面指定的column转化为Integer类型。指定的cloumn可以为null,或者字符串,或者任意数字类型。对自定义DalRowMapper来处理定义的不规范的列时有用处。
返回结果集里面的第一个列的值。但如果希望返回short类型,必须使用ShortRowMapper,因为缺省的getObject针对short类型的列有可能返回Integer。
返回结果集中的short值的mapper
忽略结果集里面的实际内容,只返回给定值的mapper实现。
缺省的基于JPA的DalRowMapper实现,通过parse一个entity的注解来判断如何从结果集做ORM。
部分实现DalParser接口的抽象类,提供一般情况下不变的数据部分的访问。为进一步实现数据库ORM行为提供一个可扩展的基类。
扩展与AbstractDalParser,缺省的基于JPA的parser实现,通过parse一个entity的注解来判断如何从结果集做ORM。
从多个shard的结果集里面,排序后返回第一个。可以提供Comparator来决定排序方式。
返回多个shard结果集的并集,可以提供Comparator来决定排序方式。
返回多个shard结果集的并集的其中一段数据,可以提供Comparator来决定排序方式。
合并多个shard结果集,检查是否最终只有一个结果,如果不是则报错。
配合MultipleSqlBuilder使用的,合并每个shard上的批量查询结果。
使用DalRowCallback的DalResultSetExtractor实现。
使用DalRowMapper的DalResultSetExtractor实现。
实现scalar访问方式的DalResultSetExtractor实现。返回结果集第一行第一列的值。这是C#的一种访问方式,借鉴到Java里面。
返回结果集中第一行数据的DalResultSetExtractor实现。可以指定是否需要保证唯一性,如果指定唯一性,当结果集多于1行的时候会报错。
最关键的分库分表的帮助类。提供了分库分表所需要的帮助方法,被大量调用。
缺省的异步调用接口实现。提供了获取结果,查询状态和出错处理等等功能。
实现对符合JPA规范的Entity进行解析方面工作的帮助类。可以提供用来构造mapper和parser所需要的meta data
提供一些简单的帮助方法。没什么用,未来会简化或去掉。
配合web环境使用的servelet listener。支持数据库初始化和预热选项。集成文档里面有具体说明。
日志处理相关的帮助类。如果希望自己提供logger实现,可以考虑使用里面的相关方法来简化开发