【原】Spring与MongoDB集成：仓库

yxxs123

　　　　上一篇文章用介绍了如何配置spring-data-mongo连接到MongoDB上，如何创建MongoTemplate。MongoTemplate就相当于一个通用的仓库，可以持久化业务对象。
　　　　在spring-data-mongo 1.2.1.RELEASE版的手册中，有两个大章节介绍了和仓库相关的内容，可见其重要。
　　　　
　　　　
　　曾经有过一些疑问，整理一下：
　　1、 为什么要用Repository？
　　　　字面的翻译是“仓库”，就是对应的Bean的仓库，它应该提供了Bean对象的基础操作方法，比如save, delete等等。
　　2、Repository在哪里？
　　　　现在用的spring-data-mongodb 1.2.1.RELEASE版本，看手册用到了Repository接口，发现是在spring-data-common中定义的，还有相关的CurdRepository等都是这个包中定义的。为了开发时方便，最好把spring-data-common一块下载下来，API放在手边查。
　　3、怎么实现Repository？
　　　　org.springframework.data.mongodb.repository包，是有关仓库定义的。
　　　　org.springframework.data.mongodb.repository.support包，有两个与Repository实现直接相关的类：QueryDslMongoRepository, SimpleMongoRepository，根据自己的需要来使用。
　　　　spring-data-common中定义的Repository没有提供具体接口方法，只是要求实现时必须传入对象类型和对象标识的类型。在MongoDB中，对象的标识类型是ObjectId。
　　4、在什么地方实现对象的操作方法？
　　　　这个问题只是我个人的一点考虑，得根据自己的需求来思考。
　　　　最初的想法是在业务对象上直接实现操作方法，如save, delete，那么就需要业务Bean或它的基类去实现Repository相关的接口。这种方法比较方便，思想是对象知道如何“维护”自己，不需要在代码中引入专门的操作对象。缺点是，如果需要扩展对象的操作方法，就要修改Bean或其父类的具体实现。
　　　　如果使用专门的Repository对象，思想就是“由仓库来维护对象”。那么所有的操作要放到仓库对象中，而业务对象只有自己的业务方法和Bean(Getter/Setter)方法。这种方式会把业务对象与业务对象的操作分离开，比较清晰。
　　----------------------------------------------------------------------------------------
　　　　OK，下面在正式介绍如何开发仓库之前，先解释一个重要的东西：@Autowired。
　　　　这是Spring中的实现，其功能简单的说就是：用@Autowired声明的类成员，可以不实现Getter/Setter方法，由Spring自动实现Getter/Setter的功能。spring-data-mongo对类仓库成员的自动注入就是基于此实现的。
　　----------------------------------------------------------------------------------------
　　　　下面来详细说下如何实现。我在实现之前查了网上的文章，多数把代码和配置列出来，但没有说详细的说明，以致于自己又拿着手册，试了多次才成功。在做的过程中碰到些问题，也经历了些思考，写出来供大家参考。
　　　　实现的过程分下面4步：
　　　　1、 定义业务对象的Repository接口（方法）；
　　　　2、 实现业务对象的接口，默认后缀名是Impl；
　　　　3、 定义业务对象，使用Repository（这一步是自动绑定的，但如何自动绑定，绑定到什么程度，让我花了不少时间）
　　　　4、 修改POM.xml配置
　　
　　下面来具体说说：
　　1、 定义Repository接口
　　　　接口可以直接扩展Repository，这个接口的目的是确定业务对象类型和业务对象标识的类型。
　　　　也可以扩展MongoRepository接口，定义如下：
　　　　
　　　　使用这两个接口区别是：
　　　　* Repository，直接声明自己的仓库接口，无须管其它。使用的时候，对象的一般存取直接使用MongoTemplate，而专门的方法才使用仓库中的方法；
　　　　* MongoRepository，声明了几乎所有常用的方法（由CurdRepository, PagingAndSOringRepository和Repository提供的），你的仓库也要实现这些方法。
　　2、 实现业务对象的Repository接口
　　　　有了接口定义就要实现它。
　　　　如果定义的接口只是扩展了Repository，那么只需实现自定义的业务方法。
　　　　如果定义的接口扩展了MongoRepository，就要实现所有相关的基础方法。这里要注意，之所以使用Repository，就是避免编写大量相似的模板代码，如果自己实现这些方法就失去使用Repository的意义了。
　　　　spring-data-mongo在在org.springframework.data.mongodb.repository.
　　support包中提供了SimpleMongoRepository和QueryDslMongoRepository类，专门用来实现这些基础方法。

　　　　所以，你的业务仓库类应该是SimpleMongoRepository的子类。
　　　　到这里要说仓库的另一种用法，就像前面讲到的，把所有的操作方法都放到业务类上。一般来说，业务类都派生自一个自定义的抽象父类，那么就要求这个父类是SimpleMongoRepository的子类，实现MongoRepository接口。
　　　　使用的时候，代码有下面两种方式：
　　　　customObject.save();
　　　　或
　　　　customObjectRepository.save( customObject );
　　3、 定义业务组件
　　　　这里说的业务组件是广泛意义的业务组件，指需要使用Repository的类。



public class CustomObjectClient {
@Autowired
public CustomRepository customRepository;
public String getObjectName() {
return customRepository.findByName( "XXX" );
}
}
　　　　把仓库类型的成员用@Autowired标识，由Spring来完成Getter/Setter的功能。那么这个值如何赋上的呢？来看第4步。
　　4、 修改POM.xml配置
　　　　1) 要先映射仓库的Bean：




　　　　仓库实现要求有默认构造方法。
　　　　2) 定义组件Bean：




　　　　3) 指定Mongo仓库的目录：
　　　　组件bean中用@Autowired标识的成员类型与上面的仓库Bean的名称对应





　　　　spring-data-mongo按上面的路径扫描，把找到的仓库注入到业务组件中。
　　　　然后，然后就是编写你的业务代码了~~~