MyBatis-Spring允许你在Service Bean中注入映射器。当使用映射器时,就像调用DAO那样来调用映射器就可以了,但是此时你就不需要进行任何DAO实现的编码,因为MyBatis会为你进行。
使用注入的映射器,你的代码就不会出现任何MyBatis-Spring依赖和MyBatis依赖。在我们的应用中有这样一个简单的映射器。你也应该知道映射器仅仅是一个接口:
1
2
3
|
public interface UserMapper { User getUser(String userId); } |
这是你使用MyBatis-Spring来创建映射器的方式:
1
2
3
4
|
< bean id = "userMapper" class = "org.mybatis.spring.mapper.MapperFactoryBean" > < property name = "sqlSessionFactory" ref = "sqlSessionFactory" /> < property name = "mapperInterface" value = "sample.UserMapper" /> </ bean > |
现在你的映射器已经准备在Service对象中注入了:
1
2
3
|
< bean id = "fooService" class = "sample.FooServiceImpl" > < property name = "userMapper" ref = "userMapper" /> </ bean > |
注:映射器接口全类名与映射器xml配置文件的namespace是对应的。
关于MapperFactoryBean
MapperFactoryBean创建的代理类实现了映射器接口(如上例:UserMapper),并且注入到应用程序中。因为代理创建在运行环境中,那么指定的映射器必须是一个接口。而不是一个具体的实现类。
没有必要在Spring的XML配置文件中注册所有的映射器。相反,你可以使用一个MapperScannerConfigurer,它将会查找类路径下的映射器并自动将它们创建成MapperFactoryBeans。要创建MapperScannerConfigurer,可以在Spring的配置中添加如下代码:
1
2
3
|
< bean class = "org.mybatis.spring.mapper.MapperScannerConfigurer" > < propery name = "basePackage" value = "org.mybatis.spring.sample.mapper" /> </ bean > |
basePackage属性是让你为映射器接口文件设置基本的包路径。你可以使用分号或逗号作为分隔符设置多于一个的包路径。每个映射器将会在指定的包路径中递归地被搜索到。
注意,没有必要去指定SqlSessionFactory或SqlSessionTemplate,因为MapperScannerConfigurer将会创建MapperFactoryBean,之后自动装配。但是,如果你使用了一个以上的DataSource(因此,也是多个的SqlSessionFactory),那么自动装配可能会失效。这种情况下,你可以使用sqlSessionFactory或sqlSessionTemplate属性来设置正确的工厂/模板。
MapperScannerConfigurer支持过滤由指定的创建接口或注解创建映射器。annotationClass属性指定了要寻找的注解名称。markerInterface属性指定了要寻找的父接口。如果两者都被指定了,加入到接口中的映射器会匹配两种标准。默认情况下,这两个属性都是null,所以在基包中给定的所有接口可以作为映射器加载。
被发现的映射器将会使用Spring对自动侦测组件默认的命名策略来命名。也就是说,如果没有发现注解,它就会使用映射器的非大写的非完全限定类名。但是如果发现了@Component或JSR-330@Named注解,它会获取名称。