struts2教程-如何创建Struts2 Web应用程序


本教程将介绍如何安装框架并创建一个简单的应用程序。

虽然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。你应该看到以下内容:

basic_struts2_maven_jsp.png

第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教程