Spring Boot淺析

Spring Boot 并不是對 Spring 框架的替代，而是對 Spring 的“自動配置”和“快速啟動”的封裝與增強。

1.依賴管理（Starter POMs）

Spring Boot 提供了一系列 spring-boot-starter-* 依賴，這些 starter 內部已經預定義了常用 Spring 模塊（如 Spring Core、Spring Context、Spring Web、Spring Data 等）的兼容版本。

例如：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

這個 starter 自動引入了：

• Spring MVC（用于 Web 開發(fā)）
• Spring Core / Context（IoC 容器）
• Jackson（JSON 處理）
• Tomcat（內嵌 Web 容器）
• 其他 Web 相關依賴

這樣開發(fā)者無需手動管理大量依賴及其版本。

2.自動配置（AutoConfiguration）

Spring Boot 通過 @EnableAutoConfiguration（通常由 @SpringBootApplication 啟用）掃描 classpath 中存在的類，自動配置 Spring 應用上下文。

例如：

• 如果 classpath 中有 DispatcherServlet（來自 Spring Web），Spring Boot 會自動配置一個基于 Spring MVC 的 Web 應用。
• 如果檢測到 HikariCP 和 MySQL 驅動，會自動配置數據源。

這一切都建立在 Spring 的條件化配置（@Conditional）機制之上，是 Spring Framework 本身提供的能力。

3.內嵌容器支持

Spring Boot 內置了 Tomcat、Jetty 或 Undertow，使得 Web 應用可以獨立運行（jar 包直接啟動），而不需要部署到外部 Servlet 容器。但底層處理 HTTP 請求、路由、攔截器等，依然依賴 Spring MVC。

4.Spring Boot = Spring + 約定優(yōu)于配置 + 快速啟動工具

本質上，Spring Boot 是 Spring 生態(tài)的“腳手架”，它讓開發(fā)者能以最少的配置快速構建生產級應用，但核心功能（IoC、AOP、事務、Web 層等）仍然由 Spring Framework 提供。

• 對于 Web 應用（尤其是 REST API 或傳統(tǒng) Web 項目），Spring Boot 默認使用 Spring MVC 作為 Web 層框架，因此很多人感覺“Spring Boot = Spring MVC”。
• spring-boot-starter-web 默認引入 Spring MVC，并自動配置 DispatcherServlet、視圖解析器、消息轉換器等，使得 Web 開發(fā)極其便捷。

? 誤解澄清：

• Spring Boot 不僅限于 Web 應用。你也可以構建：
• 命令行應用（無 Web）
• 消息驅動應用（如集成 Kafka、RabbitMQ）
• 批處理應用（配合 Spring Batch）
• 響應式應用（使用 WebFlux 而非 MVC）
• 在這些場景中，Spring MVC 根本不會被使用。例如：

@SpringBootApplication
public class BatchApplication {
    public static void main(String[] args) {
        SpringApplication.run(BatchApplication.class, args);
    }
}

• 這個應用可能只用到 Spring Core、Spring Batch，完全不涉及 MVC。

?? 更準確的說法：

Spring Boot 的核心是 Spring Framework，而 Spring MVC 是其在構建 Web 應用時默認采用的 Web 層實現。

核心機制：Starter + AutoConfiguration

1.Starter 依賴（約定優(yōu)于配置）

Spring Boot 提供了一系列 spring-boot-starter-* 依賴，每個 starter 封裝了某個功能領域所需的全部依賴。

例如：

<!-- Web 應用 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- 數據訪問（JPA） -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<!-- 安全控制 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-security</artifactId>
</dependency>

這些 starter 內部已經：

• 引入了對應的 Spring 模塊（如 spring-webmvc、spring-data-jpa、spring-security-web）
• 設置了兼容的版本（通過 spring-boot-dependencies 管理）
• 包含了自動配置類（位于 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports）

2.自動配置（AutoConfiguration）

Spring Boot 在啟動時（通過 @EnableAutoConfiguration）會掃描所有 starter 中聲明的自動配置類，并根據 條件注解（@Conditional...） 決定是否啟用。

示例：Spring Data JPA 的自動配置

當你引入 spring-boot-starter-data-jpa 后：

• Spring Boot 檢測到 classpath 中存在 EntityManager.class 和 DataSource.class
• 自動配置類 JpaRepositoriesAutoConfiguration 被激活
• 自動創(chuàng)建 EntityManagerFactory、TransactionManager、JpaRepository 實現等

你只需寫：

public interface UserRepository extends JpaRepository<User, Long> {}

無需手動配置數據源、事務、實體管理器等。

條件化配置的關鍵注解：

• @ConditionalOnClass：當 classpath 存在某類時生效
• @ConditionalOnMissingBean：當容器中沒有某 Bean 時才創(chuàng)建
• @ConditionalOnProperty：根據配置屬性決定是否啟用

常見 Spring 模塊集成示例

自定義集成：如何集成非官方或自研模塊？

