設為首頁 加入收藏
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
您现在的位置： 程式碼之家 >> 編程語言 >  >> Java 程式設計 >> Java 綜合教學

SSM 框架整合實戰：Spring + SpringMVC + MyBatis 從零搭建博客系統（含登錄、增刪改查）

     編輯：Java 綜合教學

SSM 框架整合實戰：從零搭建博客系統

本文記錄 SSM（Spring + SpringMVC + MyBatis）整合全過程，以開發個人博客系統為例，涵蓋 Maven 依賴管理、三層架構劃分、核心配置文件、登錄功能完整實現、常見坑與解決方案，適合初學者快速落地。

技術棧與環境

  • JDK 1.8、Maven 3.6、MySQL 5.7、Tomcat 8/9、IntelliJ IDEA
  • Spring 4.3.x、SpringMVC 4.3.x、MyBatis 3.4.x、MyBatis-Spring 1.3.x

項目結構

src
├─ main
│  ├─ java
│  │  └─ com.myblogs
│  │      ├─ model        (POJO: User, Blog...)
│  │      ├─ mapper       (Mapper 接口 + XML)
│  │      ├─ service      (Service 接口 + Impl)
│  │      ├─ controller   (SpringMVC Controller)
│  │      └─ config       (Spring 配置類)
│  ├─ resources
│  │  ├─ mapper           (Mapper XML)
│  │  ├─ spring.xml       (Spring 核心容器)
│  │  ├─ spring-mvc.xml   (SpringMVC 配置)
│  │  ├─ mybatis-config.xml (MyBatis 全局配置)
│  │  └─ jdbc.properties  (數據源屬性)
│  └─ webapp
│      ├─ WEB-INF
│      │  ├─ web.xml
│      │  └─ jsps         (JSP 視圖)
│      └─ static          (CSS/JS/圖片)
└─ test

核心配置文件

1. pom.xml 關鍵依賴

<dependencies>
  <!-- Spring -->
  <dependency><groupId>org.springframework</groupId><artifactId>spring-context</artifactId><version>4.3.25.RELEASE</version></dependency>
  <dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>4.3.25.RELEASE</version></dependency>
  <dependency><groupId>org.springframework</groupId><artifactId>spring-jdbc</artifactId><version>4.3.25.RELEASE</version></dependency>
  <dependency><groupId>org.springframework</groupId><artifactId>spring-tx</artifactId><version>4.3.25.RELEASE</version></dependency>

  <!-- MyBatis -->
  <dependency><groupId>org.mybatis</groupId><artifactId>mybatis</artifactId><version>3.4.6</version></dependency>
  <dependency><groupId>org.mybatis</groupId><artifactId>mybatis-spring</artifactId><version>1.3.2</version></dependency>

  <!-- 數據庫連接池 -->
  <dependency><groupId>com.alibaba</groupId><artifactId>druid</artifactId><version>1.1.23</version></dependency>
  <dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>5.1.47</version></dependency>

  <!-- Web -->
  <dependency><groupId>javax.servlet</groupId><artifactId>javax.servlet-api</artifactId><version>3.1.0</version><scope>provided</scope></dependency>
  <dependency><groupId>javax.servlet.jsp</groupId><artifactId>jsp-api</artifactId><version>2.2</version><scope>provided</scope></dependency>
  <dependency><groupId>jstl</groupId><artifactId>jstl</artifactId><version>1.2</version></dependency>

  <!-- JSON -->
  <dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.9.10</version></dependency>
</dependencies>

2. jdbc.properties

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/myblogs?useUnicode=true&characterEncoding=utf8&useSSL=false
jdbc.username=root
jdbc.password=123456

3. spring.xml（核心容器：數據源、事務、Mapper 掃描、Service 掃描）

