SpringSide开发实战（二）：修改数据库、字符编码和快速部署应用程序

SpringSide默认的数据库是hsql，但是大部分开发人员熟悉的数据库是MySql，因此在实际开发过程中，遇到的第一件事往往是修改数据库。在SpringSide中修改数据库很简单，还是以前一篇中创建的xkland项目为例，首先修改src/main/resources/config文件夹下的jdbc.properties文件，注释掉1、2行，解注释7、8行，并修改10、11行的用户名和密码，如下：

 1 #jdbc.driverClassName = org.hsqldb.jdbcDriver
 2 #jdbc.url = jdbc:hsqldb:res:/hsqldb/helloworld
 3
 4 #jdbc.driverClassName = oracle.jdbc.driver.OracleDriver
 5 #jdbc.url = jdbc:oracle:thin:@localhost:helloworld 
 6
 7 jdbc.driverClassName = com.mysql.jdbc.Driver
 8 jdbc.url = jdbc:mysql://localhost: 3306 /xkland?useUnicode = true&characterEncoding = utf8
 9
10 jdbc.username = xkland
11 jdbc.password = xkland

其次是修改src/main/resources/config文件夹下的hibernate.properties文件，注释掉第一行，解注释第二行，如下：

1 #hibernate.dialect = org.hibernate.dialect.HSQLDialect
2 hibernate.dialect = org.hibernate.dialect.MySQL5Dialect
3 #hibernate.dialect = org.hibernate.dialect.Oracle9Dialect
4 hibernate.show_sql = false
5 hibernate.cache.use_query_cache = true
6 hibernate.cache.provider_class = org.hibernate.cache.EhCacheProvider

这个过程是简单的，但是还有一件很重要的事情需要注意，那就是一定要记得把MySQL提供的JDBC驱动mysql.jar拷贝到src/main/webapp/WEB-INF/lib文件夹下，否则，会遇到如下错误：


SpringSide非常注重对i18n的支持，因此创建国际化的应用程序非常方便，只需要在src/mian/resources/i18n文件夹下加入相应的资源文件即可。SpringSide默认使用UTF-8编码，这从web.xml中注册的encodingFilter就可以看出来，当然也可以选择自己喜欢的字符编码，比如GB2312。如果要修改字符编码，一定要记住有四个地方要保持一致：
1、web.xml中的encodingFilter配置，如下：

< 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 >  
</ filter >   

2、数据库中的默认字符集，需要在创建数据表的时候指定，如下：

CREATE   TABLE  ` user ` (
  `id`  int ( 11 )  NOT   NULL  auto_increment,
  `username`  varchar ( 20 ),
  `password`  char ( 32 ), 
   PRIMARY   KEY   (`id`)
) ENGINE = InnoDB  DEFAULT  CHARSET = utf8

3、JDBC的连接设置，在src/main/resources/config/jdbc.properties中，如下：

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

4、JSP页面中的页面编码，如下：

<% @ page contentType="text/html; charset=utf-8"  %>

< meta  http-equiv ="Content-Type"  content ="text/html; charset=utf-8"   />

只要将这四个地方设置为一致，JSP页面显示出来就应该不会是乱码。归根结底，是SpringSide在web.xml中注册的encodingFilter帮了大忙。但是，当需要从Struts的resource bundle中读取message的时候，就不是那么方便了，因为需要创建如下的messages_zh_CN.properties文件：

# -- direct output message --
message = { 0 }

# -- crud message
entity.saved = /u6210/u529f/u4fdd/u5b58/u3002
entity.missing = /u627e/u4e0d/u5230/u6b64ID/u7684/u5bf9/u8c61/u3002
entity.deleted = /u6210/u529f/u5220/u9664/u3002

# -- validator errors --
errors.required = { 0 } /u4e3a/u5fc5/u586b/u9879/u3002
errors.maxlength = { 0 } /u4e0d/u80fd/u5927/u4e8e { 1 } /u4e2a/u5b57/u7b26/u3002
errors.minlength = { 0 } /u4e0d/u80fd/u5c11/u4e8e { 1 } /u4e2a/u5b57/u7b26/u3002
errors.invalid = { 0 } /u65e0/u6548/u3002