即使沒有官方 starter，也可以手動集成 Spring 模塊：

步驟：

1. 引入依賴（如第三方庫或自定義 Spring 組件）
2. 編寫自動配置類（可選）
3. 在 application.properties 中提供配置項
4. 使用 @Import 或 @ComponentScan 加載配置

示例：手動集成 MyBatis（雖有官方 starter，但演示原理）

@Configuration
@ConditionalOnClass(SqlSessionFactory.class)
@EnableConfigurationProperties(MyBatisProperties.class)
public class MyBatisAutoConfig {
    @Bean
    @ConditionalOnMissingBean
    public SqlSessionFactory sqlSessionFactory(DataSource dataSource) {
        // 手動構建 SqlSessionFactory
    }
}

然后在 resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 中注冊該配置類，即可實現類似 starter 的效果。

手動集成步驟詳解（無 starter）

? 目標

不使用 mybatis-spring-boot-starter，而是通過手動配置，讓 MyBatis 在 Spring Boot 中正常工作。

第 1 步：添加依賴

在 pom.xml 中引入必要依賴（注意：不引入 starter）：

<!-- MyBatis 核心 -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.13</version>
</dependency>
<!-- MyBatis 與 Spring 集成橋接 -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis-spring</artifactId>
    <version>3.0.3</version>
</dependency>
<!-- 數據庫驅動（以 H2 為例） -->
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>runtime</scope>
</dependency>
<!-- Spring Boot JDBC（提供 DataSource 自動配置） -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>

?? 注意：我們只用了 spring-boot-starter-jdbc 來讓 Spring Boot 自動配置 DataSource，但沒有用 MyBatis 的 starter。

第 2 步：配置數據源（application.yml）

spring:
  datasource:
    url: jdbc:h2:mem:testdb
    driver-class-name: org.h2.Driver
    username: sa
    password: ''

Spring Boot 會自動創(chuàng)建一個 DataSource Bean。

第 3 步：編寫 MyBatis 配置類（核心！）

這是手動集成的關鍵：用 Java Config 替代 XML 配置。

@Configuration
@MapperScan(basePackages = "com.example.demo.mapper") // 掃描 Mapper 接口
public class MyBatisConfig {
    @Bean
    public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception {
        SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean();
        factoryBean.setDataSource(dataSource);
        // 可選：設置 MyBatis 全局配置（如駝峰映射）
        org.apache.ibatis.session.Configuration configuration = new org.apache.ibatis.session.Configuration();
        configuration.setMapUnderscoreToCamelCase(true);
        factoryBean.setConfiguration(configuration);
        // 可選：注冊 Mapper XML 文件位置
        // factoryBean.setMapperLocations(new PathMatchingResourcePatternResolver()
        //     .getResources("classpath:mapper/*.xml"));
        return factoryBean.getObject();
    }
    @Bean
    public PlatformTransactionManager transactionManager(DataSource dataSource) {
        return new DataSourceTransactionManager(dataSource);
    }
}

關鍵點解析：

?? 注意：SqlSessionFactoryBean 是 FactoryBean<SqlSessionFactory>，調用 .getObject() 才得到真正的 SqlSessionFactory。

第 4 步：編寫 Mapper 接口和實體類

// 實體類
public class User {
    private Long id;
    private String name;
    // getter/setter
}
// Mapper 接口
@Mapper // 可省略，因為 @MapperScan 已覆蓋
public interface UserMapper {
    @Select("SELECT * FROM user WHERE id = #{id}")
    User findById(Long id);
    @Insert("INSERT INTO user(name) VALUES(#{name})")
    @Options(useGeneratedKeys = true, keyProperty = "id")
    void insert(User user);
}

如果使用 XML 映射文件，需在 SqlSessionFactory 中通過 setMapperLocations() 指定路徑。

第 5 步：在 Service 中使用

@Service
public class UserService {
    @Autowired
    private UserMapper userMapper;
    @Transactional
    public void createUser(String name) {
        User user = new User();
        user.setName(name);
        userMapper.insert(user); // 自動生成 ID
        System.out.println("Inserted user ID: " + user.getId());
    }
}

第 6 步：啟動類

@SpringBootApplication
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

對比官方 Starter 做了什么？

官方 mybatis-spring-boot-starter 實際上做了以下事情：

1. 引入 mybatis + mybatis-spring
2. 提供 MybatisProperties 類綁定 mybatis.* 配置項（如 mybatis.configuration.map-underscore-to-camel-case=true）
3. 提供自動配置類 MybatisAutoConfiguration，內部邏輯幾乎和我們上面寫的 MyBatisConfig 一致
4. 自動處理 MapperScannerRegistrar，支持 @MapperScan 或自動掃描帶 @Mapper 的接口

所以，手動集成 = 把 starter 的自動配置代碼自己寫一遍。

到此這篇關于Spring Boot 集成 mybatis核心機制的文章就介紹到這了,更多相關Spring Boot 集成 mybatis內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

最新評論