SSM整合之使用配置類替換xml配置文件(2)

SSM整合就是將MVC三層架構和框架核心API組件交給SpringIoC容器管理！一般需要配置兩個IoC容器進行三層架構組件管理。容器名盛放組件 web容器 web相關組件（controller,springmvc核心組件） root容器業務和持久層相關組件（service,aop,tx,d ...

SSM整合就是將MVC三層架構和框架核心API組件交給SpringIoC容器管理！
一般需要配置兩個IoC容器進行三層架構組件管理。

容器名	盛放組件
web容器	web相關組件（controller,springmvc核心組件）
root容器	業務和持久層相關組件（service,aop,tx,dataSource,mybatis,mapper等）

web容器是root容器的子容器，父子容器關係。
父容器：root容器，盛放service、mapper、mybatis等相關組件
子容器：web容器，盛放controller、web相關組件

根據MVC三層架構配置三個配置類：

配置名	對應內容	對應容器
SpringMvcConfig	controller,springmvc相關	web容器
SpringConfig	service,aop,tx相關	root容器
MapperConfig	mapper,datasource,mybatis相關	root容器

配置演示

控制層配置(SpringMVC)

主要配置Web工程的controller層配置

@Configurable
@ComponentScan(basePackages = {"com.evan.controller","com.evan.exceptionhandler"})
@EnableWebMvc
public class SpringMvcConfig implements WebMvcConfigurer {

    //開啟靜態資源訪問
    @Override
    public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
        configurer.enable();
    }

    //視圖解析器
    @Override
    public void configureViewResolvers(ViewResolverRegistry registry) {
        registry.jsp("/WEB-INF/views","jsp");
    }

    //配置視圖控制器
    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        registry.addViewController("/")
                .setStatusCode(HttpStatusCode.valueOf(200))
                .setViewName("index");
    }
}

業務層組件配置(Spring)

主要配置service,註解aop和聲明事務相關配置

@Configurable
@ComponentScan(basePackages = {"com.evan.service"})
@EnableAspectJAutoProxy
@EnableTransactionManagement
public class SpringConfig {

    //配置事務管理器
    @Bean
    public TransactionManager transactionManager(DataSource dataSource) {
        DataSourceTransactionManager transactionManager = new DataSourceTransactionManager();
        transactionManager.setDataSource(dataSource);
        return transactionManager;
    }

}

持久層配置(MyBatis)

主要配置mapper代理對象，連接池和mybatis核心組件配置

外部資料庫連接配置文件

jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.username=root
jdbc.password=******
jdbc.url=jdbc://mysql://localhost:3306/dbtest1?serverTimezone=GMT%2B8&characterEncoding=utf-8

配置方式1(保留mybatis-config.xml)

依然保留mybatis的外部配置文件（xml）, 但是資料庫連接信息交給Druid連接池配置！
缺點：依然需要mybatis-config.xml文件，進行xml文件解析，效率偏低！
mybatis-config.xml

資料庫信息以及mapper掃描包設置使用Java配置類處理！
mybatis其他的功能（別名、settings、插件等信息）依然在mybatis-config.xml配置！

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <settings>
        <!-- 開啟駝峰式映射-->
        <setting name="mapUnderscoreToCamelCase" value="true"/>
        <!-- 開啟logback日誌輸出-->
        <setting name="logImpl" value="SLF4J"/>
        <!--開啟resultMap自動映射 -->
        <setting name="autoMappingBehavior" value="FULL"/>
    </settings>

    <typeAliases>
        <!-- 給實體類起別名 -->
        <package name="com.evan.bean"/>
    </typeAliases>

    <plugins>
        <plugin interceptor="com.github.pagehelper.PageInterceptor">
            <!--
                helperDialect：分頁插件會自動檢測當前的資料庫鏈接，自動選擇合適的分頁方式。
                你可以配置helperDialect屬性來指定分頁插件使用哪種方言。配置時，可以使用下麵的縮寫值：
                oracle,mysql,mariadb,sqlite,hsqldb,postgresql,db2,sqlserver,informix,h2,sqlserver2012,derby
                （完整內容看 PageAutoDialect） 特別註意：使用 SqlServer2012 資料庫時，
                https://github.com/pagehelper/Mybatis-PageHelper/blob/master/wikis/zh/HowToUse.md#%E5%A6%82%E4%BD%95%E9%85%8D%E7%BD%AE%E6%95%B0%E6%8D%AE%E5%BA%93%E6%96%B9%E8%A8%80
             -->
            <property name="helperDialect" value="mysql"/>
        </plugin>
    </plugins>
