1. 准备
工具:MyEclipse 5.1.0 GA、Tomcat 5.5
环境:Struts1.1、Spring1.2、Hibernate3.1、sqlserver2000
1.1. 新建工程
本范例使用最简单的登录模块来实践SSH的开发,旨在体会和入门SSH技术的整合
操作:[Menu] File/New/Web Project
工程名:login
2. Struts 部分
2.1. 添加 Struts 功能支持
操作:[Menu] MyEclipse/Project Capabilities/Add Struts Capabilities
修改web.xml
<jsp-config> <taglib> <taglib-uri>/WEB-INF/struts-html</taglib-uri> <taglib-location>/WEB-INF/struts-html.tld</taglib-location> </taglib> </jsp-config> |
分别创建index.jsp、login.jsp、success.jsp先不对jsp页面做任何修改
2.2. 创建 ActionForm 类
操作:[Ctrl+N] MyEclipse/Web-Struts/Struts 1.1 Form
类名:LoginForm
在 "Form Properties" 选项卡为 loginForm 新增两个属性:username、password;
2.3. 创建 Action 类
类名:LoginAction
在 "Form" 选项卡的 "Name" 项选择 "loginForm","Input Source" 项输入 "/login.jsp"。
在Forwards中创建两个forward对象
success登录成功,跳转到success.jsp fail登录失败,跳转到login.jsp重新登录
此时struts-config.xml代码如下
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE struts-config PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 1.1//EN" "http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd">
<struts-config> <data-sources /> <form-beans> <form-bean name="loginForm" type="struts.form.LoginForm"></form-bean> </form-beans> <global-exceptions /> <global-forwards /> <action-mappings> <action path="/login" input="/login.jsp" name="loginForm" type="struts.action.LoginAction"> <forward name="success" path="/success.jsp"></forward> <forward name="fail" path="/login.jsp"></forward> </action> </action-mappings> <message-resources parameter="ApplicationResources" /> </struts-config> |
2.4. 修改jsp 文件
index.jsp代码
<%@ page language="java" pageEncoding="UTF-8"%> <%@ taglib uri="/WEB-INF/struts-html" prefix="html" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html:html locale="true"> <head> <html:base /> </head> <body> <html:form action="login" method="post" focus="username"> <table border="0"> <tr> <td>Name:</td> <td><html:text property="username" /></td> </tr> <tr> <td>Password:</td> <td><html:password property="password" /></td> </tr> <tr> <td colspan="2" align="center"><html:submit /></td> </tr> </table> </html:form> </body> </html:html> |
login.jsp代码(其它代码相同)
<body> <html:errors/> <html:form action="login" method="post" focus="username"> <table border="0"> <tr> <td>Name:</td> <td><html:text property="username" /></td> </tr> <tr> <td>Password:</td> <td><html:password property="password" /></td> </tr> <tr> <td colspan="2" align="center"><html:submit /></td> </tr> </table> </html:form> </body> |
success.jsp代码
<body> <h2>welcome!!!</h2> </body> |
2.5. 修改资源文件
ApplicationResources.properties文件如下
# Resources for parameter 'ApplicationResources' # Project login errors.header= <h3><font color="red">Validation Error</font></h3><ul> errors.footer= </ul><hr> error.name.required= <li>"<font color=red>{0}</font>" is not a correct name, please input name again</li> error.password.required= <li>"<font color=red>{0}</font>" is not a correct password, please input password again</li> error.nameOrPassword.required= <li> name or password not correct</li> |
2.6. 修改 LoginAction.java 文件
修改 LoginAction 类的 execute 方法:
public ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) { LoginForm loginForm = (LoginForm) form;// TODO Auto-generated method stub String username= loginForm.getUsername(); String password= loginForm.getPassword();
ActionErrors errors= new ActionErrors(); if("aaron".equals(username)&&"123".equals(password)){ return mapping.findForward("success"); } else{ errors.add("name", new ActionError("error.name.required", username)); errors.add("password", new ActionError("error.password.required", password)); saveErrors(request, errors); return mapping.findForward("fail"); } } |
Action的流程是:如果用户名密码分别为aaron和123则跳转到登录成功页面success.jsp显示welcom!!!,否则,简单的标记为用户名和密码错误,并跳转到login.jsp页面,显示错误信息并重新登录
2.7. 测试
操作:[Menu] Run/Run(用 MyEclipse Server Application 方式运行)
在 index.jsp 页面输入 "aaron/123",登录成功;输入 "aaron/1111" ,跳转到 login.jsp 页面。
如果测试成功,证明 Structs 运行正常。
3. Spring 部分
3.1. 添加 Spring 功能支持
操作:[Menu] MyEclipse/Project Capabilities/Add Spring Capabilities
开发包(libraries)选择 "Spring 1.2 AOP Libraries、Spring 1.2 Core Libraries两项;
JAR Library Installation 选择 "copy checked..." ,"Library Folder" 项选择 "/WebRoot/WEB-INF/lib"(这样的话所需的类库都将拷贝到项目目录,方便以后的布署)。
点击 "下一步(Next)" 创建配置文件,修改文件路径(Folder)到 "src" 目录,文件名称为默认的"applicationContext.xml"。
选择完成,
选择Keep Existing,成功导入Spring功能
注意: 查看构建路径中有没有spring.jar包,很多情况下MyEclipse都没有导入这个包,如果没有则导入相同版本的spring.jar包 |
导入spring.jar包(1.2.9)
3.2. 配置 struts-config.xml 文件
添加 Spring 插件(在 <message-resources> 标签后面添加):
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE struts-config PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 1.1//EN" "http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd">
<struts-config> <data-sources /> <form-beans> <form-bean name="loginForm" type="struts.form.LoginForm"></form-bean> </form-beans> <global-exceptions /> <global-forwards /> <action-mappings> <action path="/login" input="/login.jsp" name="loginForm" type="org.springframework.web.struts.DelegatingActionProxy"> <forward name="success" path="/success.jsp"></forward> <forward name="fail" path="/login.jsp"></forward> </action> </action-mappings>
<message-resources parameter="ApplicationResources" />
<plug-in className="org.springframework.web.struts.ContextLoaderPlugIn"> <set-property property="contextConfigLocation" value="/WEB-INF/classes/applicationContext.xml"/> </plug-in> </struts-config> |
粗体字部份为修改的内容,这里将使用 spring 的代理器 DelegatingActionProxy 来对 Action 进行控制。
注: 如果applicationContext.xml部署在src目录下,则对应发布后的目录为/WEB-INF/classes下 property="contextConfigLocation" value="/WEB-INF/classes/applicationContext.xml"/> 与系统属性文件ApplicationResources不同,虽然文件发布后的路径也为/WEB-INF/classes 但是却可以如下配置<message-resources parameter="ApplicationResources" /> |
3.3. 修改 Spring 配置文件 applicationContext.xml
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd"> <beans> <bean name="/login" class="struts.action.LoginAction"></bean> </beans> |
粗体字是关于接受和处理 Action 控制权的配置内容,"com.login.struts.action.LoginAction" 即为原 struts 里的配置。
3.4. 增加log4j日志功能
增加日志功能方便调试程序,log4j.properties文件如下
log4j.rootLogger=INFO, A1, R
log4j.appender.A1=org.apache.log4j.ConsoleAppender log4j.appender.A1.layout=org.apache.log4j.PatternLayout log4j.appender.A1.Threshold=FATAL log4j.appender.A1.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} [%c]-[%p] %m%n #R 输出到文件 RollingFileAppender的扩展,可以提供一种日志的备份功能。 log4j.appender.R=org.apache.log4j.DailyRollingFileAppender #详细日志文件保存在C盘目录下的login.log文件中 log4j.appender.R.File=c:/login.log log4j.appender.R.Encoding=GBK log4j.appender.R.Threshold=INFO log4j.appender.R.DatePattern='.'yyyy-MM-dd log4j.appender.R.layout=org.apache.log4j.PatternLayout log4j.appender.R.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm} %5p %c{1}: %L: %m%n |
注意: Add Struts Capabilities时并没有加入log4j.jar包,为了提供log4j功能,需要加上log4j.jar。
这里是因为导入Spring的时候附带导入了log4j.jar包,所以此处不用再另外导入log4j.jar包
3.5. 测试
同上一次测试。测试成功证明 Spring 运行正常。
4. Hibernate 部分
下面开始 Hibernate 部分,将原例修改为使用数据库进行用户名/密码验证。
4.1. 创建 sqlserver2000 数据库和表
添加表其中有id(标识),username,和password字段:
SQL代码如下:
if exists (select * from dbo.sysobjects where id = object_id(N'[dbo].[users]') and OBJECTPROPERTY(id, N'IsUserTable') = 1) drop table [dbo].[users] GO
CREATE TABLE [dbo].[users] ( [id] [int] IDENTITY (1, 1) NOT NULL , [username] [varchar] (50) COLLATE Chinese_PRC_CI_AS NULL , [password] [varchar] (50) COLLATE Chinese_PRC_CI_AS NULL ) ON [PRIMARY] GO |
再添加一条记录:
insert into user_table (username,password) values ('aaron','123')
4.2. 创建 MyEclipse 数据库驱动(DB Driver)
在 DB Brower 的菜单中选择 "New"
"Profile Name" 项输入 "MyWeb" ,
“Driver”项选择Microsoft SQL Server
"Connection URL" 为"jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=MyWeb"
然后输入正确的用户名(User Name)和密码(Password)按实际情况输入;
点击 "完成(Finish)"。
接下去即可以添加Hibernate支持了。
4.3. 添加 Hibernate 功能支持
操作:[Menu] MyEclipse/Project Capabilities/Add Hibernate Capabilities
Hibernate 版本(Hibernate Specification)选择 "Hibernate 3.1" ,开发包(libraries)选择 Hibernate 3.1 Core Libraries、Spring 1.2 ORM/DAO/Hibernate3 Libaries 两项;
注: (如果出java.lang.NoClassDefFoundError: org/hibernate/cfg/HbmBinder$SecondPass异常,则是因为导入的包hibernate3.jar和 hibernate-annotations.jar的冲突,直接删除hibernate-annotations.jar即可) |
JAR Library Installation 选择 "copy checked..." ,"Library Folder" 选择 "/WebRoot/WEB-INF/lib" 。
点击 "下一步(Next)" 设置配置文件,选择 "Spring configuration file (applicationContext.xml)" 。
"下一步(Next)" 设置 Spring-Hibernate,选择 "Existing Spring configuration file" ,"SessionFactory ID" 项输入 "sessionFactory" 。
"下一步(Next)" 创建数据源对象,在 Bean Id 中输入 dataSource,"DataSource" 项选择 "Use JDBC Dirver" ,DB Driver 项选择 "MyWeb" ,其余项会自动填充;
记得选中 "Copy DB driver jar(s) to project and add to buidpath" 项,以便将数据连接的库文件复制到项目,方便以后的布署。
"下一步(Next)" 创建 SessionFactory 类,"Java package" 项设置为 "hibernate" (没有则点击"New"按钮添加),"Class name" 项保持默认即可"HibernateSessionFactory" ,Java Compliance Level选择和创建项目时选择的Java版本。(本例中并没有用到HibernateSessionFactory类,留作今后扩展)
点击 "完成(Finish)"。此时会自动建立hibernate.HibernateSessionFactory.java类
applicationContext.xml文件内会根据先前的配置自动添加dataSource和sessionFactory节点
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans> <bean name="/login" class="struts.action.LoginAction"></bean>
<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource"> <property name="driverClassName"> <value>com.microsoft.jdbc.sqlserver.SQLServerDriver</value> </property> <property name="url"> <value>jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=MyWeb;</value> <!-- 上面<value>...</alue>要在同一行,我在自动创建后没在同一行,修改一下即可。否则会出异常 --> </property> <property name="username"> <value>sa</value> </property> <property name="password"> <value>123456</value> </property> </bean> <bean id="sessionFactory" class="org.springframework.orm.hibernate3.LocalSessionFactoryBean"> <property name="dataSource"> <ref bean="dataSource" /> </property> <property name="hibernateProperties"> <props> <prop key="hibernate.dialect"> org.hibernate.dialect.SQLServerDialect </prop> </props> </property> </bean></beans> |
此时如果报错: Class ‘org.apache.commons.dbcp.BasicDataSource’ not found,是因为没有导入依赖包commons-dbcp.jar,导入此包即可
注: <value>...</alue>要在同一行,否则可能会出连接数据库失败。 |
4.4. 创建对象关系映射(ORM)的相关文件
操作:[Menu] Window/Open Perspective/MyEclipse Database Explorer
选中 users 表,点击右键,在出现的菜单中选择 "Hibernate Reverse Engnieering" 。
1、在弹出的窗口中保持 "Java package" 项为 "model" ;
2、选中 "Hibernate mapping file (*.hbm.xml) for each databases table" ,并保持 "Update hibernate..." 项选中;
3、选中 "Java Data Object" 项,并保持 "Create abstract class" 选中;
"Base persistent class" 项留空;
4、取消 "Java Data Access Object..." 项和 "Use custom templates" 项。
点击 "下一步(Next)" ,
再点击 "下一步(Next)" ,
在 "Configure reverse engineering details" 页选中 "users" 表,在右边出现的 "Class Name" 项中输入 "model.Users",其它不变。
点击 "完成(Finish)"。
完成此操作,会在 "model" 包下创建三个文件:AbstractUsers.java、Users.java、Users.hbm.xml。
此时sessionFactory部分会添加Users.hbm.xml映射文件的相关信息
<bean id="sessionFactory" class="org.springframework.orm.hibernate3.LocalSessionFactoryBean"> <property name="dataSource"> <ref bean="dataSource" /> </property> <property name="hibernateProperties"> <props> <prop key="hibernate.dialect"> org.hibernate.dialect.SQLServerDialect </prop> </props> </property> <property name="mappingResources"> <list> <value>model/Users.hbm.xml</value></list> </property></bean> |
4.5. 创建 IUsersDAO.java 接口和 UsersDAO.java 类
IUsesDAO.java 内容如下:
package dao; import model.Users; publicinterface IUsersDAO { publicabstractboolean isValidUser(Users user); } |
UsersDAO.java 内容如下:
package dao; import java.util.List; import model.Users; import org.springframework.orm.hibernate3.support.HibernateDaoSupport; publicclass UsersDAO extends HibernateDaoSupport implements IUsersDAO { publicboolean isValidUser(Users user) { // TODO自动生成方法存根 List list= this.getHibernateTemplate().findByExample(user); if(list.size()>0) returntrue; returnfalse; } } |
注意: 此处的HibernateDaoSupport的路径可能有多个(可能导入了许多其它的包),注意此处的父类 为org.springframework.orm.hibernate3.support.HibernateDaoSupport 而不是org.springframework.orm.hibernate.support.HibernateDaoSupport |
4.6. 修改 LoginAction.java 文件
在LoginAction.java类中定义属性publicIUsersDAOusersDao;并定义了一个setUsersDao(IUsersDAO usersDao)方法,可以让我们注入IUsersDAO的实例,在Action中使用IUsersDAO对象来验证用户信息:(IUsersDAO必须为接口类型)
package struts.action; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import model.Users; import org.apache.struts.action.Action; import org.apache.struts.action.ActionError; import org.apache.struts.action.ActionErrors; import org.apache.struts.action.ActionForm; import org.apache.struts.action.ActionForward; import org.apache.struts.action.ActionMapping; import dao.IUsersDAO; import struts.form.LoginForm;
publicclass LoginAction extends Action { public IUsersDAO usersDao;
publicvoid setUsersDao(IUsersDAO usersDao){ this.usersDao= usersDao; }
public ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) { LoginForm loginForm = (LoginForm) form;// TODO Auto-generated method stub String username= loginForm.getUsername(); String password= loginForm.getPassword(); ActionErrors errors= new ActionErrors(); Users user= new Users(); user.setUsername(username); user.setPassword(password); if(!usersDao.isValidUser(user)){ errors.add(ActionErrors.GLOBAL_ERROR, new ActionError("error.nameOrPassword.required")); //如果登录失败,则判定用户名或密码错误 saveErrors(request, errors); return mapping.findForward("fail"); } return mapping.findForward("success"); } } |
4.7. 修改Spring配制文件 applicationContext.xml
(1)、定义UsersDAO节点,注入HibernateSessionFactory对象sessionFactory(属性及对应setter方法通过继承HibernateDaoSupport而来)
<bean id="usersDAO" class="dao.UsersDAO"> <property name="sessionFactory"> <ref bean="sessionFactory"/> </property> </bean> |
(2)、增加事务功能
<bean id="transactionManager" class="org.springframework.orm.hibernate3.HibernateTransactionManager"> <property name="sessionFactory"> <ref bean="sessionFactory"/> </property> </bean> |
(3)、建立代理
<bean id="usersDAOProxy" class="org.springframework.transaction.interceptor.TransactionProxyFactoryBean"> <property name="transactionManager"> <ref bean="transactionManager"/> </property> <property name="target"> <ref local="usersDAO"/> </property> <property name="transactionAttributes"> <props> <prop key="is*">PROPAGATION_REQUIRED</prop> </props> </property> </bean> |
(4)、修改处理用户请求的Controller定义,因为在LoginAction中定义了IUsersDAOusersDao属性,并提供了对应的setter方法,所以需要在配置文件中注入信息,把dao.UsersDAO的代理注入进来
<bean name="/login" class="struts.action.LoginAction"> <property name="usersDao"> <ref bean="usersDAOProxy"/> </property> </bean> |
完整的applicationContext.xml内容如下:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd"> <beans> <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource"> <property name="driverClassName"> <value>com.microsoft.jdbc.sqlserver.SQLServerDriver</value> </property> <property name="url"> <value>jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=MyWeb;</value> <!-- 上面<value>...</alue>要在同一行,我在自动创建后没在同一行,修改一下即可。否则会出异常 --> </property> <property name="username"> <value>sa</value> </property> <property name="password"> <value>123456</value> </property> </bean> <bean id="sessionFactory" class="org.springframework.orm.hibernate3.LocalSessionFactoryBean"> <property name="dataSource"> <ref bean="dataSource" /> </property> <property name="hibernateProperties"> <props> <prop key="hibernate.dialect"> org.hibernate.dialect.SQLServerDialect </prop> </props> </property> <property name="mappingResources"> <list> <value>model/Users.hbm.xml</value></list> </property> </bean>
<bean id="usersDAO" class="dao.UsersDAO"> <property name="sessionFactory"> <ref local="sessionFactory"/> </property> </bean>
<bean id="transactionManager" class="org.springframework.orm.hibernate3.HibernateTransactionManager"> <property name="sessionFactory"> <ref local="sessionFactory"/> </property> </bean>
<bean id="usersDAOProxy" class="org.springframework.transaction.interceptor.TransactionProxyFactoryBean"> <property name="transactionManager"> <ref bean="transactionManager"/> </property> <property name="target"> <ref local="usersDAO"/> </property> <property name="transactionAttributes"> <props> <prop key="is*">PROPAGATION_REQUIRED,readOnly</prop> </props> </property> </bean>
<bean name="/login" class="struts.action.LoginAction"> <property name="usersDao"> <ref bean="usersDAOProxy"/> </property> </bean> </beans> |
4.8. 测试
测试抛出java.lang.NoClassDefFoundError: org/hibernate/cfg/HbmBinder$SecondPass。按前面说的方法,把hibernate-annotations.jar彻底删除。
再测试,成功。
如果还有问题的,可对照log文件找异常信息