<转>Spring Data —— 完全统一的API？

SpringData统一API探索

最新推荐文章于 2025-06-04 20:00:00 发布

原创最新推荐文章于 2025-06-04 20:00:00 发布 · 260 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#spring-data

spring 专栏收录该内容

1 篇文章

订阅专栏

SpringData旨在提供统一且简化的API来访问各种类型的持久化存储，包括关系型数据库和NoSQL存储。它通过数据访问对象、对象数据映射和模板等组件支持多种持久化层，如JPA、MongoDB和Neo4j。

Spring Data —— 完全统一的API？

作者 Tobias Trelle ，译者 周亦华 发布于九月 05, 2012

来源：http://www.infoq.com/cn/articles/spring-data-intro

Spring Data 作为SpringSource的其中一个父项目，旨在统一和简化对各类型持久化存储，而不拘泥于是关系型数据库还是NoSQL 数据存储。

无论是哪种持久化存储，数据访问对象（或称作为DAO，即Data Access Objects）通常都会提供对单一域对象的CRUD （创建、读取、更新、删除）操作、查询方法、排序和分页方法等。Spring Data则提供了基于这些层面的统一接口（CrudRepository，PagingAndSortingRepository）以及对持久化存储的实现。

JavaOne 2013再次回归，7月22-25日上海世博中心，精彩继续，5月31日前购票享半价

共创Java未来：JavaOne重回上海，现报名启动，关注Java EE 7、Java SE 8与Java Card

模板

Spring Data 模板的主要目的，同时也是所有其他Spring 模板的目的，就是资源分配和异常处理。

这里所说的资源就是数据存储资源，通常来说会通过远程TCP/IP连接访问。下面的实例展示了如果配置MongoDB的模板：

<!-- Connection to MongoDB server -->
<mongo:db-factory host="localhost" port="27017" dbname="test" /> 

<!-- MongoDB Template -->
<bean id="mongoTemplate"
class="org.springframework.data.mongodb.core.MongoTemplate">
  <constructor-arg name="mongoDbFactory" ref="mongoDbFactory"/> 
</bean>

首先我们需要定义连接工厂，MongoTemplate会引用这个连接工厂。这个例子中， Spring Data采用了较底层的数据库驱动，MongoDB Java driver。

一般来说，这类较底层的数据库驱动会有自己的一套异常处理策略。 Spring的异常处理采用的是未检查异常（unchecked exception），因此开发人员可以自己决定是否须要捕获异常。MongoDB的模板的实现方式是把捕获到的底层的异常封装成未检查异常，这些异常都是Spring里DataAccessException的子类。

模板提供了基于数据存储的操作，诸如保存、更新、删除单一记录或执行查询的方法。但所有这些方法只能用于相应的底层数据存储。

由于JPA的实现本身已经是位于JDBC API上层的抽象层，Spring Data JPA 并没有提供模板。和模板概念相对应的是JPA的EntityManager，而异常处理则是由数据访问对象来负责的。

对象、数据映射

JPA引入了O/R映射的标准（如关系型数据库中表和对象的映射）。Hibernate很有可能是被最为广泛使用的JPA标准的实现。

Spring Data采用类对象的方式将O/R映射的支持延伸到了NoSQL数据库。但在各种NoSQL数据库中，数据结构差异较大，所以很难形成一种通用的API。每一种数据存储都有各自一套注释用以标注映射所需要的元信息。下面我们来看一个简单的例子，如何映射一个简单领域对象：

JPA	MongoDB	Neo4j
@Entity @Table(name="TUSR") public class User { @Id private String id; @Column(name="fn") private String name; private Date lastLogin; ... }	@Document(collection="usr") public class User { @Id private String id; @Field("fn") private String name; private Date lastLogin; .. }	@NodeEntity public class User { @GraphId Long id; private String name; private Date lastLogin; ... }

如果你已经熟悉JPA实体，不难看出这里用了标准的JPA注释。Spring Data复用了这些标准的注释，而且没有引入其他新的内容。对象的映射正是由这些JPA的实现完成的。 MangoDB和Neo4j各种需要一套类似的注释。在上面的例子中，我们使用了类级别的注释collection和nodetype. MangoDB中， collection就相当于关系型数据库的表，而node和edge则是图形数据库（如Neo4j）的主要数据类型。

