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[]{"/"};
}
}
圖解配置類和容器配置: