Struts2 - Spring - Hibernate 整合简单样例
初学 Struts2，在整合 Spring 和 Hibernate 时遇到一些麻烦，下面以一个简单样例说明操作过程，以备不时只需。如有不当之处，望不吝赐教。
开发环境：
MyEclipse 6.5
Struts 2.1.8.1
Spring 2.5
Hibernate 3.2
Tomcat 6.0
MySQL 5.1
1. 新建 web 项目
新建 Java EE 5.0 的 web project
2. 项目配置
2.1 配置文件目录
在 src 下新建 config 文件夹，并在该文件夹下新建三个文件夹，分别是：hibernate，spring 和 struts2，这三个文件夹分别用于放置 hibernate，spring 和 struts2 的配置文件，以便统一管理。
2.2 JAR 包目录
在项目根目录下新建文件夹 lib，并在该文件夹下新建三个文件夹，分别是：hibernate，spring 和 struts2，这三个文件夹分别用于放置 hibernate，spring 和 struts2 的 JAR 文件，以便统一管理。
说明：上边的配置纯属个人偏好或者习惯。
3. 添加 Struts2 的支持
将 struts2 所需的基础包以及 struts-spring-plugin 包复制到 lib/struts2 文件夹下，并将这些 JAR 包添加到项目的 classpath。如下图所示。
4. 添加 Spring 支持
右键项目 --> MyEclipse --> Add Spring Capabilities...，选中一下四组 spring 类库：
Spring 2.5 AOP Libraries，
Spring 2.5 Core Libraries，
Spring 2.5 Persistence Core Libraries，
Spring 2.5 Persistence JDBC Libraries
并将 JAR 文件复制到 lib/spring 目录下，同时选中创建 applicationContext.xml 文件，并将其存放至 src/config/spring 目录下。如下两图所示。
5. 添加 Hibernate 支持
右键项目 --> MyEclipse --> Add Hibernate Capabilities...，选中如下图所示的四组类库，同时将 JAR 文件复制到 lib/hibernate 目录下，如下四图所示，一步一步 Next 即可，最后一步时选择不创建 SessionFactory。
6. JAR 包的整理
6.1 添加其他所需的 JAR 包
复制 mysql jdbc 驱动包到 lib/hibernate 目录下，
复制 spring-web.jar 包到 lib/spring 目录下，
将 lib/struts2，lib/hibernate，lib/spring 所有尚未添加到 classpath 的 JAR 包全部添加到项目的 classpath
6.2 移除有冲突的 JAR 包
在完成了上述操作后，需要检查所有的 JAR 包是否有冲突。比如在样例中，添加 struts2 JAR 包时有 commons-logging-1.0.4，而添加 spring JAR 包时有 commons-logging.jar，这两个 JAR 包由可能会有冲突，需要将其中一个从 classpath 中删除。
注意：这里需要特别注意的是，在 hibernate 中有 cglib-2.1.3.jar，而 spring 中有 cglib-nodep-2.1_3.jar，这两者也是有冲突的，需要将前者从 classpath 中删除，否则在启动系统时会出现下面的错误：
java.lang.NoClassDefFoundError: org/objectweb/asm/CodeVisitor
Caused by: java.lang.NoClassDefFoundError: org/objectweb/asm/CodeVisitor
7. 配置 web.xml
在该文件中添加如下配置
<listener>
<listener-class>
org.springframework.web.context.ContextLoaderListener
</listener-class>
</listener>
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/classes/config/spring/applicationContext.xml</param-value>
</context-param>
<filter>
<filter-name>struts2</filter-name>
<filter-class>
org.apache.struts2.dispatcher.FilterDispatcher
</filter-class>
<init-param>
<param-name>config</param-name>
<param-value>
struts-default.xml,
struts-plugin.xml,
../classes/config/struts2/struts.xml
</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>struts2</filter-name>
<url-pattern>*.action</url-pattern>
</filter-mapping>
8. 部署运行
此时可将系统部署到服务器并启动，查看是否有错，如果没有，可继续下面的操作。
9. 创建数据表
CREATE TABLE `person` (
`PERSONID` int(11) NOT NULL AUTO_INCREMENT,
`AGE` smallint(6) DEFAULT NULL,
`BIRTHDAY` datetime DEFAULT NULL,
`GENDER` varchar(2) DEFAULT NULL,
`NAME` varchar(32) NOT NULL,
PRIMARY KEY (`PERSONID`)
)
10. Java 类及接口编辑
10.1 Bean
/***********************************************************************
* <p>Project Name: javaee</p>
* <p>File Name: com.thu.afa.javaee.bean.Person.java</p>
* <p>Copyright: Copyright (c) 2010</p>
* <p>Company: <a href="http://afa.thu.com">http://afa.thu.com</a></p>
***********************************************************************/
package com.thu.afa.javaee.bean;
import java.io.Serializable;
import java.util.Date;
/**
* <p>Class Name: Person</p>
* <p>Description: </p>
* @author Afa
* @date Aug 2, 2010
* @version 1.0
*/
public class Person implements Serializable
{
private static final long serialVersionUID = 7076823139969113432L;
private Integer personID;
private String name;
private String gender;
private Short age;
private Date birthday;
public Integer getPersonID()
{
return personID;
}
public void setPersonID(Integer personID)
{
this.personID = personID;
}
public String getName()
{
return name;
}
public void setName(String name)
{
this.name = name;
}
public String getGender()
{
return gender;
}
public void setGender(String gender)
{
this.gender = gender;
}
public Short getAge()
{
return age;
}
public void setAge(Short age)
{
this.age = age;
}
public Date getBirthday()
{
return birthday;
}
public void setBirthday(Date birthday)
{
this.birthday = birthday;
}
}
10.2 Dao Interface
/***********************************************************************
* <p>Project Name: javaee</p>
* <p>File Name: com.thu.afa.javaee.dao.PersonDao.java</p>
* <p>Copyright: Copyright (c) 2010</p>
* <p>Company: <a href="http://afa.thu.com">http://afa.thu.com</a></p>
***********************************************************************/
package com.thu.afa.javaee.dao;
import com.thu.afa.javaee.bean.Person;
/**
* <p>Class Name: PersonDao</p>
* <p>Description: </p>
* @author Afa
* @date Aug 2, 2010
* @version 1.0
*/
public interface PersonDao
{
public boolean addPerson(Person person);
}
10.3 Dao Implementation
/***********************************************************************
* <p>Project Name: javaee</p>
* <p>File Name: com.thu.afa.javaee.dao.impl.PersonDaoImpl.java</p>
* <p>Copyright: Copyright (c) 2010</p>
* <p>Company: <a href="http://afa.thu.com">http://afa.thu.com</a></p>
***********************************************************************/
package com.thu.afa.javaee.dao.impl;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.springframework.orm.hibernate3.support.HibernateDaoSupport;
import com.thu.afa.javaee.bean.Person;
import com.thu.afa.javaee.dao.PersonDao;
/**
* <p>Class Name: PersonDaoImpl</p>
* <p>Description: </p>
* @author Afa
* @date Aug 2, 2010
* @version 1.0
*/
public class PersonDaoImpl extends HibernateDaoSupport implements PersonDao
{
private static final Log log = LogFactory.getLog(PersonDaoImpl.class);
/* (non-Javadoc)
* <p>Title: </p>
* <p>Method Name: addPerson</p>
* <p>Description: </p>
* @author: Afa
* @date: Aug 2, 2010
* @see com.thu.afa.javaee.dao.PersonDao#addPerson(com.thu.afa.javaee.bean.Person)
*
* @param person
* @return
*/
public boolean addPerson(Person person)
{
boolean result = false;
try
{
getHibernateTemplate().save(person);
result = true;
} catch (Exception e)
{
log.error("Add Person Error.", e);
result = false;
}
return result;
}
}
10.4 Service Interface
/***********************************************************************
* <p>Project Name: javaee</p>
* <p>File Name: com.thu.afa.javaee.service.PersonService.java</p>
* <p>Copyright: Copyright (c) 2010</p>
* <p>Company: <a href="http://afa.thu.com">http://afa.thu.com</a></p>
***********************************************************************/
package com.thu.afa.javaee.service;
import com.thu.afa.javaee.bean.Person;
/**
* <p>Class Name: PersonService</p>
* <p>Description: </p>
* @author Afa
* @date Aug 2, 2010
* @version 1.0
*/
public interface PersonService
{
public boolean addPerson(Person person);
}
10.5 Service Implementation
/***********************************************************************
* <p>Project Name: javaee</p>
* <p>File Name: com.thu.afa.javaee.service.impl.PersonServiceImpl.java</p>
* <p>Copyright: Copyright (c) 2010</p>
* <p>Company: <a href="http://afa.thu.com">http://afa.thu.com</a></p>
***********************************************************************/
package com.thu.afa.javaee.service.impl;
import com.thu.afa.javaee.bean.Person;
import com.thu.afa.javaee.dao.PersonDao;
import com.thu.afa.javaee.service.PersonService;
/**
* <p>Class Name: PersonServiceImpl</p>
* <p>Description: </p>
* @author Afa
* @date Aug 2, 2010
* @version 1.0
*/
public class PersonServiceImpl implements PersonService
{
private PersonDao personDao;
public PersonDao getPersonDao()
{
return personDao;
}
public void setPersonDao(PersonDao personDao)
{
this.personDao = personDao;
}
/* (non-Javadoc)
* <p>Title: </p>
* <p>Method Name: addPerson</p>
* <p>Description: </p>
* @author: Afa
* @date: Aug 2, 2010
* @see com.thu.afa.javaee.service.PersonService#addPerson(com.thu.afa.javaee.bean.Person)
*
* @param person
* @return
*/
public boolean addPerson(Person person)
{
return personDao.addPerson(person);
}
}
10.6 Action
/***********************************************************************
* <p>Project Name: javaee</p>
* <p>File Name: com.thu.afa.javaee.action.PersonAction.java</p>
* <p>Copyright: Copyright (c) 2010</p>
* <p>Company: <a href="http://afa.thu.com">http://afa.thu.com</a></p>
***********************************************************************/
package com.thu.afa.javaee.action;
import com.opensymphony.xwork2.ActionSupport;
import com.thu.afa.javaee.bean.Person;
import com.thu.afa.javaee.service.PersonService;
/**
* <p>Class Name: PersonAction</p>
* <p>Description: </p>
* @author Afa
* @date Aug 2, 2010
* @version 1.0
*/
public class PersonAction extends ActionSupport
{
private static final long serialVersionUID = 7777882541300788683L;
private Person person;
private PersonService personService;
public Person getPerson()
{
return person;
}
public void setPerson(Person person)
{
this.person = person;
}
public PersonService getPersonService()
{
return personService;
}
public void setPersonService(PersonService personService)
{
this.personService = personService;
}
@Override
public String execute() throws Exception
{
return personService.addPerson(person) ? SUCCESS : ERROR;
}
}
11. 配置文件的编辑
11.1 Hibernate hbm File
将该文件存放至 src/config/hibernate 目录下。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-mapping PUBLIC
"-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<hibernate-mapping>
<class name="com.thu.afa.javaee.bean.Person" table="Person">
<id name="personID">
<column name="PERSONID"></column>
<generator class="native"></generator>
</id>
<property name="name" column="NAME" type="java.lang.String" length="32" />
<property name="gender" column="GENDER" type="java.lang.String" length="2" />
<property name="age" column="AGE" type="java.lang.Short" />
<property name="birthday" column="BIRTHDAY" type="java.util.Date" />
</class>
</hibernate-mapping>
11.2 struts.xml
将该文件存放至 src/config/struts2 目录下。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN"
"http://struts.apache.org/dtds/struts-2.1.7.dtd">
<struts>
<package name="com.thu.afa.javaee" extends="struts-default">
<action name="addPerson" class="personAction">
<result name="success">/result.jsp</result>
<result name="error">/error.jsp</result>
</action>
</package>
</struts>
11.3 applicationContext.xml
在 sessionFactory 节点添加如下属性：
<property name="mappingResources">
<list><value>config/hibernate/person.hbm.xml</value>
</list>
</property>事务以及 AOP 的配置
文件头：
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:aop="http://www.springframework.org/schema/aop"
xmlns:tx="http://www.springframework.org/schema/tx"
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.0.xsd
http://www.springframework.org/schema/aop
http://www.springframework.org/schema/aop/spring-aop-2.0.xsd">
<bean id="transactionManager" class="org.springframework.orm.hibernate3.HibernateTransactionManager"> <property name="sessionFactory"> <ref bean="sessionFactory" /> </property> </bean> <tx:advice id="txAdvice" transaction-manager="transactionManager"> <tx:attributes> <tx:method name="add*" propagation="REQUIRED" /> <tx:method name="delete*" propagation="REQUIRED" /> <tx:method name="update*" propagation="REQUIRED" /> <tx:method name="*" read-only="true" /> </tx:attributes> </tx:advice> <aop:config> <aop:pointcut id="businessService" expression="execution(* com.thu.afa.javaee.service.impl.*.*(..))" /> <aop:advisor advice-ref="txAdvice" pointcut-ref="businessService" /> </aop:config>
其余 bean 的定义：
<bean id="personDao" class="com.thu.afa.javaee.dao.impl.PersonDaoImpl"> <property name="sessionFactory"> <ref bean="sessionFactory" /> </property> </bean> <bean id="personService" class="com.thu.afa.javaee.service.impl.PersonServiceImpl"> <property name="personDao"> <ref bean="personDao" /> </property> </bean> <bean id="personAction" class="com.thu.afa.javaee.action.PersonAction"> <property name="personService"> <ref bean="personService" /> </property> </bean>
12. JSP 页面
12.1 index.jsp
<body>
<form action="addPerson.action" method="post">
Username: <input type="text" id="person.name" name="person.name" /><br />
Gender: <input type="text" id="person.gender" name="person.gender" /><br />
Age: <input type="text" id="person.age" name="person.age" /><br />
Birthday: <input type="text" id="person.birthday" name="person.birthday" /><br />
<input type="submit" value="Submit" />
</form>
</body>
12.2 result.jsp
<body>
Welcome
</body>
12.3 error.jsp
<body>
Error.
</body>
13. 部署运行
到此，整合过程已基本完成，可部署运行了。项目的整体文件结构如下图所示。
由于担心篇幅过长，所以将相关配置的具体说明写在下面的评论中。
-----------------------------------------------------
Stay Hungry, Stay Foolish!
Afa
Aug 3rd, 2010
-----------------------------------------------------