這篇文章將為大家詳細(xì)講解有關(guān)Mybatis中如何使用MapperScannerConfigurer自動(dòng)掃描Mapper接口生成代理注入到Spring，小編覺(jué)得挺實(shí)用的，因此分享給大家做個(gè)參考，希望大家閱讀完這篇文章后可以有所收獲。

創(chuàng)新互聯(lián)公司始終堅(jiān)持【策劃先行，效果至上】的經(jīng)營(yíng)理念，通過(guò)多達(dá)十余年累計(jì)超上千家客戶(hù)的網(wǎng)站建設(shè)總結(jié)了一套系統(tǒng)有效的全網(wǎng)營(yíng)銷(xiāo)推廣解決方案，現(xiàn)已廣泛運(yùn)用于各行各業(yè)的客戶(hù)，其中包括：餐廳設(shè)計(jì)等企業(yè)，備受客戶(hù)認(rèn)可。

前言

Mybatis MapperScannerConfigurer 自動(dòng)掃描 將Mapper接口生成代理注入到Spring Mybatis在與Spring集成的時(shí)候可以配置 MapperFactoryBean來(lái)生成Mapper接口的代理。

例如：

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

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

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

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

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

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

整體配置如下所示：

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

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

接下來(lái)讓我們看一下MapperScannerConfigurer類(lèi)的源碼 看看是如何自動(dòng)掃描的。

/** 
 * {@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方法里，讓我們跟蹤進(jìn)去看一下。

/** 
 * 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. 
 * 
This method does not 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 doScan(String... basePackages) { 
 Assert.notEmpty(basePackages, "At least one base package must be specified"); 
 Set beanDefinitions = new LinkedHashSet(); 
 for (String basePackage : basePackages) { 
 Set 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; 
}

關(guān)于“Mybatis中如何使用MapperScannerConfigurer自動(dòng)掃描Mapper接口生成代理注入到Spring”這篇文章就分享到這里了，希望以上內(nèi)容可以對(duì)大家有一定的幫助，使各位可以學(xué)到更多知識(shí)，如果覺(jué)得文章不錯(cuò)，請(qǐng)把它分享出去讓更多的人看到。