注释

如前章节中所讲到的，Struts提供了两种形式的配置。传统的方式是对所有配置使用struts.xml文件。

配置Struts的另一种方法是使用Java5 的注释功能。使用struts注释，我们可以实现零配置。

要在项目中开始使用注释，请确保WebContent/WEB-INF/lib文件夹中包含以下jar文件：

struts2-convention-plugin-x.y.z.jar
asm-x.y.jar
antlr-x.y.z.jar
commons-fileupload-x.y.z.jar
commons-io-x.y.z.jar
commons-lang-x.y.jar
commons-logging-x.y.z.jar
commons-logging-api-x.y.jar
freemarker-x.y.z.jar
javassist-.xy.z.GA
ognl-x.y.z.jar
struts2-core-x.y.z.jar
xwork-core.x.y.z.jar

现在让我们看看如何可以取消struts.xml文件中可用的配置，并将其替换为注释。

为了解释Struts2 中注释的概念，我们必须重新使用在Struts2 验证框架章节中所学习的验证示例。

这里我们将举一个Employee的例子，employee的名字和年龄使用一个简单的页面捕获，我们将进行两次验证，以确保用户始终输入一个名字，并且年龄应在28和65之间。那么，让我们从示例的JSP主页面开始。

创建主页

首先，先开始写用来收集上面提到的Employee相关信息的主页JSP文件index.jsp。

<%@ page language="java" contentType="text/html; charset=ISO-8859-1"
   pageEncoding="ISO-8859-1"%>
<%@ taglib prefix="s" uri="/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Employee Form</title>
</head>

<body>

   <s:form action="empinfo" method="post">
      <s:textfield name="name" label="Name" size="20" />
      <s:textfield name="age" label="Age" size="20" />
      <s:submit name="submit" label="Submit" align="center" />
   </s:form>

</body>
</html>

index.jsp使用的Struts标签我们还没有涉及到，不过将在标签相关章节中学习它们。现在，假设s:textfield标签印出一个输入字段，并且s:submit印出一个提交按钮。我们为每个标签使用了label属性，即为每个标签创建标记。

创建视图

我们将使用JSP文件的success.jsp，在定义的action返回SUCCESS的情况下调用它。

<%@ page language="java" contentType="text/html; charset=ISO-8859-1"
   pageEncoding="ISO-8859-1"%>
<%@ taglib prefix="s" uri="/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Success</title>
</head>
<body>
   Employee Information is captured successfully.
</body>
</html>

创建Action

Action是使用注释的地方。让我们重新定义具有注释的action类Employee，然后如下所示在Employee.java文件中添加一个名为validate()的方法。需要确保action类扩展了ActionSupport类，否则将不会执行validate方法。

package cn.jsrun.struts2;

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;
import com.opensymphony.xwork2.validator.annotations.*;

@Results({
   @Result(name="success", location="/success.jsp"),
   @Result(name="input", location="/index.jsp")
})
public class Employee extends ActionSupport{
   private String name;
   private int age;

   @Action(value="/empinfo")
   public String execute() 
   {
       return SUCCESS;
   }

   @RequiredFieldValidator( message = "The name is required" )
   public String getName() {
       return name;
   }
   public void setName(String name) {
       this.name = name;
   }

   @IntRangeFieldValidator(message = "Age must be in between 28 and 65",
                                      min = "29", max = "65")
   public int getAge() {
       return age;
   }
   public void setAge(int age) {
       this.age = age;
   }
}

我们在这个例子中使用了一些注释，让我们逐个了解一下：

首先是例子中包含的Results注释，Results注释是结果的集合。在这个注释集合下，有两个结果注释。它们包含对应于execute方法结果的名称，还包含对应于execute()的返回值所提的视图位置。

下一个注释是Action注释，这可用于装饰execute()方法。Action方法还接收一个值，该值是调用action的URL。

最后，我们使用了两个validation注释。我们已经配置了必填字段验证器上的name字段和整数范围验证器上的age字段，此外还为验证指定了自定义的信息。

配置文件

实际上我们真的不需要struts.xml配置文件，可以删除这个文件，直接来查看web.xml文件的内容：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xmlns="http://java.sun.com/xml/ns/javaee"
   xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
   xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
   http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
   id="WebApp_ID" version="3.0">

   <display-name>Struts 2</display-name>
   <welcome-file-list>
      <welcome-file>index.jsp</welcome-file>
   </welcome-file-list>

   <filter>
      <filter-name>struts2</filter-name>
      <filter-class>
         org.apache.struts2.dispatcher.FilterDispatcher
      </filter-class>
      <init-param>
         <param-name>struts.devMode</param-name>
         <param-value>true</param-value>
      </init-param>
   </filter>

   <filter-mapping>
      <filter-name>struts2</filter-name>
      <url-pattern>/*</url-pattern>
   </filter-mapping>
</web-app>

现在，右键单击项目名称，然后单击“Export”> “WAR File”以创建WAR文件。然后在Tomcat的webapps目录中部署WAR文件。

最后，启动Tomcat服务器并尝试访问URL http://localhost:8080/HelloWorldStruts2/index.jsp，将显示以下界面：

电子邮件用户输入

先不要输入任何所需的信息，只点击“Submit”按钮。你将看到以下结果：

输入所要求的信息而非错误类的字段，如名称为“text”，年龄为30，然后点击Submit按钮，可以看到以下界面：

Struts2 注释类型

Struts2 应用程序可以使用Java5注释来替代XML和Java属性的配置。

注释

注释

创建主页

创建视图

创建Action

配置文件

Struts2 注释类型

选择支付方式：