SpringSide 實戰（二）：資料庫遷移、字元編碼統一與極速部署技巧

SpringSide 預設使用 HSQLDB，實務上多遷往 MySQL。以 xkland 專案為例，遷移步驟只需修改兩個設定檔：

一、資料庫遷移三步走

1. 修改 jdbc.properties

啟用 MySQL 驅動與連線字串，設定帳號密碼：

#jdbc.driverClassName=org.hsqldb.jdbcDriver
#jdbc.url=jdbc:hsqldb:res:/hsqldb/helloworld

jdbc.driverClassName=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/xkland?useUnicode=true&characterEncoding=utf8

jdbc.username=xkland
jdbc.password=xkland

2. 修改 hibernate.properties

切換方言至 MySQL：

#hibernate.dialect=org.hibernate.dialect.HSQLDialect
hibernate.dialect=org.hibernate.dialect.MySQL5Dialect
#hibernate.dialect=org.hibernate.dialect.Oracle9Dialect
hibernate.show_sql=false
hibernate.cache.use_query_cache=true
hibernate.cache.provider_class=org.hibernate.cache.EhCacheProvider

3. 補齊驅動 Jar 包

將 mysql-connector-java.jar 放入 src/main/webapp/WEB-INF/lib，否則啟動會報 ClassNotFoundException。

二、字元編碼四大金鑰：全鏈路 UTF-8

SpringSide 內建 CharacterEncodingFilter，但仍需四處同步設定：

1. web.xml：<param-value>UTF-8</param-value>
2. 資料庫建表：DEFAULT CHARSET=utf8
3. JDBC URL：characterEncoding=utf8
4. JSP 頁面：<%@ page contentType="text/html; charset=utf-8" %> + <meta charset="utf-8">

四處一致，亂碼無從產生。

三、國際化資源檔：告別難讀的 Unicode 轉義

messages_zh_CN.properties 須存為 \uXXXX 格式，直接編輯極不友善。善用 JDK native2ascii 工具：

native2ascii -encoding utf-8 src/main/resources/i18n/temp.txt \
  src/main/resources/i18n/messages_zh_CN.properties

編寫 make_resource.bat 並註冊為 Eclipse 外部工具，修改 temp.txt 後一鍵生成，效率倍增。

四、極速部署：拒絕重建專案、拒絕殭屍進程

官方 quickstart.bat 痛點：每次全量構建太慢；關閉視窗 Tomcat 仍在後台跑，二次啟動報錯。

解決方案：拆解為三個外部工具

1. start_tomcat：指向 tomcat/bin/startup.bat
2. stop_tomcat：指向 tomcat/bin/shutdown.bat
3. deploy：使用 xcopy /d /y /s 僅同步變更檔案

xcopy src/main/webapp/*.jsp  %TOMCAT_HOME%/webapps/xkland /d /y
xcopy bin/*.*                 %TOMCAT_HOME%/webapps/xkland/WEB-INF/classes /s /d /y
xcopy src/main/resources/*.*  %TOMCAT_HOME%/webapps/xkland/WEB-INF/classes /s /d /y
xcopy src/main/webapp/WEB-INF/*.xml %TOMCAT_HOME%/webapps/xkland/WEB-INF /d /y

工作流

修改 JSP/資源/Class → 執行 deploy → 瀏覽器刷新即見效；改 Struts 設定/Action 類 → stop_tomcat → deploy → start_tomcat。秒級迭代，告別漫長等待。