使用SpringSide 3.1.4.3开发Web项目的全过程（上）

http://www.blogjava.net/youxia/archive/2009/07/19/287366.html

 

SpringSide 3.1.4.3是目前SpringSide的最新版本，也是完成度比较高的一个版本，用来做实际项目的开发应该丝毫不成问题。这里写一下使用该版本开发一个简单Web项目的全过程，当然，最重要的是我自己的一些心得体会。我的文章很长，只有耐下性子细看，才能体会个中三味。

第一步、下载SpringSide 3.1.4.3 all-in-one版。这个过程太简单了，SpringSide的官方网站是www.springside.org.cn，去那里就可以下载了，all-in-one版当然是懒人们的不二选择。这里有一点很搞笑，该版本标的是SpringSide 3.1.4.3，但是下载后解压缩，解压缩出来的文件是springside-3.1.4.2，这可能是江南白衣的一点小小的失误，据我猜测，3.1.4.3较3.1.4.1的进步应该是加入了jsp-api.jar这一个库，希望白衣这次不要为了更改这个版本号上的失误而再推出一个新版本，如果真要推出新版本，怎么样也应该把我最近研究出来的多数据库的配置加进去。

第二步、安装SpringSide。如果安装过SpringSide以前的版本，最好把用户目录下的.m2文件夹删掉，这个文件夹是Maven的本地仓库所在地，虽说Maven可以有效保证库文件不会发生版本冲突，但是删除这个文件夹会使安装过程加快，否则，SpringSide的安装过程会不停询问你是否覆盖某某文件。删除.m2文件夹后，运行springside-3.1.4.2目录下的bin目录中的quickstart.bat即可（前提条件是已经安装好了JDK5或以上版本，如果你的电脑中连JDK都没有，就别来趟SpringSide的浑水了）。 等待这个文件运行完，就可以看到SpringSide 3提供的三个示例项目mini-web、mini-service、showcase都运行起来了，这时你可以细细体会一下SpringSide实现的各种特性。

仔细察看SpringSide的bin目录，发现该版本提供的脚本更加明确和有用，如start-db.bat可以用来启动Derby数据库，start-selenium.bat用来启动selenium server，而start-tomcat.bat那就别说了，地球人都知道。

如果要想使用SpringSide来生成项目，还有一点点小工作要做，就是把Maven的bin目录加入到PATH环境变量中，如下图：


第三步，使用SpringSide生成项目。运行bin目录下的new-project.bat即可，如下图：


在创建项目的过程中，该脚本会提出一些问题，其中groupId指的是你的组织的名称，由于该项目由我私人贡献，纯属示范用，所以我填了youxia.personal，因此，在第5个问题上，我选择了personal.you作为我项目中的package的名字，这也是符合国际惯例的；artifactId指的是项目的名字，这里为MultiDatasourceExample，名字有点长，从名字就可以看出来我要示范多个数据源的配置。

第四步、启动Eclipse，导入项目。 生成的项目位于SpringSide目录下的tools\generator\generated-project目录下，下面是Eclipse的截图：


项目导入成功后，Eclispe资源管理器的截图：

 可以看到，该项目一经导入，立即可用，一个烦人的红叉都没有，这也正说明了该版本是SpringSide 3的一个革命性版本，从该版本开始，SpringSide 3的易用性提高了不止一个档次。

Eclipse推荐使用3.4及以上版本，因为在该版本中，对Tomcat服务器的管理更加方便，只需要在项目的快捷菜单中选择Run On Server，即可自动打开Tomcat服务器并部署项目，如下图：


这里有一点一定要注意，由于SpringSide生成的项目默认使用的是Derby数据库，所以要想成功运行项目，必须先启动Derby数据库，还记得前面提到的start-db.bat吗？运行它！然后运行该项目的bin目录下的init-db.jar，在数据库中放入该项目的初始化数据。

然后就可以点Run On Server来启动项目了，让大家见识一下Eclipse的嵌入式浏览器、Tomcat服务器视图、Console视图。真的是太方便了：


第五步、将数据库迁移到MySQL中。在项目中，创建数据库和初始化数据库的语句都是以SQL文件存在的，如下图：


但是该语句都是针对Derby的，如果要应用于MySQL，还必须得要做一些修改才行，先修改schema.sql，如下：

drop   table   if   exists  RESOURCES_AUTHORITIES;
drop   table   if   exists  ROLES_AUTHORITIES;
drop   table   if   exists  USERS_ROLES;
drop   table   if   exists  RESOURCES;
drop   table   if   exists  AUTHORITIES;
drop   table   if   exists  USERS;
drop   table   if   exists  ROLES;

