Mybatis MapperScannerConfigurer自動掃描Mapper接口生成代理注入到Spring的方法

更新時間：2019年03月11日 10:01:26 作者：bijian1013

這篇文章主要給大家介紹了關于Mybatis MapperScannerConfigurer自動掃描將Mapper接口生成代理注入到Spring的相關資料，文中通過示例代碼介紹的非常詳細，需要的朋友可以參考下

前言

Mybatis MapperScannerConfigurer 自動掃描將Mapper接口生成代理注入到Spring Mybatis在與Spring集成的時候可以配置 MapperFactoryBean來生成Mapper接口的代理。

例如：

<bean id="userMapper" class="org.mybatis.spring.mapper.MapperFactoryBean">
 <property name="mapperInterface" value="com.bijian.study.dao" />
 <property name="sqlSessionFactory" ref="sqlSessionFactory" />
</bean>

MapperFactoryBean創(chuàng)建的代理類實現(xiàn)了 UserMapper 接口,并且注入到應用程序中。因為代理創(chuàng)建在運行時環(huán)境中(Runtime,譯者注) ,那么指定的映射器必須是一個接口,而不是一個具體的實現(xiàn)類。

上面的配置有一個很大的缺點，就是系統(tǒng)有很多的配置文件時全部需要手動編寫，所以上述的方式已經(jīng)很用了。

沒有必要在 Spring 的 XML 配置文件中注冊所有的映射器。相反,你可以使用一個 MapperScannerConfigurer，它將會查找類路徑下的映射器并自動將它們創(chuàng) 建成 MapperFactoryBean。

要創(chuàng)建 MapperScannerConfigurer，可以在 Spring 的配置中添加如下代碼：

<bean id="userMapper" class="org.mybatis.spring.mapper.MapperFactoryBean">
 <property name="mapperInterface" value="com.bijian.study.dao" />
 <property name="sqlSessionFactory" ref="sqlSessionFactory" />
</bean>

basePackage 屬性是讓你為映射器接口文件設置基本的包路徑。你可以使用分號或逗號作為分隔符設置多于一個的包路徑。每個映射器將會在指定的包路徑中遞歸地被搜索到。

注意，沒有必要去指定 SqlSessionFactory 或 SqlSessionTemplate , 因為 MapperScannerConfigurer 將會創(chuàng)建 MapperFactoryBean,之后自動裝配。但是,如果你使用了一個以上的 DataSource ,那么自動裝配可能會失效。這種情況下 ,你可以使用 sqlSessionFactoryBeanName 或 sqlSessionTemplateBeanName 屬性來設置正確的 bean 名稱來使用。這就是它如何來配置的,注意 bean 的名稱是必須的,而不是 bean 的引用,因此,value 屬性在這里替代通常的ref。

<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory" />

整體配置如下所示：

<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
	<property name="dataSource" ref="dataSource" />
	<property name="mapperLocations" value="classpath*:**/*Dao*.xml"></property>
</bean>

<!-- dao配置 -->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
	<property name="basePackage" value="com.bijian.study.dao" />
	<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory" />
</bean>

MapperScannerConfigurer 支持過濾由指定的創(chuàng) 建接口或注解創(chuàng) 建映射器。 annotationClass 屬性指定了要尋找的注解名稱。 markerInterface 屬性指定了要尋找的父接口。如果兩者都被指定了，加入到接口中的映射器會匹配兩種標準。默認情況下，這兩個屬性都是 null,所以在基包中給定的所有接口可以作為映射器加載。

被發(fā)現(xiàn)的映射器將會使用 Spring 對自動偵測組件(參考 Spring 手冊的 3.14.4)默認的命名策略來命名。也就是說,如果沒有發(fā)現(xiàn)注解,它就會使用映射器的非大寫的非完全限定類名。但是如果發(fā)現(xiàn)了@Component 或 JSR-330 的@Named 注解,它會獲取名稱。注意你可以配置到 org.springframework.stereotype.Component , javax.inject.Named(如果你使用 JSE 6 的話)或你自己的注解(肯定是自我注解)中,這樣注解將會用作生成器和名稱提供器。

