Mybatis MapperScannerConfigurer 自動掃描 將Mapper介面組建代理程式注入到Spring

標籤：super   run   設定   sql   this   time   ati   original   exception   

　　Mybatis MapperScannerConfigurer 自動掃描 將Mapper介面組建代理程式注入到Spring

　　Mybatis在與Spring整合的時候可以配置MapperFactoryBean來產生Mapper介面的代理. 例如

<bean id="userMapper" class="org.mybatis.spring.mapper.MapperFactoryBean">  　　<property name="mapperInterface" value="org.mybatis.spring.sample.mapper.UserMapper" />  　　<property name="sqlSessionFactory" ref="sqlSessionFactory" /></bean>

　　MapperFactoryBean 建立的代理類實現了 UserMapper 介面,並且注入到應用程式中。 因為代理建立在運行時環境中(Runtime,譯者注) ,那麼指定的映射器必須是一個介面,而 不是一個具體的實作類別。

　　上面的配置有一個很大的缺點，就是系統有很多的設定檔時 全部需要手動編寫，所以上述的方式已經很少用了。

　　沒有必要在 Spring 的 XML 設定檔中註冊所有的映射器。相反,你可以使用一個 MapperScannerConfigurer , 它 將 會 查 找 類 路 徑 下 的 映 射 器 並 自 動 將 它 們 創 建 成 MapperFactoryBean。

 

　　要建立 MapperScannerConfigurer,可以在 Spring 的配置中添加如下代碼:

<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">  <property name="basePackage" value="org.mybatis.spring.sample.mapper" /></bean>

　　basePackage 屬性是讓你為映射器介面檔案設定基本的包路徑。 你可以使用分號或逗號 作為分隔字元設定多於一個的包路徑。每個映射器將會在指定的包路徑中遞迴地被搜尋到。

　　注 意 ：沒 有 必 要 去 指 定 SqlSessionFactory 或 SqlSessionTemplate , 因 為 MapperScannerConfigurer 將會建立 MapperFactoryBean,之後自動裝配。

　　但是,如果你使 用了一個 以上的 DataSource ,那 麼自動 裝配可 能會失效 。這種 情況下 ,你可 以使用 sqlSessionFactoryBeanName 或 sqlSessionTemplateBeanName 屬性來設定正確的 bean 名 稱來使用。這就是它如何來配置的,注意 bean 的名稱是必須的,而不是 bean 的引用,因 此,value 屬性在這裡替代通常的 ref:

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

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

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

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

public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry) throws BeansException {    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介面轉換成MapperFactoryBean的代碼在地17行這個方法裡，讓我們跟蹤進去看一下。

@Override  public Set<BeanDefinitionHolder> doScan(String... basePackages) {    Set<BeanDefinitionHolder> beanDefinitions = super.doScan(basePackages);    if (beanDefinitions.isEmpty()) {      logger.warn("No MyBatis mapper was found in ‘" + Arrays.toString(basePackages) + "‘ package. Please check your configuration.");    } else {      for (BeanDefinitionHolder holder : beanDefinitions) {        GenericBeanDefinition definition = (GenericBeanDefinition) holder.getBeanDefinition();        if (logger.isDebugEnabled()) {          logger.debug("Creating MapperFactoryBean with name ‘" + holder.getBeanName()               + "‘ and ‘" + definition.getBeanClassName() + "‘ mapperInterface");        }        // the mapper interface is the original class of the bean        // but, the actual class of the bean is MapperFactoryBean        //把介面的類型設定進去        definition.getPropertyValues().add("mapperInterface", definition.getBeanClassName());        //設定Bean的真實類型MapperFactoryBean         definition.setBeanClass(MapperFactoryBean.class);        //是否把Mapper介面加入到Mybatis的Config當中去        definition.getPropertyValues().add("addToConfig", this.addToConfig);        boolean explicitFactoryUsed = false;        //如果sqlSessionFactoryBeanName的名字不為空白 則在Spring容器中查詢        //適合多資料來源        if (StringUtils.hasText(this.sqlSessionFactoryBeanName)) {          definition.getPropertyValues().add("sqlSessionFactory", new RuntimeBeanReference(this.sqlSessionFactoryBeanName));          explicitFactoryUsed = true;        } else if (this.sqlSessionFactory != null) {          definition.getPropertyValues().add("sqlSessionFactory", this.sqlSessionFactory);          explicitFactoryUsed = true;        }        //如果sqlSessionTemplateBeanName的名字不為空白 則在Spring容器中查詢        //適合多資料來源        if (StringUtils.ha        if (StringUtils.hasText(this.sqlSessionTemplateBeanName)) {          if (explicitFactoryUsed) {            logger.warn("Cannot use both: sqlSessionTemplate and sqlSessionFactory together. sqlSessionFactory is ignored.");          }          definition.getPropertyValues().add("sqlSessionTemplate", new RuntimeBeanReference(this.sqlSessionTemplateBeanName));          explicitFactoryUsed = true;        } else if (this.sqlSessionTemplate != null) {          if (explicitFactoryUsed) {            logger.warn("Cannot use both: sqlSessionTemplate and sqlSessionFactory together. sqlSessionFactory is ignored.");          }          definition.getPropertyValues().add("sqlSessionTemplate", this.sqlSessionTemplate);          explicitFactoryUsed = true;        }        if (!explicitFactoryUsed) {          if (logger.isDebugEnabled()) {            logger.debug("Enabling autowire by type for MapperFactoryBean with name ‘" + holder.getBeanName() + "‘.");          }          definition.setAutowireMode(AbstractBeanDefinition.AUTOWIRE_BY_TYPE);        }      }    }    //這個集合返回以後 Spring容器會將裡面的所有內容註冊到容器中    return beanDefinitions;  }

（轉）Mybatis MapperScannerConfigurer 自動掃描 將Mapper介面組建代理程式注入到Spring