CleanBlog：基於 SSM 框架的極簡個人部落格系統實戰與源碼解析

CleanBlog 專案簡介

CleanBlog 是一個採用 SSM（Spring + SpringMVC + MyBatis） 技術棧構建的輕量級個人部落格系統。專案特點是架構清晰、介面簡潔（基於 Bootstrap 與 Clean Blog 模板）、功能聚焦（撰寫、閱讀、留言），非常適合 Java Web 初學者作為實戰入門專案，也可作為個人技術部落格的快速原型。

系統架構概覽

• 前端：Bootstrap 響應式佈局，UEditor 富文本編輯器。
• 控制層：SpringMVC 處理請求分發、視圖渲染。
• 業務層：Spring 管理 Bean 生命週期與事務。
• 持久層：MyBatis 進行資料庫 CRUD 操作。
• 資料庫：MySQL，僅兩張核心表（blog、message）。

核心資料表設計

-- 部落格文章表
CREATE TABLE blog (
    id INT NOT NULL PRIMARY KEY AUTO_INCREMENT,
    title VARCHAR(128) NOT NULL,
    text TEXT,
    preview VARCHAR(128),
    author VARCHAR(32),
    category VARCHAR(32),
    date TIMESTAMP DEFAULT '2016-05-20 00:00:00'
);

-- 留言板表
CREATE TABLE message (
    id INT NOT NULL PRIMARY KEY AUTO_INCREMENT,
    author VARCHAR(32),
    content TEXT,
    date TIMESTAMP DEFAULT '2016-05-20 00:00:00'
);

關鍵程式碼結構

DAO 層

位於 com.luoxn28.blog.dao，包含 BlogDao、MessageDao 及對應的 Mapper XML 檔案，封裝 SQL 映射邏輯。

Controller 層

位於 com.luoxn28.blog.controller，核心控制器包括：

• IndexController：首頁請求處理，彙總文章與留言列表。
• BlogController：文章詳情展示。
• PostController：線上撰寫/發布文章。
• MessageController：留言板功能。

IndexController 範例：

@Controller
@RequestMapping
public class Index {
    @Autowired private BlogDao blogDao;
    @Autowired private MessageDao messageDao;

    @RequestMapping({"/index", "/"})
    public String index(Map<String, Object> map) {
        map.put("blogs", blogDao.getAll());
        map.put("messages", messageDao.getAll());
        return "index";
    }
}

專案部署與運行

1. 從 GitHub 克隆專案：https://github.com/luoxn28/CleanBlog
2. 在 IDEA 中建立 Java EE Web 專案，導入源碼。
3. 於 src 目錄下建立 db.properties，配置資料庫連線資訊（含編碼參數防止中文亂碼）。
4. 執行 db.sql 初始化資料庫結構。
5. 編譯部署至 Tomcat，訪問 https://localhost:8080/ 即可看到首頁。

線上體驗與源碼獲取

• 線上演示：https://luoxn28.xyz:8080/
• 源碼倉庫：GitHub - luoxn28/CleanBlog（歡迎 Star）

CleanBlog 雖功能精簡，但「麻雀雖小，五臟俱全」，是理解 SSM 整合開發全流程的優質教學案例。