接下來讓我們看一下MapperScannerConfigurer類的源碼看看是如何自動掃描的。

/** 
 * {@inheritDoc} 
 * 
 * @since 1.0.2 
 */ 
@Override 
public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry) { 
 if (this.processPropertyPlaceHolders) { 
 processPropertyPlaceHolders(); 
 } 
 
 ClassPathMapperScanner scanner = new ClassPathMapperScanner(registry); 
 scanner.setAddToConfig(this.addToConfig); 
 scanner.setAnnotationClass(this.annotationClass); 
 scanner.setMarkerInterface(this.markerInterface); 
 scanner.setSqlSessionFactory(this.sqlSessionFactory); 
 scanner.setSqlSessionTemplate(this.sqlSessionTemplate); 
 scanner.setSqlSessionFactoryBeanName(this.sqlSessionFactoryBeanName); 
 scanner.setSqlSessionTemplateBeanName(this.sqlSessionTemplateBeanName); 
 scanner.setResourceLoader(this.applicationContext); 
 scanner.setBeanNameGenerator(this.nameGenerator); 
 scanner.registerFilters(); 
 scanner.scan(StringUtils.tokenizeToStringArray(this.basePackage, ConfigurableApplicationContext.CONFIG_LOCATION_DELIMITERS)); 
}

把Mapper接口轉(zhuǎn)換成MapperFactoryBean的代碼在scanner.scan方法里，讓我們跟蹤進去看一下。

/** 
 * Perform a scan within the specified base packages. 
 * @param basePackages the packages to check for annotated classes 
 * @return number of beans registered 
 */ 
public int scan(String... basePackages) { 
 int beanCountAtScanStart = this.registry.getBeanDefinitionCount(); 
 
 doScan(basePackages); 
 
 // Register annotation config processors, if necessary. 
 if (this.includeAnnotationConfig) { 
 AnnotationConfigUtils.registerAnnotationConfigProcessors(this.registry); 
 } 
 
 return (this.registry.getBeanDefinitionCount() - beanCountAtScanStart); 
}

/** 
 * Perform a scan within the specified base packages, 
 * returning the registered bean definitions. 
 * <p>This method does <i>not</i> register an annotation config processor 
 * but rather leaves this up to the caller. 
 * @param basePackages the packages to check for annotated classes 
 * @return set of beans registered if any for tooling registration purposes (never {@code null}) 
 */ 
protected Set<BeanDefinitionHolder> doScan(String... basePackages) { 
 Assert.notEmpty(basePackages, "At least one base package must be specified"); 
 Set<BeanDefinitionHolder> beanDefinitions = new LinkedHashSet<BeanDefinitionHolder>(); 
 for (String basePackage : basePackages) { 
 Set<BeanDefinition> candidates = findCandidateComponents(basePackage); 
 for (BeanDefinition candidate : candidates) { 
  ScopeMetadata scopeMetadata = this.scopeMetadataResolver.resolveScopeMetadata(candidate); 
  candidate.setScope(scopeMetadata.getScopeName()); 
  String beanName = this.beanNameGenerator.generateBeanName(candidate, this.registry); 
  if (candidate instanceof AbstractBeanDefinition) { 
  postProcessBeanDefinition((AbstractBeanDefinition) candidate, beanName); 
  } 
  if (candidate instanceof AnnotatedBeanDefinition) { 
  AnnotationConfigUtils.processCommonDefinitionAnnotations((AnnotatedBeanDefinition) candidate); 
  } 
  if (checkCandidate(beanName, candidate)) { 
  BeanDefinitionHolder definitionHolder = new BeanDefinitionHolder(candidate, beanName); 
  definitionHolder = AnnotationConfigUtils.applyScopedProxyMode(scopeMetadata, definitionHolder, this.registry); 
  beanDefinitions.add(definitionHolder); 
  registerBeanDefinition(definitionHolder, this.registry); 
  } 
 } 
 } 
 return beanDefinitions; 
}

總結(jié)

以上就是這篇文章的全部內(nèi)容了，希望本文的內(nèi)容對大家的學習或者工作具有一定的參考學習價值，謝謝大家對腳本之家的支持。

您可能感興趣的文章: