struts2 零配置 + Spring5 整合
1.搭建环境
idea2018 + maven3.6 + jdk8 + tomcat9 + struts2.5.30 + spring
2.整合思路
struts当作Controller层负责servlet交互,而Controller层需要的组件如Service和Dao则由Spring的IoC接管负责
3.项目目录
1.maven导入依赖
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<parent>
<artifactId>pbsbpm-study</artifactId>
<groupId>com.cokebot</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>struts-spring</artifactId>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<struts.version>2.5.30</struts.version>
<spring.version>4.3.26.RELEASE</spring.version>
</properties>
<dependencies>
<!--struts2核心包-->
<dependency>
<groupId>org.apache.struts</groupId>
<artifactId>struts2-core</artifactId>
<version>${struts.version}</version>
</dependency>
<!--strut2和spring整合包-->
<dependency>
<groupId>org.apache.struts</groupId>
<artifactId>struts2-spring-plugin</artifactId>
<version>${struts.version}</version>
</dependency>
<!--struts2注解开发包-->
<dependency>
<groupId>org.apache.struts</groupId>
<artifactId>struts2-convention-plugin</artifactId>
<version>${struts.version}</version>
</dependency>
<!--可以浏览项目中的所有action及其与 jsp view的映射的插件-->
<dependency>
<groupId>org.apache.struts</groupId>
<artifactId>struts2-config-browser-plugin</artifactId>
<version>${struts.version}</version>
</dependency>
<!--spring5-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>${spring.version}</version>
</dependency>
<!-- servlet -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jsp-api</artifactId>
<version>2.0</version>
<scope>provided</scope>
</dependency>
<!--json-->
<dependency>
<groupId>net.sf.json-lib</groupId>
<artifactId>json-lib</artifactId>
<version>2.4</version>
<!--必须提供不然maven会包错,有jdk13 jdk15两个版本-->
<classifier>jdk15</classifier>
</dependency>
</dependencies>
</project>
2.配置文件
首先需要给项目添加Web模块
2.1 配置web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
version="4.0">
<display-name>Spring Struts 2</display-name>
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
<!--加载spring上下文文件需要ContextLoaderListener。
Spring的配置文件称为applicationContext.xml文件,它必须放置在与web.xml文件相同的级别-->
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<!--spring配置文件位置 修改为resources资源目录下-->
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:applicationContext.xml</param-value>
</context-param>
<!--配置struts核心过滤器-->
<filter>
<filter-name>struts2</filter-name>
<filter-class>org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>struts2</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>
2.2 配置struts.xml
- 注意文件名struts.xml不要拼错,不然就会报404错误。
- struts.xml文件必须在web程序classpath的根下面,也就是resources目录下。
- 具体配置的使用可参考目录4.Action类—零配置注意事项,约定大于配置部分。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.5//EN"
"http://struts.apache.org/dtds/struts-2.5.dtd">
<struts>
<!-- 把它设置为开发模式,发布时要设置为false -->
<constant name="struts.devMode" value="true"/>
<!-- 自动动态方法的调用,使用这个设置后可以这样调用:action!method 官方不推荐,暴露地址 -->
<constant name="struts.enable.DynamicMethodInvocation" value="true"/>
<!--该属性指定需要Struts 2处理的请求后缀,该属性的默认值是action,即所有匹配*.action的请求都由Struts2处理。 如果用户需要指定多个请求后缀,则多个后缀之间以英文逗号(,)隔开-->
<constant name="struts.action.extension" value="do,,action"/>
<!--配置对象工厂交给spring-->
<constant name="struts.objectFactory" value="spring"/>
<!--设置是否总是以自动装配策略创建对象-->
<constant name="struts.objectFactory.spring.autoWire.alwaysRespect" value="true"/>
<!-- 用于配置包名后缀。默认为action、actions、struts,从value值开始到包结束的部分,就是命名空间,如Com.ustb.web.user.detail.UserAction的命名空间是:”/user/detail”-->
<constant name="struts.convention.package.locators" value="action,web"/>
<!--默认所有package的父包-->
<constant name="struts.convention.default.parent.package" value="crud-default"/>
<!-- 用于配置类名后缀,默认为Action,设置后,Struts2只会去找这种后缀名的类做映射 -->
<constant name="struts.convention.action.suffix" value="Action"/>
<!-- 名称首字母小写 -->
<constant name="struts.convention.action.name.lowercase" value="true"/>
<!--约定将com.ustb.web.user.detail.UserDetailAction,映射的url就是/WEB-INF/content/user/detail/user-detail.jsp-->
<constant name="struts.convention.action.name.separator" value="-"/>
<!--设置Convention插件定位视图资源的根路径,默认为/WEB-INFO/content/ -->
<constant name="struts.convention.result.path" value="/WEB-INF/page/"/>
<package name="crud-default" namespace="/" extends="convention-default">
<!--2.5之后要开启动态方法需要该属性,允许映射的方法默认允许所有-->
<global-allowed-methods>regex:.*</global-allowed-methods>
<!--拦截器等等-->
</package>
</struts>
2.3 配置applicationContext.xml
同struts.xml一样,放置在classpath的根下面。
<?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:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd">
<!-- 开启注解扫描 去扫描service、dao层注册bean-->
<!--<context:component-scan base-package="com.cokebot.service.*,com.cokebot.dao.*"/>-->
</beans>
3.jsp
目录结构
3.1 user-info.jsp
<%@ page contentType="text/html;charset=UTF-8" %>
<%@ taglib prefix="s" uri="/struts-tags" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<h1>
用户信息:<s:property value="username"/>
</h1>
</body>
</html>
3.2 welcome.jsp
<%@ page contentType="text/html;charset=UTF-8" %>
<%@ taglib prefix="s" uri="/struts-tags" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<h1>
Welcome!
</h1>
</body>
</html>
index.jsp
<%@ page contentType="text/html;charset=UTF-8" %>
<%@ taglib prefix="s" uri="/struts-tags" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<h1>首页</h1>
</body>
</html>
4.Action类
1.目录结构
2.零配置注意事项,约定大于配置
2.1 约定将java包*.action(或者web)之后的包名开始作为命名空间,如 com.cokebot.action.user 的命名空间为 /user;com.cokebot.web.a.b 的命名空间为 /a/b 。
2.1.1 相关配置为<constant name="struts.convention.package.locators" value="action,web"/>
2.1.2 也可以在类上用@Namespace(“/…”)注解自定义命名空间
2.2 约定除去单词Action外的类名,小写并单词用"-"连接组成的字符串作为类的映射也是execute方法的映射,如UserDetailAction的execute映射为user-detail.do(或.action或空)
2.2.1 相关配置<constant name="struts.action.extension" value="do,,action"/>
、<constant name="struts.convention.action.name.separator" value="-"/>
2.3 不注册action想要访问可以使用动态调用(感叹号方式,还有指定方法和通配符的方式,需要时再了解),如noMappingMethod方法可以用 /user/user-detail!noMappingMethod.do的方式来访问
2.3.1 开启动态调用的配置(感叹号方式)<constant name="struts.enable.DynamicMethodInvocation" value="true"/>
2.3.2 开启动态调用后还需配置允许通过的方法<global-allowed-methods>regex:.*</global-allowed-methods>
,不然无法启用动态调用,这是个坑! 这是struts2.5之后的改动。
2.4 在方法上使用@Action(“actionName”)注解关联映射,访问路径是:/命名空间/约定的类映射!actionName.do(action, 空),如:com.cokebot.action.user.UserDetailAction的welcome方法的访问路径为:/user/user-detail!welcome.do(action, 空)。
2.5 约定jsp默认访问路径为:配置资源路径(这里配置了/WEB-INF/page/,默认是/WEB-INFO/content)/命名空间/jsp页面,如welcome.jsp是放在 /WEB-INF/page/user/welcome.jsp 正好是约定的位置,所以@Result注解的location属性填 welcome.jsp就能直接访问到。
package com.cokebot.action.user;
import com.opensymphony.xwork2.ActionSupport;
import org.apache.struts2.convention.annotation.Action;
import org.apache.struts2.convention.annotation.Result;
import org.apache.struts2.convention.annotation.Results;
@Results({
@Result(name = "letsgo", location = "user-info.jsp", type = "dispatcher"),
@Result(name = "welcome", location = "welcome.jsp", type = "dispatcher")
})
public class UserDetailAction extends ActionSupport {
private String username;
/**
* 约定 /user/user-detail.do 映射到此方法上
* @return
*/
@Override
public String execute() {
System.out.println(this.getClass() + ":执行了execute()方法");
username = this.getClass().toString();
return "letsgo";
}
@Action(value = "welcome")
public String welcome() {
System.out.println(this.getClass() + ":执行了welcome()方法");
return "welcome";
}
/**
* SUCCESS -> /WEB-INF/page/user/welcome.jsp
* ERROR -> /index.jsp (classpath根下)
*/
@Action(value = "login", results = {
@Result(name = SUCCESS, location = "welcome.jsp", type = "dispatcher"),
@Result(name = ERROR, location = "/index.jsp", type = "dispatcher")
})
public String login() {
System.out.println(this.getClass() + ":执行了login()方法");
return "张三".equals(username) ? SUCCESS : ERROR;
}
public void noMappingMethod() {
System.out.println(this.getClass() + ":执行无映射方法...");
}
// 想要从前端获取和赋值必须实现setter getter 方法
public String getUsername() {return username;}
public void setUsername(String username) {this.username = username;}
}
5.所有方法访问结果展示
5.1 http://localhost:8080/user/user-detail.do
访问UserDetailAction类默认映射为user-detail.do(action, 空)的execute方法
5.2 http://localhost:8080/user/welcome.do
访问UserDetailAction类使用@Action指定映射的welcome方法;当然也可以输入http://localhost:8080/user/user-detail!welcome.do
通过动态调用(感叹号方式)来访问welcome方法
5.3 http://localhost:8080/user/user-detail!noMappingMethod
通过动态调用(感叹号方式)进入UserDetailAction类无映射的noMappingMethod方法
5.4 http://localhost:8080/user/login.do?username=张三
判定通过进入welcome.jsp;http://localhost:8080/user/login.do?username=123
判定不通过进入index.jsp
6.使用struts2-convention-plugin插件查看所有命名空间以及Actions
导入pom依赖,启动项目,在地址栏输入
http://localhost:8080/config-browser/actionNames.action