Struts 入门教程

Struts是最古老的框架之一,用于构建 [Java Web Application](/community/tutorials/java-web-application-tutorial-for-beginnersJava Web Application Tutorial for Beginners)。

精英 Tutorial

Struts was the initial implementation of MVC design pattern and it has evolved a lot along with latest enhancements in Java, Java EE technologies. Struts tutorial article is aimed to provide basic details of Struts 2 and how we can create our first "Hello World" Struts 2 application.

铁路2

Apache Struts 2 是一个开源、行业标准、灵活和可扩展的框架,用于构建 Java EE Web 应用程序。Struts 2 是基于 OpenSymphony WebWork 框架。

Struts 2 架构图

Below diagram shows different component of Struts 2 in a web application.

Struts 2 拦截器

Struts Interceptors类似于 [Servlet Filters](/community/tutorials/java-servlet-filter-example-tutorial Java Servlet Filter Example Tutorial)在处理请求之前和之后执行。它们用于执行不同操作的常见操作,例如日志,会话验证,在响应中添加常见标题等。

Struts 2 ValueStack 和 OGNL

ValueStack是Struts 2为处理客户端请求而存储应用数据的存储区域。数据存储在ActionContext对象中,这些对象使用 ThreadLocal具有特定请求线程的值。 Object-Graph Navigation Language(OGNL)是一种强大的表达语言,用于操纵存储在 ValueStack 上的数据。

Struts 2 动作

Struts 2 操作组件处理客户端请求,Struts 2 提供了创建 Action 类的不同方式。

通过实施com.opensymphony.xwork2.Action界面 2. 通过扩展com.opensymphony.xwork2.ActionSupport类,通常用于创建空的操作类来将请求转发到另一个资源 3. 使用 @Action 或 @Actions 注释 3 对类进行注释。

斯特拉斯 2 结果

结果组件通常是 JSP 或 HTML 页面,以创建客户端响应的视图。 Struts 2 提供自己的标签,我们可以在 JSP 页面中使用来创建响应。

Struts 2 宣言式架构和电线

Struts 2 提供了两种方式来配置我们的应用程序的动作类和结果页。

Struts XML 文件:我们在 WEB-INF/classes 目录中有 **struts.xml 文件,我们可以配置我们的应用程序动作类和结果页面
注释:我们可以使用 **(Java 注释)(/社区/教程/java 注释)**提供有关类的元数据信息。

无论我们如何配置我们的应用程序,最终结果将始终是相同的。

Struts 教程 - Hello World 基于 XML 的应用程序

Let's see how we can create our first Struts 2 Hello World application. First of all we need is Struts 2 jar files, the easiest way is to download it from Struts 2 Official Downloads page. But when you will check out the libs in the downloaded archive, you will see a lot of jar files that we don't need for our simple application. So I will create a maven project and add struts-core dependency only, all the other transitive dependency jars will be automatically downloaded and added to the application. Our final project structure will be like below image. Create a new Dynamic Web Project Struts2XMLHelloWorld in Eclipse and then convert it to maven project like below image. You will notice pom.xml file is added in the root directory of the project. Our project setup in Eclipse is ready, let's look at the different components in order.

点击.xml

打开 pom.xml 文件并添加 Struts 核心依赖,最终的 pom.xml 将看起来如下。

fallback

 1<project xmlns="https://maven.apache.org/POM/4.0.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
 2    xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
 3    <modelVersion>4.0.0</modelVersion>
 4    <groupId>Struts2XMLHelloWorld</groupId>
 5    <artifactId>Struts2XMLHelloWorld</artifactId>
 6    <version>0.0.1-SNAPSHOT</version>
 7    <packaging>war</packaging>
 8
 9    <dependencies>
10    	<dependency>
11    		<groupId>org.apache.struts</groupId>
12    		<artifactId>struts2-core</artifactId>
13    		<version>2.3.15.1</version>
14    	</dependency>
15    </dependencies>
16    <build>
17    	<sourceDirectory>src</sourceDirectory>
18    	<plugins>
19    		<plugin>
20    			<artifactId>maven-compiler-plugin</artifactId>
21    			<version>3.1</version>
22    			<configuration>
23    				<source>1.6</source>
24    				<target>1.6</target>
25    			</configuration>
26    		</plugin>
27    		<plugin>
28    			<artifactId>maven-war-plugin</artifactId>
29    			<version>2.3</version>
30    			<configuration>
31    				<warSourceDirectory>WebContent</warSourceDirectory>
32    				<failOnMissingWebXml>false</failOnMissingWebXml>
33    			</configuration>
34    		</plugin>
35    	</plugins>
36    	<finalName>${project.artifactId}</finalName>
37    </build>
38</project>

Notice that I have overridden finalName element to avoid version number getting added in the WAR file when we do maven build. Other parts are added by Eclipse itself, the only dependency we need is struts2-core whose current version is 2.3.15.1 (as of 10-Sep-2013). Just do maven build of the application and you will see a lot of jars added to the application lib directory and shown in Maven Dependencies section of the project like below image.

Struts 2 Web.xml 配置

我们需要在 Web 应用程序中添加 org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter 过滤器,并提供我们希望 Struts 处理客户端请求的 URL 模式。

fallback

 1<?xml version="1.0" encoding="UTF-8"?>
 2<web-app xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
 3    xmlns="https://java.sun.com/xml/ns/javaee"
 4    xsi:schemaLocation="https://java.sun.com/xml/ns/javaee https://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
 5    version="3.0">
 6    <display-name>Struts2XMLHelloWorld</display-name>
 7    
 8    <filter>
 9    	<filter-name>struts2</filter-name>
