Spring Data JDBC通用DAO实现–迄今为止最轻量的ORM

我很高兴宣布Spring Data JDBC存储库项目的第一个版本。 这个开放源代码库的目的是为基于Spring框架中 JdbcTemplate关系数据库提供通用,轻量且易于使用的DAO实现,与项目的Spring Data 框架兼容。

设计目标

  • 轻巧,快速且开销低。 只有少数几个类, 没有XML,注释,反射
  • 这不是成熟的ORM 。 没有关系处理,延迟加载,脏检查,缓存
  • 在几秒钟内实现CRUD
  • 对于JPA过大的小型应用程序
  • 在需要简单性或考虑将来迁移到JPA时使用
  • 对数据库方言差异的最小化支持(例如,透明的结果分页)

特征

每个DAO为以下内容提供内置支持:

  • 通过RowMapper抽象到域对象/从域对象映射
  • 生成的和用户定义的主键
  • 提取生成的密钥
  • 复合(多列)主键
  • 不变的领域对象
  • 分页(请求结果子集)
  • 按几列排序(与数据库无关)
  • 多对一关系的可选支持
  • 支持的数据库(连续测试):
    • 的MySQL
  • 通过SqlGenerator类可以轻松扩展到其他数据库方言。
  • 通过ID轻松检索记录

API

与Spring Data PagingAndSortingRepository抽象兼容, 所有这些方法都为您实现

public interface PagingAndSortingRepository<T, ID extends Serializable> extends CrudRepository<T, ID> {T  save(T entity);Iterable<T> save(Iterable<? extends T> entities);T  findOne(ID id);boolean exists(ID id);Iterable<T> findAll();long count();void delete(ID id);void delete(T entity);void delete(Iterable<? extends T> entities);void deleteAll();Iterable<T> findAll(Sort sort);Page<T> findAll(Pageable pageable);
}

还完全支持PageableSort参数,这意味着您可以通过任意属性免费获得分页和排序 。 例如,假设您有userRepository扩展了PagingAndSortingRepository<User, String>接口(由库为您实现),并且在应用某种排序后,您请求了USERS表的第5页,每页10个:

Page<User> page = userRepository.findAll(new PageRequest(5, 10,new Sort(new Order(DESC, "reputation"),new Order(ASC, "user_name")))
);

Spring Data JDBC存储库库会将此调用转换为(PostgreSQL语法):

SELECT *
FROM USERS
ORDER BY reputation DESC, user_name ASC
LIMIT 50 OFFSET 10

…甚至(Derby语法):

SELECT * FROM (SELECT ROW_NUMBER() OVER () AS ROW_NUM, t.*FROM (SELECT *FROM USERSORDER BY reputation DESC, user_name ASC) AS t) AS a
WHERE ROW_NUM BETWEEN 51 AND 60