每个JPA实体都需要有唯一标识符，即便是MongoDB的文档和Neo4j的节点也是如此。

MongoDB使用@Id这个注释作为唯一标识符（这@Id是在org.springframework.data.annotation包中，和JPA的@Id并不相同）。Neo4j则使用了@GraphId这个注释。这些属性的值是在域对象成功存储后被设置的。当类属性的名称和MongoDB的文档中的属性名称不同时，可以使用@Field注释标注。

同样这两种映射也支持对其他对象的引用，请看下面的例子：

JPA	MongoDB	Neo4j
@OneToMany private List<Role> roles;	private List<Role> roles;	@RelatedTo( type = "has", direction = Direction.OUTGOING) private List<Role> roles;

在JPA中，我们使用@OneToMany来标识一对多的关系，通常多的一端的数据存放在子表中，通过联合查询获得。MongoDB并不支持文档间的联合查询，默认情况下，被引用的对象和主对象存储在同一个文档中。当然，我们也可以通过客户端的虚拟联合查询引用其他文档的数据。在Neo4j中，关系被称作edges，而edge也是一个基本的数据类型。

总结来说， MongoDB和Neo4j所使用的对象映射和我们大家所熟悉的JPA O/R映射非常类似，但由于不同的数据结构，两者存在着显著的区别。但不管怎么说，基本概念都是实现对象和数据结构的映射。

数据访问对象

你一定写过这样的DAO对象，针对单一记录的CRUD操作、针对多记录的CRUD操作，基于各种查询条件的查询方法。

随着JPA的引入，虽然EntityManager接口已经包含了CRUD操作，但编写查询方法仍然是一件麻烦事，为此，完成一次查询需要创建命名查询，设置参数，执行查询。请看下面的例子：

@Entity
@NamedQuery( name="myQuery", query = "SELECT u FROM User u where u.name = :name" )
public class User { 
...
} 

@Repository 
public class ClassicUserRepository { 

   @PersistenceContext EntityManager em; 

   public List<User> findByName(String Name) { 
      TypedQuery<User> q = getEntityManger().createNamedQuery("myQuery", User.class); 

      q.setParameter("name", fullName);

      return q.getResultList();
   } 
   ...

TypedQuery可以略微简化这个过程，如：

@Repository
public class ClassicUserRepository { 

   @PersistenceContext EntityManager em; 

   public List<User> findByName(String name) {
      return getEntityManger().createNamedQuery("myQuery", User.class)
         .setParameter("name", fullName)
         .getResultList(); 
   } 
   ...

我们仍然须要编写类似这样的查询方法，为查询赋值，执行查询。如果可以引入Spring Data JPA，要实现这类的查询，编码就可以大大简化，如下:

package repositories; 

public interface UserRepository extends JpaRepository<User, String> {

   List<User> findByName(String name); 
}

在Spring Data JPA中，我们将不再需要在JPA实体类中定义@NamedQuerys，来实现JPQL的查询。相反，我们可以为数据访问对象的各方法加上@Query这样的注释。如：

@Transactional(timeout = 2, propagation = Propagation.REQUIRED)
@Query("SELECT u FROM User u WHERE u.name = 'User 3'")
List<User> findByGivenQuery();

Spring Data MongoDB和Spring Data Neo4j可以使上述方法同样适用于MangoDB和Neo4j数据库。下面的例子的是通过Cipher查询语言来实现对Neo4j数据库的查询。

public interface UserRepository extends GraphRepository<User> {

  User findByLogin(String login); 

  @Query("START root=node:User(login = 'root') MATCH root-[:knows]->friends RETURN friends")
  List<User> findFriendsOfRoot(); 
}

当然，各个持久化层的方的命名规则稍有差异。比如说， MongoDB支持一种叫geospatial queries的查询语言，通常我们可以这样写查询：

public interface LocationRepository extends MongoRepository<Location, String> {

        List<Location> findByPositionWithin(Circle c);

        List<Location> findByPositionWithin(Box b);

        List<Location> findByPositionNear(Point p, Distance d);
}

Spring Data也提供对分页和排序的通用方法，这需要在查询方法中加入特殊的参数。

支持数据访问对象的优势在于：