</configuration>

持久層配置類

/**
 * @Author: lisong
 * @CreateTime: 2024-03-03 18:41 星期日
 * @Description:
 */
@Configurable
public class MyBatisConfig {

    //配置用於創建SqlSessionFactory的工廠bean
    @Bean
    public SqlSessionFactoryBean sqlSessionFactory(DataSource dataSource) {
        SqlSessionFactoryBean sqlSessionFactoryBean = new SqlSessionFactoryBean();
        // 設置數據源
        sqlSessionFactoryBean.setDataSource(dataSource);
        // 設置MyBatis配置文件的路徑
        Resource resource = new ClassPathResource("mybatis-config.xml");
        sqlSessionFactoryBean.setMapperLocations(resource);
        //設置實體類對象別名
        sqlSessionFactoryBean.setTypeAliasesPackage("com.evan.bean");
        return sqlSessionFactoryBean;
    }

    /**
     * 配置mapper介面的掃描配置
     * 由mybatis-spring提供，可以將指定包下所有的mapper介面創建動態代理
     * 並將這些動態代理作為IOC容器的bean管理
     * @return
     */
    @Bean
    public MapperScannerConfigurer mapperScannerConfigurer() {
        MapperScannerConfigurer mapperScannerConfigurer = new MapperScannerConfigurer();
        //設置mapper介面和xml文件所在的共同包
        mapperScannerConfigurer.setBasePackage("com.evan.mapper");
        return mapperScannerConfigurer;
    }
}

說明：
在Spring配置類中添加了sqlSessionFactoryBean、mapperScannerConfigurer和datasource配置方法時，可能會導致@Value註解讀取不到值為null的問題。
這是因為SqlSessionFactoryBean和MapperScannerConfigurer是基於MyBatis框架的配置，它們的初始化順序可能會導致屬性註入的問題。
SqlSessionFactoryBean和MapperScannerConfigurer在配置類中通常是用來配置MyBatis相關的Bean，例如數據源、事務管理器、Mapper掃描等。這些配置類通常在@Configuration註解下定義，並且使用@Value註解來註入屬性值。
當配置類被載入時，Spring容器會首先處理Bean的定義和初始化，其中包括sqlSessionFactoryBean和mapperScannerConfigurer的初始化。在這個過程中，如果@Value註解所在的Bean還沒有被完全初始化，可能會導致註入的屬性值為null。
解決方案：
分成兩個配置類獨立配置，互不影響，資料庫提取一個配置類，mybatis提取一個配置類即可解決！

資料庫配置類

@Configurable
@PropertySource("classpath:jdbc.properties")
public class DataSourceConfig {

    @Value("${jdbc.url}")
    private String url;
    @Value("${jdbc.driver}")
    private String driver;
    @Value("${jdbc.username}")
    private String username;
    @Value("${jdbc.password}")
    private String password;

    //配置數據源
    @Bean
    public DataSource dataSource() {
        DruidDataSource dataSource = new DruidDataSource();
        dataSource.setDriverClassName(driver);
        dataSource.setUrl(url);
        dataSource.setUsername(username);
        dataSource.setPassword(password);
        return dataSource;
    }
}

