Struts 2 - 注释

如前所述,Struts提供两种配置形式.传统方法是使用 struts.xml 文件进行所有配置.到目前为止,我们在教程中已经看到了很多这样的例子.配置Struts的另一种方法是使用Java 5 Annotations功能.使用struts注释,我们可以实现零配置.

要在项目中开始使用注释,请确保在

  • struts2-convention-plugin-xyzjar

  • asm-xyjar

  • antlr-xyzjar

  • commons-fileupload-xyzjar

  • commons-io-xyzjar

  • commons-lang-xyjar

  • commons-logging-xyzjar

  • commons-logging-api-xyjar

  • freemarker-xyzjar

  • javassist-.xy.z.GA

  • ognl-xyzjar

  • struts2-core-xyzjar

  • xwork-core.xyzjar

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

为了解释Struts2中Annotation的概念,我们必须重新考虑我们的验证示例说明d在 Struts2 Validations 章节中.

这里,我们举一个员工的例子名称,年龄将使用一个简单的页面捕获,我们将进行两次验证,以确保ÜSER始终输入名称,年龄应在28到65之间.

让我们开始使用示例的主JSP页面.

创建主页

让我们编写主页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 pr提交一个提交按钮.我们为每个标签使用了label属性,为每个标签创建标签.

创建视图

我们将使用JSP文件 success.jsp 如果定义的操作返回 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>

创建操作

这是使用注释的地方.让我们用注释重新定义动作类 Employee ,然后添加一个名为 validate()的方法,如下面的 Employee.java 文件所示.确保您的操作类扩展了 ActionSupport 类,否则您的validate方法将不会被执行.

package com .it1352.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;
   }
}

我们在这个例子中使用了很少的注释.让我一个接一个地阅读它们;

  • 首先,我们已经包含了结果注解.结果注释是结果的集合.

  • 在结果注释下,我们有两个结果注释.结果注释具有与执行方法的结果相对应的名称.它们还包含一个位置,该视图应该提供与execute()的返回值相对应的视图.

  • 下一个注释是操作注释.这用于装饰execute()方法. Action方法还接受一个值,该值是调用该操作的URL.

  • 最后,我使用了两个验证注释.我在 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>

现在,右键单击项目名称,然后单击导出> WAR文件以创建War文件.然后在Tomcat的webapps目录中部署此WAR.最后,启动Tomcat服务器并尝试访问URL http://localhost:8080/HelloWorldStruts2/index.jsp .这将生成以下屏幕 :

电子邮件用户输入

现在请勿输入任何必填信息,只需点击提交按钮即可.您将看到以下结果 :

Error

输入所需信息,但输入错误的From字段,让我们说名称为"test",年龄为30,最后点击提交按钮.您将看到以下结果 :

成功

Struts 2注释类型

Struts 2应用程序可以使用Java 5注释作为XML和Java属性配置的替代方法.您可以查看与不同类别相关的最重要注释列表 :

Struts 2注释类型