<beans xmlns="https://www.springframework.org/schema/beans"
       xmlns:context="https://www.springframework.org/schema/context"
       xmlns:tx="https://www.springframework.org/schema/tx"
       xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="https://www.springframework.org/schema/beans https://www.springframework.org/schema/beans/spring-beans.xsd
                           https://www.springframework.org/schema/context https://www.springframework.org/schema/context/spring-context.xsd
                           https://www.springframework.org/schema/tx https://www.springframework.org/schema/tx/spring-tx.xsd">

    <context:property-placeholder location="classpath:jdbc.properties"/>

    <!-- Druid 數據源 -->
    <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" destroy-method="close">
        <property name="driverClassName" value="${jdbc.driver}"/>
        <property name="url" value="${jdbc.url}"/>
        <property name="username" value="${jdbc.username}"/>
        <property name="password" value="${jdbc.password}"/>
        <property name="initialSize" value="5"/>
        <property name="maxActive" value="20"/>
    </bean>

    <!-- SqlSessionFactory -->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="dataSource" ref="dataSource"/>
        <property name="mapperLocations" value="classpath:mapper/*.xml"/>
        <property name="configLocation" value="classpath:mybatis-config.xml"/>
    </bean>

    <!-- 掃描 Mapper 接口自動創建代理 -->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.myblogs.mapper"/>
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
    </bean>

    <!-- 事務管理器 -->
    <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource"/>
    </bean>
    <tx:annotation-driven transaction-manager="transactionManager"/>

    <!-- 掃描 Service、Component -->
    <context:component-scan base-package="com.myblogs.service"/>
</beans>

4. spring-mvc.xml（Web 層：視圖解析器、靜態資源、註解驅動）

<beans xmlns="https://www.springframework.org/schema/beans"
       xmlns:mvc="https://www.springframework.org/schema/mvc"
       xmlns:context="https://www.springframework.org/schema/context"
       xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="https://www.springframework.org/schema/beans https://www.springframework.org/schema/beans/spring-beans.xsd
                           https://www.springframework.org/schema/mvc https://www.springframework.org/schema/mvc/spring-mvc.xsd
                           https://www.springframework.org/schema/context https://www.springframework.org/schema/context/spring-context.xsd">

    <context:component-scan base-package="com.myblogs.controller" use-default-filters="false">
        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>

    <mvc:annotation-driven>
        <mvc:message-converters>
            <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"/>
        </mvc:message-converters>
    </mvc:annotation-driven>

    <mvc:default-servlet-handler/>
    <mvc:resources mapping="/static/**" location="/static/"/>

    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/jsps/"/>
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>

5. web.xml（啟動 Spring 容器、配置 DispatcherServlet）

<web-app xmlns="https://java.sun.com/xml/ns/javaee" version="3.0">
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:spring.xml</param-value>
    </context-param>
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:spring-mvc.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

    <filter>
        <filter-name>encodingFilter</filter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
        <init-param><param-name>encoding</param-name><param-value>UTF-8</param-value></init-param>
        <init-param><param-name>forceEncoding</param-name><param-value>true</param-value></init-param>
    </filter>
    <filter-mapping>
        <filter-name>encodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
</web-app>

登錄功能完整實現

1. POJO User

package com.myblogs.model;
public class User {
    private Long id;
    private String username;
    private String password;
    private String email;
    // Getter/Setter 省略
}

2. Mapper 接口 + XML

// UserMapper.java
package com.myblogs.mapper;
import com.myblogs.model.User;
public interface UserMapper {
    int login(User user); // 返回匹配行數
}

<mapper namespace="com.myblogs.mapper.UserMapper">
    <select id="login" parameterType="com.myblogs.model.User" resultType="int">
        SELECT COUNT(*) FROM user WHERE username = #{username} AND password = #{password}
    </select>
</mapper>

3. Service 實現

package com.myblogs.service.impl;
import com.myblogs.mapper.UserMapper;
import com.myblogs.model.User;
import com.myblogs.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class UserServiceImpl implements UserService {
    @Autowired private UserMapper userMapper;

    @Override
    public boolean login(User user) {
        return userMapper.login(user) > 0; // 存在記錄即登錄成功
    }
}

4. Controller

package com.myblogs.controller;
import com.myblogs.model.User;
import com.myblogs.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;

@Controller
@RequestMapping("/user")
public class UserController {
    @Autowired private UserService userService;

    @GetMapping("/login")
    public String loginPage() { return "login"; }

