本教程将介绍如何安装框架并创建一个简单的应用程序。
虽然Struts 2框架易于使用,但创建非平凡的应用程序需要具备许多J2EE技术的工作知识,包括:
- Java
- Filters, JSP, and Tag Libraries
- JavaBeans
- HTML and HTTP
- Web Containers (such as Tomcat)
- XML
Java要求
Struts 2需要Servlet API 2.4或更高版本,JSP 2.0或更高版本以及Java 7或更高版本
我们的第一个应用
要开始使用Struts 2,我们将使用Maven创建一个Web应用程序来管理工件依赖项。您可以从struts-examples的Struts 2 GitHub存储库中签出所有示例应用程序 .
使用Maven创建Struts 2 Web应用程序来管理工件和构建应用程序
本教程假设您知道如何创建使用Maven管理工件和构建Web应用程序存档(war)文件的Java Web应用程序
第1步 - 创建Java Web应用程序
在Java IDE中,创建一个项目名为basic_struts
的Java Web应用程序,该项目名称遵循标准的Maven项目文件夹结构。在您的pom.xml
中包含以下内容:
pom.xml build node
<build>
<finalName>basic-struts</finalName>
</build>
使用MAVEN运行应用程序,将JETTY MAVEN-PLUGIN添加到您的pom.xml
pom.xml jetty plugin
<build>
...
<plugins>
<plugin>
<groupId>org.eclipse.jetty</groupId>
<artifactId>jetty-maven-plugin</artifactId>
<version>9.4.7.v20170914</version>
<configuration>
<webApp>
<contextPath>/${build.finalName}</contextPath>
</webApp>
<stopKey>CTRL+C</stopKey>
<stopPort>8999</stopPort>
<scanIntervalSeconds>10</scanIntervalSeconds>
<scanTargets>
<scanTarget>src/main/webapp/WEB-INF/web.xml</scanTarget>
</scanTargets>
</configuration>
</plugin>
</plugins>
</build>
上面的插件将使您能够使用mvn jetty:run
运行应用程序
第2步 - 添加index.jsp
我们的下一步是向此Web应用程序添加一个简单的index.jsp
。在src/main/webapp
下创建一个index.jsp
,标题为Basic Struts 2 Application - Welcome
,并在正文中添加一个h1
标题为Welcome To Struts 2!
index.jsp
<!DOCTYPE html>
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" %>
<html>
<head>
<meta charset="UTF-8">
<title>Basic Struts 2 Application - Welcome</title>
</head>
<body>
<h1>Welcome To Struts 2!</h1>
</body>
</html>
运行mvn jetty:run
以运行应用程序。
在Web浏览器中,转到http://localhost:8080/basic-struts/index.jsp
。你应该看到以下内容:
第3步 - 将Struts 2 Jar文件添加到类路径
现在我们知道我们有一个可用的Java Web应用程序,让我们将最小的Struts 2框架Jar文件添加到我们的Web应用程序的类路径中。在pom.xml中添加以下依赖项节点:
pom.xml dependency node
<dependency>
<groupId>org.apache.struts</groupId>
<artifactId>struts2-core</artifactId>
<version>${struts2.version}</version>
</dependency>
当然用当前的Struts 2版本替换${struts2.version}(或在pom属性中定义)。Maven将获得struts2-core jar和struts2-core需要的其他jar文件(传递依赖)
从Struts 2.2.3版开始,您不需要为javassist指定单独的依赖节点
第4步 - 添加日志记录
要了解幕后发生的情况,本教程的示例应用程序使用log4j2。在src/main/resources
文件夹中设置log4j2.xml
配置,其中包含以下内容
log4j2.xml
<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
<Appenders>
<Console name="STDOUT" target="SYSTEM_OUT">
<PatternLayout pattern="%d %-5p [%t] %C{2} (%F:%L) - %m%n"/>
</Console>
</Appenders>
<Loggers>
<Logger name="com.opensymphony.xwork2" level="debug"/>
<Logger name="org.apache.struts2" level="debug"/>
<Root level="warn">
<AppenderRef ref="STDOUT"/>
</Root>
</Loggers>
</Configuration>
请注意,上面的log4j2配置将控制台指定为日志目标。
您需要将log4j2的依赖节点添加到pom:
pom.xml log4j dependency node
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
<version>${log4j2.version}</version>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-api</artifactId>
<version>${log4j2.version}</version>
</dependency>
使用log4j-core和log4j-api允许使用最新版本的Log4j2,而不会与框架提供的版本发生冲突。
或者,如果在struts和log4j2的dependencyManagement部分中使用maven bom“材料清单”,pom.xml将如下所示。请注意,这样您就可以省略每个使用过的模块的版本行,并且所有struts2- 和log4j- 模块都被管理为相同的版本。struts2-bom从2.3.20开始提供。
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
<struts2.version>2.5.14.1</struts2.version>
<log4j2.version>2.10.0</log4j2.version>
</properties>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.apache.struts</groupId>
<artifactId>struts2-bom</artifactId>
<version>${struts2.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-bom</artifactId>
<version>${log4j2.version}</version>
<scope>import</scope>
<type>pom</type>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<!-- Struts 2 -->
<dependency>
<groupId>org.apache.struts</groupId>
<artifactId>struts2-core</artifactId>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
</dependency>
</dependencies>
第5步 - 添加Struts 2 Servlet过滤器
要使Struts 2框架能够与Web应用程序一起使用,您需要添加Servlet过滤器类和过滤器映射到web.xml。下面是添加过滤器和过滤器映射节点后web.xml的外观。web.xml位于src/main/webapp/WEB-INF文件夹下。
web.xml Servlet Filter
<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_ID" version="2.4"
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<display-name>Basic Struts2</display-name>
<welcome-file-list>
<welcome-file>index</welcome-file>
</welcome-file-list>
<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>
第6步 - 创建struts.xml
Struts 2可以使用XML配置文件或注释(或两者)来指定URL,Java类和视图页面(例如index.jsp
)之间的关系。对于我们的基本Struts 2应用程序,我们将使用最小的xml配置。请注意,文件名是struts.xml
,它应该位于src/main/resources
文件夹中(struts.xml
必须位于Web应用程序的根类路径中)。
struts.xml
<?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>
<constant name="struts.devMode" value="true" />
<package name="basicstruts2" extends="struts-default">
<action name="index">
<result>/index.jsp</result>
</action>
</package>
</struts>
这个最小的Struts 2配置文件告诉框架,如果URL以index.action结尾,则将浏览器重定向到index.jsp。有关struts.xml
配置文件的更多信息,请参阅struts.xml
第7步 - 构建并运行应用程序
运行mvn jetty:run
以使用jetty maven-plugin运行web应用程序。
查看控制台,您应该看到许多调试消息,告诉您Struts 2框架包含在basic-struts2 Web应用程序中。
打开Web浏览器并转到http//localhost8080/basic-struts/index.action
(请注意,URL末尾的index.action不是index.jsp)。您应该看到与访问http//localhost:8080/basic-struts/index.jsp
时相同的网页。查看写入控制台的日志消息,您应该找到几个讨论index.action和index.jsp的消息:
Struts 2 Log Messages
...
2017-04-17 11:16:01,084 DEBUG [qtp1723848804-22] xwork2.DefaultActionProxy (DefaultActionProxy.java:89) - Creating an DefaultActionProxy for namespace [/] and action name [index]
...
2017-04-17 11:16:01,172 DEBUG [qtp1723848804-22] result.ServletDispatcherResult (ServletDispatcherResult.java:131) - Forwarding to location: /index.jsp
...
更多struts2详细教程请访问struts2教程