create   table  USERS (
ID  integer   primary   key  auto_increment,
LOGIN_NAME  varchar ( 20 )  not   null   unique ,
PASSWORD  varchar ( 20 ),
NAME  varchar ( 20 ),
EMAIL  varchar ( 30 )
);

create   unique   index  USERS_LOGIN_NAME_INDEX  on  USERS(LOGIN_NAME);

create   table  ROLES (
ID  integer   primary   key  auto_increment,
NAME  varchar ( 20 )  not   null   unique
);

create   table  USERS_ROLES (
USER_ID   integer   not   null ,
ROLE_ID  integer   not   null ,
FOREIGN   KEY  (ROLE_ID)  references  ROLES(ID),
FOREIGN   KEY  ( USER_ID )  references  USERS(ID)
);

CREATE   TABLE  AUTHORITIES (
ID  integer   primary   key  auto_increment,
NAME  varchar ( 20 )  not   null ,
DISPLAY_NAME  varchar ( 20 )  not   null
);

create   table  ROLES_AUTHORITIES (
ROLE_ID  integer   not   null ,
AUTHORITY_ID  integer   not   null ,
FOREIGN   KEY  (ROLE_ID)  references  ROLES(ID),
FOREIGN   KEY  (AUTHORITY_ID)  references  AUTHORITIES(ID)
);

CREATE   TABLE  RESOURCES (
ID  integer   primary   key  auto_increment,
RESOURCE_TYPE  varchar ( 20 )  not   null ,
VALUE  varchar ( 255 )  not   null ,
ORDER_NUM  float   not   null
);

create   table  RESOURCES_AUTHORITIES (
AUTHORITY_ID  integer   not   null ,
RESOURCE_ID  integer   not   null ,
FOREIGN   KEY  (AUTHORITY_ID)  references  AUTHORITIES(ID),
FOREIGN   KEY  (RESOURCE_ID)  references  RESOURCES(ID)
);

该修改主要包含两个地方，一个是在drop table后面加上了if exists，一个是把GENERATED ALWAYS as IDENTITY修改为auto_increment。而load-data.sql不需要修改。

然后，启动MySQL，在MySQL中使用上面的两个sql文件创建数据库和添加初始化数据，如下图：


然后更改数据库连接，修改项目的application.properties文件，如下：

#jdbc settings
jdbc.url = jdbc:mysql://localhost: 3306 /MultiDatasourceExample?useUnicode = true&characterEncoding = utf8
jdbc.username = youxia
jdbc.password =******

#hibernate settings
hibernate.show_sql = false
hibernate.format_sql = false
hibernate.ehcache_config_file = /ehcache/ehcache-hibernate-local.xml

修改项目的applicationContext.xml文件，这里要修改两个地方，一个为DriverClassName，一个为hibernate.dilect，如下：