10    	<filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
11    </filter>
12
13    <filter-mapping>
14    	<filter-name>struts2</filter-name>
15    	<url-pattern>/*</url-pattern>
16    </filter-mapping>
17</web-app>

对于 2.1.3 以下的 Struts 2 版本,过滤类为org.apache.struts2.dispatcher.FilterDispatcher。

Struts Tutorial - 结果页面

我们有三个 JSP 页面将被应用程序使用,我们正在使用 Struts 2 标签来创建我们的 JSP 页面。

fallback

 1<%@ page language="java" contentType="text/html; charset=US-ASCII"
 2    pageEncoding="US-ASCII"%>
 3<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "https://www.w3.org/TR/html4/loose.dtd">
 4<%-- Using Struts2 Tags in JSP --%>
 5<%@ taglib uri="/struts-tags" prefix="s"%>
 6<html>
 7<head>
 8<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 9<title>Login Page</title>
10</head>
11<body>
12<h3>Welcome User, please login below</h3>
13<s:form action="login">
14    <s:textfield name="name" label="User Name"></s:textfield>
15    <s:textfield name="pwd" label="Password" type="password"></s:textfield>
16    <s:submit value="Login"></s:submit>
17</s:form>
18</body>
19</html>

注意表单字段名称为 name 和 pwd,我们将看到它们如何在行动类中使用。

fallback

 1<%@ page language="java" contentType="text/html; charset=US-ASCII"
 2    pageEncoding="US-ASCII"%>
 3<%@ taglib uri="/struts-tags" prefix="s"%>
 4<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "https://www.w3.org/TR/html4/loose.dtd">
 5<html>
 6<head>
 7<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 8<title>Welcome Page</title>
 9</head>
10<body>
11<h3>Welcome <s:property value="name"></s:property></h3>
12</body>
13</html>

请注意,我们可以使用struts 标签 s:property 来获取请求属性,名称与 login.jsp 中的名字相同。

fallback

 1<%@ page language="java" contentType="text/html; charset=US-ASCII"
 2    pageEncoding="US-ASCII"%>
 3<%@ taglib uri="/struts-tags" prefix="s"%>
 4
 5<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "https://www.w3.org/TR/html4/loose.dtd">
 6<html>
 7<head>
 8<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 9<title>Error Page</title>
10</head>
11<body>
12<h4>User Name or Password is wrong</h4>
13<s:include value="login.jsp"></s:include>
14</body>
15</html>

这是一个简单的JSP页面,我们正在添加错误消息并包括登录页面作为回应。

Struts Tutorial - 行动类

我们的应用程序只有一个 Action 类,我们正在实施 Struts 2 Action 接口。

 1package com.journaldev.struts2.action;
 2
 3import com.opensymphony.xwork2.Action;
 4
 5public class LoginAction implements Action {
 6    
 7    @Override
 8    public String execute() throws Exception {
 9    	if("pankaj".equals(getName()) && "admin".equals(getPwd()))
10    	return "SUCCESS";
11    	else return "ERROR";
12    }
13    
14    //Java Bean to hold the form parameters
15    private String name;
16    private String pwd;
17    public String getName() {
18    	return name;
19    }
20    public void setName(String name) {
21    	this.name = name;
22    }
23    public String getPwd() {
24    	return pwd;
25    }
26    public void setPwd(String pwd) {
27    	this.pwd = pwd;
28    }
29    
30}

請注意,動作類別也是一個 java 粒子,與 login.jsp 和其 getter 和 setter 方法相同的變數。

Struts Tutorial - 配置文件

由于我们正在使用基于XML的配置来连接我们的应用程序,我们需要创建一个Struts配置文件,该文件应该被命名为 struts.xml,并在 WEB-INF/classes目录中。

 1<?xml version="1.0" encoding="UTF-8"?>
 2
 3<!DOCTYPE struts PUBLIC
 4    "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN"
 5    "https://struts.apache.org/dtds/struts-2.3.dtd">
 6<struts>
 7
 8<package name="user" namespace="/User" extends="struts-default">
 9    <action name="home">
10    	<result>/login.jsp</result>
11    </action>
12    <action name="login" class="com.journaldev.struts2.action.LoginAction">
13    <result name="SUCCESS">/welcome.jsp</result>
14    <result name="ERROR">/error.jsp</result>
15    </action>
16
17</package>
18
19</struts>

对于行动家,没有行动类,只有一个结果,所以请求将转发到 login.jsp 页面。对于行动登录,LoginAction是行动类,如果 execute() 方法返回成功,请求将由 welcome.jsp 处理,而对于错误将被转发到 error.jsp 页面。 namespace="/User是重要的,并在 URL 中使用来访问行动类,它提供了创建不同的模块。因此,我们可以使用我们的应用程序的 URLhttps://localhost:8080/Struts2XMLHelloWorld/User/home.action`。请注意,URL 结束了。

下一篇: Struts 2 Hello World 测试

When we run our application, we get following response pages.

下载Struts2 Hello World示例项目

这是所有 Struts 2 初学者的教程,请参阅下一篇文章,我们正在使用注释来创建 [Struts 2 Web 应用程序]( / 社区 / 教程 / struts-2-hello-world-example-with-annotations-and-without-struts-xml 文件Struts 2 Hello World 示例与注释和没有 struts.xml 文件)而不使用 struts.xml 配置文件。