    @PostMapping("/login")
    public String doLogin(User user, HttpSession session) {
        if (userService.login(user)) {
            session.setAttribute("username", user.getUsername());
            return "redirect:/blog/list"; // 登錄成功跳轉博客列表
        }
        return "login"; // 失敗返回登錄頁
    }
}

5. 登錄頁面 login.jsp

<form action="/user/login" method="post">
    <input name="username" placeholder="用戶名" required/>
    <input name="password" type="password" placeholder="密碼" required/>
    <button type="submit">登錄</button>
</form>

常見坑與解決方案

現象原因解決
ClassNotFoundException: DispatcherServletMaven 依賴未部署到 WEB-INF/libProject Properties → Deployment Assembly → Add → Java Build Path Entries → Maven Dependencies
NoClassDefFoundError: javax/servlet/jsp/jstl/core/Config缺少 jstl-api、jstl-impl jarpom.xml 添加 jstl:jstl:1.2、org.apache.taglibs:taglibs-standard-impl:1.2.5
Mapper 接口找不到 / 無法注入MapperScannerConfigurer basePackage 錯誤或 XML 命名空間不匹配確保 namespace=接口全限定名、id=方法名、XML 放在 classpath:mapper/
事務不生效事務管理器未掛載 DataSource / 未開啟 @Transactional檢查 transactionManager 引用正確、Service 方法加 @Transactional
中文亂碼Tomcat 8+ 默認 ISO-8859-1web.xml 配置 CharacterEncodingFilter forceEncoding=true、MySQL URL 加 useUnicode=true&characterEncoding=utf8

總結與擴展方向

SSM 整合核心在於「Spring 管理 Bean 生命周期與事務、SpringMVC 處理 Web 請求分發、MyBatis 封裝 SQL 映射」。掌握上述配置模板後，可快速擴展：

  • 博客增刪改查（Controller → Service → Mapper → MySQL）
  • 分頁插件 PageHelper、通用 Mapper tk.mybatis
  • Shiro/JWT 權限認證、Redis 緩存熱點數據
  • 前後端分離：Controller 返回 JSON、Vue/React 構建前端
  • 微服務化：Spring Cloud Alibaba (Nacos、Sentinel、Seata)
  1. 上一篇文章：
  2. 下一篇文章：
Java 綜合教學
深入理解 Java Servlet 過濾器：原理、生命週期與實戰應用 深入理解 Java Servlet 過濾器：原理、生命週期與實戰應用

什麼是過濾器？ 過濾器是一個可插入 Web 應用程式的組件，
Java final 關鍵字深度解析：修飾類、方法、變量與引用的語義邊界 Java final 關鍵字深度解析：修飾類、方法、變量與引用的語義邊界

前言：final 不只是「不可變」 final 是 Java
Java 反射機制全景解析：Class 類操作、動態加載、運行時對象檢查、Method.invoke、泛型擦除與 Array 工具類實戰 Java 反射機制全景解析：Class 類操作、動態加載、運行時對象檢查、Method.invoke、泛型擦除與 Array 工具類實戰

Java 反射機制全景解析 反射是 Java 動態性的基石，
Spring IoC 實戰全攻略：XML 與註解裝配、Bean 生命周期、依賴注入、SpEL 表達式 Spring IoC 實戰全攻略：XML 與註解裝配、Bean 生命周期、依賴注入、SpEL 表達式

Spring IoC 實戰全攻略 Spring 以 IoC（
Java Properties 配置文件處理工具類：單例模式與 ResourceBundle 最佳實踐 工作中常見錯誤記錄：異步消息處理與事務回滾陷阱 Hibernate 事務與並發控制：ACID 特性、隔離級別與配置實戰 Eclipse 安裝 SVN 插件（Subclipse）完整圖文教程 Struts2 攔截器機制詳解：核心原理、默認攔截器棧與自定義登錄攔截實戰 Java NIO 缓存機制深度解析：Buffer 核心原理與操作實戰 Java 變量賦值與常量定義：final 關鍵字、輸入交互與友好提示實戰
欄目導航
  • Java 程式設計入門
  • Java 相關知識
  • J2EE
  • J2SE
  • J2ME
  • Java 綜合教學
    • Copyright © 程式碼之家 All Rights Reserved