Struts 2 注解


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

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

  • 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中Annotation的概念,我们将不得不重新考虑我们在Struts2验证章节中解释的验证示例。

在这里,我们将举一个雇员的例子,他的姓名,年龄将通过一个简单的页面捕捉到,我们将进行两次验证,以确保“总是输入一个名字,年龄应该在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打印提交按钮。我们为每个标签使用了标签属性,为每个标签创建标签。

创建视图

我们将使用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.CodingDict.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()的返回值相对应

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

  • 最后,我使用了两个 验证 注释。我已经在 名称 字段上配置了必需的字段验证器,并在 年龄 字段上配置了整数范围验证器。我还为验证指定了一条自定义消息。

配置文件

我们真的不需要 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 文件。然后将这个WAR部署到Tomcat的webapps目录中。最后,启动Tomcat服务器并尝试访问URL http:// localhost:8080 / HelloWorldStruts2 / index.jsp 。这将产生以下屏幕 -

Email用户输入

现在不要输入任何所需的信息,只需点击 提交 按钮。你会看到下面的结果 -

错误

输入所需的信息,但输入错误的From字段,让我们说,名称为“测试”,年龄为30,最后点击 提交 按钮。你会看到下面的结果 -

成功