errors.byte = { 0 } /u5fc5/u987b/u4e3abyte/u7c7b/u578b/u3002
errors.double = { 0 } /u5fc5/u987b/u4e3adouble/u7c7b/u578b/u3002
errors.float = { 0 } /u5fc5/u987b/u4e3afloat/u7c7b/u578b/u3002
errors.integer = { 0 } /u5fc5/u987b/u4e3a/u4e00/u6570/u503c/u3002
errors.long = { 0 } /u5fc5/u987b/u4e3along/u7c7b/u578b/u3002
errors.short = { 0 } /u5fc5/u987b/u4e3ashort/u7c7b/u578b/u3002

errors.date = { 0 } /u4e0d/u662f/u6709/u6548/u65e5/u671f/u683c/u5f0f/u3002
errors.range = { 0 } /u672a/u5728 { 1 } /u4e0e { 2 } /u8303/u56f4/u5185/u3002
errors.creditcard = { 0 } /u4e3a/u65e0/u6548/u4fe1/u7528/u5361/u53f7/u3002
errors.email = { 0 } /u4e3a/u65e0/u6548/u90ae/u4ef6/u5730/u5740/u3002
errors.phone = { 0 } /u4e3a/u65e0/u6548/u7535/u8bdd/u53f7/u7801/u3002
errors.zip = { 0 } /u4e3a/u65e0/u6548/u90ae/u653f/u7f16/u7801/u3002

hello = /u4f60/u597d/uff0cSpringSide!

这种文件没有可读性，当然就更加不好编辑了，要生成这样的文件，需要使用J2SDK提供的命令行工具native2ascii.exe，为了加速开发和调试，可以编写一个批处理文件make_resource.bat，如下：

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

然后，将该批处理文件注册为Eclipse的外部工具，如下图：


以后，需要修改messages的时候，先在temp.txt中修改，然后运行该外部工具即可。快捷而方便。

没有人能够一气呵成写完一个项目然后再运行，所有的程序员都需要一边修改代码，一边运行程序以观察修改的效果，如此反复进行。但是SpringSide提供的quickstart.bat存在很多问题，造成了程序员不能够快速部署程序，原因有二，一是quickstart.bat每次运行的时候都需要重新构建项目，更新组件库，然后启动Tomcat服务器，太慢了；二是运行quickstart.bat后，就算关闭控制台窗口，Tomcat服务器依然会在后台运行，以至于下次运行quickstart.bat会出错，提示不能清理文件。

要解决这两个问题也不难，可以将springside根目录下的misc/servers/tomcat-5.5.17/bin目录下的startup.bat和shutdown.bat注册为Eclispe的外部工具，以达到快速启动和快速关闭Tomcat服务器的目的，如下图：




此外，很多时候不需要重新启动服务器，只需要把更改过的文件重新部署到服务器就可以了，在springside的根目录目录下面，misc/servers/tomcat-5.5.17/webapps文件夹中包含了所有的SpringSide项目。使用Windows自带的命令行工具xcopy，可以将修改过的.class文件、配置文件、资源文件和.jsp文件部署到服务器中。创建一个批处理文件deploy.bat，如下：

xcopy src/main/webapp/*.jsp E:/springside- 2.0 /misc/servers/tomcat- 5.5.17 /webapps/xkland /d /y
xcopy bin/*.* E:/springside- 2.0 /misc/servers/tomcat- 5.5.17 /webapps/xkland/WEB-INF/classes /s /d /y
xcopy src/main/resources/*.* E:/springside- 2.0 /misc/servers/tomcat- 5.5.17 /webapps/xkland/WEB-INF/classes /s /d /y
xcopy src/main/webapp/WEB-INF/*.xml E:/springside- 2.0 /misc/servers/tomcat- 5.5.17 /webapps/xkland/WEB-INF /d /y

其中/s选项为复制子目录,/d选项为只复制更新过的文件，/y选项为不用询问是否覆盖。

然后再将该deploy.bat注册为Eclipse的外部工具。这里不截图了，累赘。

当修改了Struts的配置文件和Action类之后，由于Struts只在Tomcat启动时读取一次配置文件并缓存起来，而Action对象也只在第一次使用的时候创建一个实例，因此必须重新启动服务器才能看到效果，配合上面的deploy、stop_tomcat和start_tomcat外部工具使用，使得部署和调试SpringSide应用程序更加快捷。