<? xml version="1.0" encoding="UTF-8" ?>
< beans  xmlns ="http://www.springframework.org/schema/beans"  xmlns:xsi ="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:jee ="http://www.springframework.org/schema/jee"  xmlns:tx ="http://www.springframework.org/schema/tx"
    xmlns:context ="http://www.springframework.org/schema/context"
    xsi:schemaLocation ="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.5.xsd http://www.springframework.org/schema/jee http://www.springframework.org/schema/jee/spring-jee-2.5.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-2.5.xsd"
    default-lazy-init ="true" >

     < description > Spring公共配置文件  </ description >

     <!--  定义受环境影响易变的变量  -->
     < bean  class ="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer" >
         < property  name ="systemPropertiesModeName"  value ="SYSTEM_PROPERTIES_MODE_OVERRIDE"   />
         < property  name ="ignoreResourceNotFound"  value ="true"   />
         < property  name ="locations" >
             < list >
                 <!--  标准配置  -->
                 < value > classpath*:/application.properties </ value >
                 <!--  本地开发环境配置  -->
                 < value > classpath*:/application.local.properties </ value >
                 <!--  服务器生产环境配置  -->
                 <!--  <value>file:/var/myapp/application.server.properties</value>  -->
             </ list >
         </ property >
     </ bean >

     <!--  使用annotation 自动注册bean,并保证@Required,@Autowired的属性被注入  -->
     < context:component-scan  base-package ="personal.youxia"   />

     <!--  数据源配置,使用应用内的DBCP数据库连接池  -->
     < bean  id ="dataSource"  class ="org.apache.commons.dbcp.BasicDataSource"  destroy-method ="close" >
         <!--  Connection Info  -->
         < property  name ="driverClassName"  value ="com.mysql.jdbc.Driver"   />
         < property  name ="url"  value ="${jdbc.url}"   />
         < property  name ="username"  value ="${jdbc.username}"   />
         < property  name ="password"  value ="${jdbc.password}"   />

         <!--  Connection Pooling Info  -->
         < property  name ="initialSize"  value ="5"   />
         < property  name ="maxActive"  value ="100"   />
         < property  name ="maxIdle"  value ="30"   />
         < property  name ="maxWait"  value ="1000"   />
         < property  name ="poolPreparedStatements"  value ="true"   />
         < property  name ="defaultAutoCommit"  value ="false"   />
     </ bean >

     <!--  数据源配置,使用应用服务器的数据库连接池  -->
     <!-- <jee:jndi-lookup id="dataSource" jndi-name="java:comp/env/jdbc/ExampleDB" /> -->

     <!--  Hibernate配置  -->
     < bean  id ="sessionFactory"  class ="org.springframework.orm.hibernate3.annotation.AnnotationSessionFactoryBean" >
         < property  name ="dataSource"  ref ="dataSource"   />
         < property  name ="namingStrategy" >
             < bean  class ="org.hibernate.cfg.ImprovedNamingStrategy"   />
         </ property >
         < property  name ="hibernateProperties" >
             < props >
                 < prop  key ="hibernate.dialect" > org.hibernate.dialect.MySQL5InnoDBDialect </ prop >
                 < prop  key ="hibernate.show_sql" > ${hibernate.show_sql} </ prop >
                 < prop  key ="hibernate.format_sql" > ${hibernate.format_sql} </ prop >
                 < prop  key ="hibernate.cache.provider_class" > org.hibernate.cache.EhCacheProvider
                 </ prop >
                 < prop  key ="hibernate.cache.provider_configuration_file_resource_path" > ${hibernate.ehcache_config_file} </ prop >
             </ props >
         </ property >
         < property  name ="packagesToScan"  value ="personal.youxia.entity.*"   />
     </ bean >

     <!--  事务管理器配置,单数据源事务  -->
     < bean  id ="transactionManager"  class ="org.springframework.orm.hibernate3.HibernateTransactionManager" >
         < property  name ="sessionFactory"  ref ="sessionFactory"   />
     </ bean >

     <!--  事务管理器配置,多数据源JTA事务 -->
     <!--
        <bean id="transactionManager" class="org.springframework.transaction.jta.JtaTransactionManager or
        WebLogicJtaTransactionManager" />
     -->

     <!--  使用annotation定义事务  -->
     < tx:annotation-driven  transaction-manager ="transactionManager"   />
</ beans >

由于SpringSide不提供Mysql的jdbc驱动，所以需要自己去MySQL的官方网站下载，将下载到的mysql-connector-5.*.jar复制到项目的WEB-INF中的lib目录中。然后运行项目，成功。至此，成功将项目迁移到MySQL中。

第六步、添加数据表、编写Entity类、编写Dao类、Manager类，并进行单元测试。还是以前几篇文章中提到的文章发布系统为例，每一篇文章对应多篇评论，所以说据库中需创建articles和comments两个数据表，如下：

create     table   articles(
id   int     primary     key   auto_increment,
subject   varchar  (  20  )   not     null  ,
content   text  );

create     table   comments(
id   int     primary     key   auto_increment,
content   varchar  (  255  ),
article_id   int     not     null  ,
foreign     key   (article_id)   references   articles(id)
);

在编写Java代码之前，我还要做一点小工作，什么工作呢？那就是要为我自己的项目创建一个单独的源文件夹，因为src\main\java这个文件夹已经被江南白衣放入了太多的package，而且因为涉及到security，所以层次也不明显，操作起来不方便，找起代码来也不够快。下面是我创建了自己的源文件夹后的截图：

在我自己的源文件夹中，只创建了四个package，刚好代表从底到上的四个层次，这样，找起代码来要方便得多。

先来Entity层，Article.java的代码如下：

package  personal.youxia.entity;

import  java.util.LinkedHashSet;
import  java.util.Set;

import  javax.persistence.CascadeType;
import  javax.persistence.Entity;
import  javax.persistence.JoinColumn;
import  javax.persistence.OneToMany;
import  javax.persistence.OrderBy;
import  javax.persistence.Table;

import  org.hibernate.annotations.Cache;
import  org.hibernate.annotations.CacheConcurrencyStrategy;
import  org.hibernate.annotations.Fetch;
import  org.hibernate.annotations.FetchMode;

@Entity
//  表名与类名不相同时重新定义表名.
@Table(name  =   " articles " )
//  默认的缓存策略.
@Cache(usage  =  CacheConcurrencyStrategy.READ_WRITE)
public   class  Article  extends  IdEntity  {
    private String subject;
    private String content;
    private Set<Comment> comments = new LinkedHashSet<Comment>();

    public String getSubject() {
        return subject;
    }

    public void setSubject(String subject) {
        this.subject = subject;
    }

    public String getContent() {
        return content;
    }

    public void setContent(String content) {
        this.content =