如前所述,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 .这将生成以下屏幕 :
现在请勿输入任何必填信息,只需点击提交按钮即可.您将看到以下结果 :
输入所需信息,但输入错误的From字段,让我们说名称为"test",年龄为30,最后点击提交按钮.您将看到以下结果 :
Struts 2应用程序可以使用Java 5注释作为XML和Java属性配置的替代方法.您可以查看与不同类别相关的最重要注释列表 :
Struts 2注释类型