配置方式2(完全配置類，去掉mybatis-config.xml)

不在保留mybatis的外部配置文件（xml）, 所有配置信息（settings、插件、別名等）全部在聲明SqlSessionFactoryBean的代碼中指定！資料庫信息依然使用DruidDataSource實例替代！
優勢：全部配置類，避免了XML文件解析效率低問題！
mapper配置類

@Configurable
public class MapperConfig {

    //配置用於創建SqlSessionFactory的工廠bean
    @Bean
    public SqlSessionFactoryBean sqlSessionFactory(DataSource dataSource) {
        SqlSessionFactoryBean sqlSessionFactoryBean = new SqlSessionFactoryBean();
        sqlSessionFactoryBean.setDataSource(dataSource);
        //Resource resource = new ClassPathResource("mybatis-config.xml");
        //sqlSessionFactoryBean.setMapperLocations(resource);

        //全局配置項,不要導錯包
        //org.apache.ibatis.session.Configuration
        Configuration configuration = new Configuration();
        //開啟駝峰式映射
        configuration.setMapUnderscoreToCamelCase(true);
        //開啟logback日誌輸出
        configuration.setLogImpl(Slf4jImpl.class);
        //開啟resultMap自動映射
        configuration.setAutoMappingBehavior(AutoMappingBehavior.FULL);
        sqlSessionFactoryBean.setConfiguration(configuration);

        //實體類對象別名設置
        sqlSessionFactoryBean.setTypeAliasesPackage("com.evan.bean");

        //分頁插件配置
        PageInterceptor pageInterceptor = getPageInterceptor();
        sqlSessionFactoryBean.addPlugins(pageInterceptor);
        return sqlSessionFactoryBean;
    }

    //分頁插件配置信息
    private static PageInterceptor getPageInterceptor() {
        PageInterceptor pageInterceptor = new PageInterceptor();
        Properties properties = new Properties();
        /*
        helperDialect：分頁插件會自動檢測當前的資料庫鏈接，自動選擇合適的分頁方式。
        你可以配置helperDialect屬性來指定分頁插件使用哪種方言。配置時，可以使用下麵的縮寫值：
        oracle,mysql,mariadb,sqlite,hsqldb,postgresql,db2,sqlserver,informix,h2,sqlserver2012,derby
        （完整內容看 PageAutoDialect） 特別註意：使用 SqlServer2012 資料庫時，
        https://github.com/pagehelper/Mybatis-PageHelper/blob/master/wikis/zh/HowToUse.md#%E5%A6%82%E4%BD%95%E9%85%8D%E7%BD%AE%E6%95%B0%E6%8D%AE%E5%BA%93%E6%96%B9%E8%A8%80
        */
        properties.setProperty("helperDialect","mysql");
        pageInterceptor.setProperties(properties);
        return pageInterceptor;
    }

    //配置Mapper實例掃描工廠,配置掃描package需要介面和mapper.xml文件同一個包
    @Bean
    public MapperScannerConfigurer mapperScannerConfigurer() {
        MapperScannerConfigurer mapperScannerConfigurer = new MapperScannerConfigurer();
        //設置mapper介面和xml文件所在的共同包
        mapperScannerConfigurer.setBasePackage("com.evan.mapper");
        return mapperScannerConfigurer;
    }
}

配置web項目初始化類

public class WebInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {

    //指定root IoC容器的配置類
    @Override
    protected Class<?>[] getRootConfigClasses() {
        return new Class[]{SpringConfig.class, MyBatisConfig.class, DataSourceConfig.class};
    }

    //指定web IoC容器的配置類
    @Override
    protected Class<?>[] getServletConfigClasses() {
        return new Class[]{SpringMvcConfig.class};
    }

    //DispatcherServlet請求分發的匹配路徑
    @Override
    protected String[] getServletMappings() {
        return new String[]{"/"};
    }
}

圖解配置類和容器配置: