Struts2 - Spring 整合简单样例
初学 Struts2,在整合 Spring 时遇到一些麻烦,下面以一个简单样例说明操作过程,以备不时只需。如有不当之处,望不吝赐教。
开发环境:
MyEclipse 6.5
Struts 2.1.8.1
Spring 2.5
Tomcat 6.0
?
1. 新建 web 项目
新建 Java EE 5.0 的 web project
?
2. 项目配置
2.1 配置文件目录
在 src 下新建 config 文件夹,并在该文件夹下新建两个文件夹,分别是:spring 和 struts2,这两个文件夹分别用于放置 spring 和 struts2 的配置文件,以便统一管理。
?
2.2 JAR 包目录
在项目根目录下新建文件夹 lib,并在该文件夹下新建两个文件夹,分别是:spring 和 struts2,这两个文件夹分别用于放置spring 和 struts2 的 JAR 文件,以便统一管理。
?
说明:上边的配置纯属个人偏好或者习惯。
?
3. 添加 Struts2 的支持
将 struts2 所需的基础包以及 struts-spring-plugin 包复制到 lib/struts2 文件夹下,并将这些 JAR 包添加到项目的 classpath。如下图所示。
?
4. 添加 Spring 支持
右键项目 --> MyEclipse --> Add Spring Capabilities...,选中 Spring 2.5 Core Libraries,并将 JAR 文件复制到 lib/spring 目录下,同时选中创建 applicationContext.xml 文件,并将其存放至 src/config/spring 目录下。如下两图所示。
注意:在添加了 Spring 的 JAR 包后,需要检查所有的 JAR 包是否有冲突。比如在样例中,添加 struts2 JAR 包时有 commons-logging-1.0.4,而添加 spring JAR 包时有 commons-logging.jar,这两个 JAR 包由可能会有冲突,需要将其中一个从 classpath 中删除。
?
?
?
5. Java 类及接口编辑
5.1 Service 接口定义
/*********************************************************************** * <p>Project Name: struts2spring</p> * <p>File Name: com.thu.afa.struts2spring.service.LoginService.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.struts2spring.service;/** * <p>Class Name: LoginService</p> * <p>Description: </p> * @author Afa * @date Aug 2, 2010 * @version 1.0 */public interface LoginService{public boolean doLogin(String username, String password);}
?
5.2 Service 接口的实现
public class LoginServiceImpl implements LoginService{/* (non-Javadoc) * <p>Title: </p> * <p>Method Name: doLogin</p> * <p>Description: </p> * @author: Afa * @date: Aug 2, 2010 * @see com.thu.afa.struts2spring.service.LoginService#doLogin(java.lang.String, java.lang.String) * * @param username * @param password * @return */public boolean doLogin(String username, String password){if("llu".equals(username) && "llu".equals(password)) return true;else return false;}}
?
5.3 Action 的定义
/*********************************************************************** * <p>Project Name: struts2spring</p> * <p>File Name: com.thu.afa.struts2spring.action.LoginAction.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.struts2spring.action;import com.opensymphony.xwork2.ActionSupport;import com.thu.afa.struts2spring.service.LoginService;/** * <p>Class Name: LoginAction</p> * <p>Description: </p> * @author Afa * @date Aug 2, 2010 * @version 1.0 */public class LoginAction extends ActionSupport{private static final long serialVersionUID = -231294389344546625L;private String username;private String password;private LoginService loginService;public String getUsername(){return username;}public void setUsername(String username){this.username = username;}public String getPassword(){return password;}public void setPassword(String password){this.password = password;}public LoginService getLoginService(){return loginService;}public void setLoginService(LoginService loginService){this.loginService = loginService;}@Overridepublic String execute() throws Exception{if(loginService.doLogin(username, password)) return SUCCESS;else return INPUT;}}
说明:在 LoginAction?中引用了?LoginService 接口的实例,该实例是通过 spring 注入的。
?
6. 配置文件的编辑
6.1 Struts.xml
<?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><constant name="struts.objectFactory" value="spring" /><package name="com.thu.afa.struts" extends="struts-default"><action name="login" name="code"><?xml version="1.0" encoding="UTF-8"?><beans xmlns="http://www.springframework.org/schema/beans"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd"><bean id="loginService"/><bean id="loginAction"/></property></bean></beans>
?
6.3 配置说明
首先,在 Struts 的配置文件中需要添加如下配置,表明 Struts 对象交由 Spring 进行管理
<constant name="struts.objectFactory" value="spring" />
其次,在 action 配置节点的 class 属性,这里不再是真正的类的映射,由于是交由 Spring 进行管理的缘故,所以需要与 applicationContext.xml 中对于 action 的配置保持一致,而真正的 action 类定义是在 applicationContext.xml 中进行说明。
?
6.4 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></filter><filter-mapping><filter-name>struts2</filter-name><url-pattern>/*</url-pattern></filter-mapping>
说明:按下 Ctrl 键,将鼠标移至 org.springframework.web.context.ContextLoaderListener,如果找不到对应的类,那么还需要手动添加 spring-web.jar 文件到 lib/spring 目录,并将该 JAR 包添加到项目的 classpath。
?
7. JSP 页面
7.1 index.jsp
<body> <s:form action="login.action" method="post"> <s:textfield name="username" label="UserName"></s:textfield> <s:password name="password" label="Password"></s:password> <s:submit value="Submit"></s:submit> </s:form></body>
?
7.2 result.jsp
<body> Welcome,</body>
?
8 项目部署
到此,已完成了 Struts2 和 Spring 的整合,可以部署运行了。如下图所示是项目的整体文件结构。
?
?
-----------------------------------------------------
Stay Hungry, Stay Foolish!
Afa
Aug 2nd, 2010
-----------------------------------------------------