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;
	}
	
	@Override
	public 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" class="loginAction">
			<result name="success">/result.jsp</result>
			<result name="input">/index.jsp</result>
		</action>
	</package>
</struts>

 

6.2 applicationContext.xml

<?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"
		class="com.thu.afa.struts2spring.service.impl.LoginServiceImpl" />
	<bean id="loginAction"
		class="com.thu.afa.struts2spring.action.LoginAction">
		<property name="loginService">
			<ref bean="loginService" />
		</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
-----------------------------------------------------