无论使用哪个数据库,都将获得Page<User>对象作为回报(您仍然必须自己提供RowMapper<User>才能将其从ResultSet转换为域对象。如果您还不了解Spring Data项目,则Page<T>是一个很棒的抽象,不仅封装了List<User> ,而且还提供了元数据,例如记录总数,我们当前所在的页面等。

使用理由

  • 由于将来您的代码将仅依赖于Spring Data Commons伞项目中的PagingAndSortingRepositoryCrudRepository定义的方法, PagingAndSortingRepository您可以自由地从JdbcRepository实现(从该项目)切换到: JpaRepositoryMongoRepositoryGemfireRepositoryGraphRepository 。 它们都实现相同的通用API。 当然,不要指望从JDBC切换到JPA或MongoDB就像切换导入的JAR依赖项一样简单-但是至少您可以通过使用相同的DAO API最小化影响。
  • 您需要一个快速,简单的JDBC包装器库。 JPA甚至MyBatis都不过分
  • 如果需要,您想完全控制生成的SQL
  • 您想使用对象,但是不需要延迟加载,关系处理,多级缓存,脏检查……您需要CRUD等等
  • 您想干吗
  • 您已经在使用Spring甚至JdbcTemplate ,但仍然觉得手工工作过多
  • 您的数据库表很少

入门

有关更多示例和工作代码,请不要忘记检查项目测试 。

先决条件

Maven坐标:

<dependency><groupId>com.blogspot.nurkiewicz</groupId><artifactId>jdbcrepository</artifactId><version>0.1</version>
</dependency>

不幸的是,该项目尚未在Maven中央存储库中 。 目前,您可以通过克隆将库安装在本地存储库中:

$ git clone git://github.com/nurkiewicz/spring-data-jdbc-repository.git
$ git checkout 0.1
$ mvn javadoc:jar source:jar install

为了启动您的项目,必须存在DataSource bean并启用事务管理。 这是最小的MySQL配置:

@EnableTransactionManagement
@Configuration
public class MinimalConfig {@Beanpublic PlatformTransactionManager transactionManager() {return new DataSourceTransactionManager(dataSource());}@Beanpublic DataSource dataSource() {MysqlConnectionPoolDataSource ds = new MysqlConnectionPoolDataSource();ds.setUser("user");ds.setPassword("secret");ds.setDatabaseName("db_name");return ds;}}

具有自动生成的密钥的实体

假设您有一个具有自动生成的密钥(MySQL语法)的数据库表:

CREATE TABLE COMMENTS (id INT AUTO_INCREMENT,user_name varchar(256),contents varchar(1000),created_time TIMESTAMP NOT NULL,PRIMARY KEY (id)
);

首先,您需要创建到该表的域对象User映射(就像在任何其他ORM中一样):

public class Comment implements Persistable<Integer> {private Integer id;private String userName;private String contents;private Date createdTime;@Overridepublic Integer getId() {return id;}@Overridepublic boolean isNew() {return id == null;}//getters/setters/constructors/...
}

除了标准的Java样板之外,您还应该注意实现Persistable<Integer> ,其中Integer是主键的类型。 Persistable<T>是一个来自Spring Data项目的接口,这是我们对您的域对象的唯一要求。

最后,我们准备创建CommentRepository DAO:

@Repository
public class CommentRepository extends JdbcRepository<Comment, Integer> {public CommentRepository() {super(ROW_MAPPER, ROW_UNMAPPER, "COMMENTS");}public static final RowMapper<Comment> ROW_MAPPER = //see belowprivate static final RowUnmapper<Comment> ROW_UNMAPPER = //see below@Overrideprotected Comment postCreate(Comment entity, Number generatedId) {entity.setId(generatedId.intValue());return entity;}
}

首先,我们使用@Repository批注标记DAO bean。 它启用持久性异常转换。 通过CLASSPATH扫描也可以发现此类带注释的bean。

如您所见,我们扩展了JdbcRepository<Comment, Integer> ,它是该库的中心类,提供了所有PagingAndSortingRepository方法的实现。 它的构造函数具有三个必需的依赖项: RowMapperRowUnmapper和表名。 您也可以提供ID列名,否则使用默认的"id"

如果您曾经使用过Spring的JdbcTemplate ,则应该熟悉RowMapper界面。 我们需要以某种方式将ResultSet列提取到一个对象中。 毕竟,我们不想使用原始的JDBC结果。 这很简单:

public static final RowMapper<Comment> ROW_MAPPER = new RowMapper<Comment>() {@Overridepublic Comment mapRow(ResultSet rs, int rowNum) throws SQLException {return new Comment(rs.getInt("id"),rs.getString("user_name"),rs.getString("contents"),rs.getTimestamp("created_time"));}
};

RowUnmapper来自此库,它本质上与RowMapper相反:接收一个对象并将其转换为Map 。 库稍后使用此映射来构造SQL CREATE / UPDATE查询:

private static final RowUnmapper<Comment> ROW_UNMAPPER = new RowUnmapper<Comment>() {@Overridepublic Map<String, Object> mapColumns(Comment comment) {Map<String, Object> mapping = new LinkedHashMap<String, Object>();mapping.put("id", comment.getId());mapping.put("user_name", comment.getUserName());mapping.put("contents", comment.getContents());mapping.put("created_time", new java.sql.Timestamp(comment.getCreatedTime().getTime()));return mapping;}
};

如果您从不更新数据库表(仅读取插入在其他位置的一些参考数据),则可以跳过RowUnmapper参数或使用MissingRowUnmapper

最后一个难题是postCreate()回调方法,该方法在插入对象后调用。 您可以使用它来检索生成的主键并更新域对象(如果域对象是不可变的,则返回新的主键)。 如果不需要它,就不要重写postCreate() 。 根据此示例,检查JdbcRepositoryGeneratedKeyTest以获取有效的代码。

到目前为止,您可能会觉得与JPA或Hibernate相比,有很多手工工作。 但是,众所周知,各种JPA实现和其他ORM框架都会引入大量开销并显示一些学习曲线。 这个微小的库有意让用户承担一些责任,以避免复杂的映射,反射,注释……并非总是需要的所有隐式性。 该项目无意替代成熟稳定的ORM框架。 相反,它试图填补原始JDBC和ORM之间的利基,其中简单性和低开销是关键特征。

具有手动分配的密钥的实体

在此示例中,我们将看到如何处理具有用户定义的主键的实体。 让我们从数据库模型开始:

CREATE TABLE USERS (user_name varchar(255),date_of_birth TIMESTAMP NOT NULL,enabled BIT(1) NOT NULL,PRIMARY KEY (user_name)
);

…和User域模型:

public class User implements Persistable<String> {private transient boolean persisted;private String userName;private Date dateOfBirth;private boolean enabled;@Overridepublic String getId() {return userName;}@Overridepublic boolean isNew() {return !persisted;}public User withPersisted(boolean persisted) {this.persisted = persisted;return this;}//getters/setters/constructors/...}

注意,添加了特殊的persisted瞬态标志。 来自Spring Data项目的CrudRepository.save()合同要求一个实体知道它是否已经保存( isNew() )方法–没有单独的create()update()方法。 对于自动生成的键(参见上面的Comment ),实现isNew()很简单,但是在这种情况下,我们需要一个额外的瞬态字段。 如果您讨厌这种解决方法,并且只插入数据而从不更新,则始终可以从isNew()返回true

最后是我们的DAO, UserRepository bean:

@Repository
public class UserRepository extends JdbcRepository<User, String> {public UserRepository() {super(ROW_MAPPER, ROW_UNMAPPER, "USERS", "user_name");}public static final RowMapper<User> ROW_MAPPER = //...public static final RowUnmapper<User> ROW_UNMAPPER = //...@Overrideprotected User postUpdate(User entity) {return entity.withPersisted(true);}@Overrideprotected User postCreate(User entity, Number generatedId) {return entity.withPersisted(true);}
}

"USERS""user_name"参数指定表名称和主键列名称。 我将保留mapper和unmapper的详细信息(请参阅源代码 )。 但是请注意postUpdate()postCreate()方法。 它们确保一旦对象被持久保存,就设置了persisted标志,以便随后对save()调用将更新现有实体,而不是尝试重新插入它。

根据此示例,检查JdbcRepositoryManualKeyTest以获得有效的代码。

复合主键

我们还支持复合主键(由几列组成的主键)。 以该表为例:

CREATE TABLE BOARDING_PASS (flight_no VARCHAR(8) NOT NULL,seq_no INT NOT NULL,passenger VARCHAR(1000),seat CHAR(3),PRIMARY KEY (flight_no, seq_no)
);

我希望您注意到Peristable<T>的主键类型:

public class BoardingPass implements Persistable<Object[]> {private transient boolean persisted;private String flightNo;private int seqNo;private String passenger;private String seat;@Overridepublic Object[] getId() {return pk(flightNo, seqNo);}@Overridepublic boolean isNew() {return !persisted;}//getters/setters/constructors/...}

不幸的是,我们不支持将所有ID值封装在一个对象中的小数值类(就像JPA使用@IdClass ),因此您必须使用Object[]数组。 定义DAO类类似于我们已经看到的内容:

public class BoardingPassRepository extends JdbcRepository<BoardingPass, Object[]> {public BoardingPassRepository() {this("BOARDING_PASS");}public BoardingPassRepository(String tableName) {super(MAPPER, UNMAPPER, new TableDescription(tableName, null, "flight_no", "seq_no"));}public static final RowMapper<BoardingPass> ROW_MAPPER = //...public static final RowUnmapper<BoardingPass> UNMAPPER = //...}

需要注意的两件事:我们扩展了JdbcRepository<BoardingPass, Object[]>并且按预期提供了两个ID列名称: "flight_no", "seq_no" 。 我们通过提供由Object[]包裹的flight_noseq_no (必须seq_no顺序)值来查询此类DAO:

BoardingPass pass = repository.findOne(new Object[] {"FOO-1022", 42});

毫无疑问,这在实践中很麻烦,因此我们提供了微小的辅助方法,您可以静态导入:

import static com.blogspot.nurkiewicz.jdbcrepository.JdbcRepository.pk;
//...BoardingPass foundFlight = repository.findOne(pk("FOO-1022", 42));

根据此示例,检查JdbcRepositoryCompoundPkTest以获取工作代码。

交易次数

该库与事务管理完全正交。 每个存储库的每种方法都需要运行事务,具体取决于您进行设置。 通常,您将@Transactional放在服务层上(称为DAO bean)。 我不建议将@Transactional放在每个DAO bean上 。

快取

Spring Data JDBC存储库库不提供任何缓存抽象或支持。 但是, 在Spring中使用缓存抽象将@Cacheable层添加@Cacheable DAO或服务之上非常简单。 另请参见: Spring中的@Cacheable开销

会费

..总是欢迎。 不要犹豫, 提交错误报告并提出请求 。 现在最大的缺失功能是对MSSQL和Oracle数据库的支持。 如果有人可以看一下,那就太好了。

测试中

该库已使用Travis( 建立状态 )。 测试套件包括265个测试 (53个不同的测试,每个测试针对5个不同的数据库运行:MySQL,PostgreSQL,H2,HSQLDB和Derby。

在填写错误报告或提交新功能时,请尝试包括支持测试用例。 每个拉取请求都会在单独的分支上自动进行测试。

建造

分叉后, 正式的存储库构建就像运行一样简单:

$ mvn install

您将在JUnit测试执行过程中注意到大量异常。 这个是正常的。 一些测试是针对仅在Travis CI服务器上可用的MySQL和PostgreSQL运行的。 当这些数据库服务器不可用时,只需跳过整个测试:
结果:

Tests run: 265, Failures: 0, Errors: 0, Skipped: 106

异常堆栈跟踪来自根AbstractIntegrationTest

设计

库仅包含少数几个类,如下图所示:

UML图

JdbcRepository是实现所有PagingAndSortingRepository方法的最重要的类。 每个用户存储库都必须扩展此类。 同样,每个这样的存储库必须至少实现RowMapperRowUnmapper (仅当您要修改表数据时)。

SQL生成委托给SqlGeneratorPostgreSqlGenerator.DerbySqlGenerator用于与标准生成器不DerbySqlGenerator的数据库。

执照

该项目是在Apache许可的 2.0版下发布的 (与Spring框架相同)。

参考: NoBlogDefFound博客中JCG合作伙伴 Tomasz Nurkiewicz 为程序员提供的概率分布 。

翻译自: https://www.javacodegeeks.com/2013/01/spring-data-jdbc-generic-dao-implementation-most-lightweight-orm-ever.html

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/369922.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

【Spark】SparkStreaming-加载外部配置文件

SparkStreaming-加载外部配置文件 spark加载配置文件_百度搜索Spark加载外部配置文件 - CSDN博客spark读取配置文件中的配置 - CSDN博客spark加载properties配置文件方法 - u013013024的博客 - CSDN博客Spark 官方文档&#xff08;4&#xff09;——Configuration配置 - bigbi…

对计算机财务管理的理解,计算机财务管理

计算机财务管理1、引用(P4-P5)&#xff1b;易出名词解释、选择题。应识记、理解。答&#xff1a;(1)相对引用(2)绝对引用(3)混合引用2、IF、SUM、VLOOKUP、DGET函数的使用方法(P22、P28、P30、P31) 识记、理解用途&#xff0c;能应用。答&#xff1a;IF函数用逻辑表达式来判断指…

卡盟主站搭建_搭建卡盟主站下载|搭建卡盟主站教程 (附带源码)百度云_ - 极光下载站...

最近&#xff0c;很多小伙伴们都在想搭建一个卡盟的主站&#xff0c;但是鉴于很多人都不太懂编程&#xff0c;也不知道如何找到源码。所以现在小编就为大家带来搭建卡盟主站教程&#xff0c;而且还把源码也一起送来了&#xff0c;想要搭建卡盟主站的话就记得一定要下载哦&#…

【期望DP】

【总览】 【期望dp】 求解达到某一目标的期望花费&#xff1a;因为最终的花费无从知晓&#xff08;不可能从$\infty$推起&#xff09;&#xff0c;所以期望dp需要倒序求解。 设$f[i][j]$表示在$(i, j)$这个状态实现目标的期望值&#xff08;相当于是差距是多少&#xff09;。 首…

复习HTML CSS(2)

n 项目符号嵌套编号思路 标签的内容&#xff08;文本、项目符号、表格、图片等&#xff09;必须放在最底层标记中。 n 图片标记&#xff08;行内元素&#xff0c;单边标记&#xff09; l 语法&#xff1a;<img 属性 “值”> l 常用属性 Width&#xff1a;图片宽…

Spring MVC:使用基于Java的配置创建一个简单的Controller

这是我博客上与Spring MVC相关的第一篇文章。 开端总是令人兴奋的&#xff0c;因此我将尽量简洁明了。 Spring MVC允许以最方便&#xff0c;直接和快速的方式创建Web应用程序。 开始使用这项技术意味着需要Spring CORE的知识。 在文章中&#xff0c;您将了解有关创建简单的Spri…

中鸣循迹机器人_自动循迹机器人控制系统的设计

马家庆,于兆勤,刘建群,黄惠敬,陈炜楠摘要&#xff1a;循迹机器人是智能机器人领域内非常重要且被广泛研究的一种智能移动装置&#xff0c;国内许多重要的比赛都以循迹机器人为核心进行开展的。本文设计的智能循迹避障机器人的控制系统主要由四个模块组成&#xff1a;最小系统模…

2、创建分类器笔记

创建分类器 简介&#xff1a;分类是指利用数据的特性将其分类成若干类型的过程。分类与回归不同&#xff0c;回归的输出是实数。监督学习分类器就是用带标记的训练数 据建立一个模型&#xff0c;然后对未知的数据进行分类。分类器可以实现分类功能的任意算法&#xff0c;最简单…

天刀现在最新服务器,天涯明月刀8.21服务器更新公告

原标题&#xff1a;天涯明月刀8.21服务器更新公告青龙乱舞区、大地飞鹰区、天命风流区、沧海云帆区、边城浪子区全部服务器将在8月21日6:00~12:00停机维护更新&#xff0c;维护完成后上述各服务器客户端版本更新至2.0.95.5。本次维护主要调整和修改内容如下&#xff0c;给您带来…

复习上学期的HTML CSS(1)

自己跟着网上教程复习上学期的HTML CSS&#xff0c;因为已经忘得差不多了&#xff0c;而且现在学的js也要以HTML CSS为基础&#xff0c;坚持每天持续更新。 n B/S 网络结构 Browser/Server 浏览器/服务器&#xff0c;这是现在最流行的网络模式。如新浪网、凤凰网等。 C/S Clie…

XAML或JavaFx?

这是使用XAML和JavaFx构建应用程序的快速&#xff0c;主观&#xff0c; 无权且非常不科学的比较。 比较是基于我与每个人合作的个人经验。 在XAML方面&#xff0c;这意味着WPF和Win8存储应用程序 。 在JavaFx方面&#xff0c;这意味着Windows 7应用程序。 JavaFX JavaFx被Orac…

java面试2

1、list中去重&#xff08;无序&#xff0c;有序&#xff09; 2、list中记录每个出现次数&#xff0c;并去重 public static void main(String[] args) { List<String> li2 new ArrayList<String>(); li2.add("11"); l…

mongodb修改数据语句_MongoDB 之 手把手教你增删改查 MongoDB - 2

如果没看到我的金玉良言的话,就重新打开一次客户端和服务端吧本章我们来学习一下关于 MongoDB的增删改查一.MongoDB操作 之 原生ORM,根本不存在SQL语句创建数据库:这里和一般的关系型数据库一样,都要先建立一个自己的数据库空间嗯嗯嗯嗯,我感受到了你内心的惊呼,瞅瞅你们这些没…

星战前夜服务器维护时间,EVE星战前夜开测时间在什么时候 什么时候测试

EVE星战前夜什么时候开测&#xff0c;EVE星战前夜的测试时间在什么时候&#xff0c;想要知道EVE星战前夜测试时间的小伙伴一起来看看EVE星战前夜的相关资讯&#xff0c;了解一下游戏的开测时间吧。EVE星战前夜目前仍在开发阶段&#xff0c;目前没有进行大范围的测试&#xff0c…

使用Maven Failsafe和TestNG分别运行单元测试和集成测试

最近&#xff0c;对于我的新宠物项目&#xff0c;我决定我希望在标准mvn测试期间执行一些测试&#xff0c;而仅在不同阶段执行一些其他测试 &#xff0c;我们称其为集成阶段。 我在谷歌上搜索&#xff0c;似乎没有任何工作&#xff0c;因此在努力使安装工作顺利进行之后&#x…

3、预测模型笔记

预测模型 1、简介 预测建模&#xff08;Predictive modeling&#xff09;是一种用来预测系统未来行为的分析技术&#xff0c;它由一群能够识别独立输入变量与反馈目标关联关系的算法构成。根据观测值创建一个数学模型&#xff0c;然后用这个模型去预测未来发生的事情。 预测模型…

lintcode-138-子数组之和

138-子数组之和 给定一个整数数组&#xff0c;找到和为零的子数组。你的代码应该返回满足要求的子数组的起始位置和结束位置 注意事项 There is at least one subarray that its sum equals to zero. 样例 给出 [-3, 1, 2, -3, 4]&#xff0c;返回[0, 2] 或者 [1, 3]. 标签 子数…

自己做的HTML

<html> <body background"http://img1.imgtn.bdimg.com/it/u821335874,2927998559&fm27&gp0.jpg"><h1 style"text-align:center">网站集中地</h1><p><a href"/html/html_links.asp">点击“本页”&…

常见问题_智能切膜机常见问题

hoco.智能切膜机&#xff0c;如果使用了错误方式&#xff0c;会导致操作失误&#xff0c;整理4个常见问题&#xff0c;还有错误示范&#xff0c;请跟随视频去了解&#xff0c;你使用正确了吗?1. 膜切反这个需要留意切割膜的正反&#xff0c;有文字面就是正面&#xff0c;无文字…

金融项目app服务器配置,云在金融的应用

银行传统IT架构&#xff0c;难以适应金融市场的业务变化快、服务差异化、多样化的业务需求。除此以外&#xff0c;银行传统IT架构还面临高成本、效率低等一系列问题&#xff1a;• 海量设备缺乏统一标准&#xff1a;规模大的银行计算节点规模以万计&#xff0c;存储设备数百套&…