詳解Java的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
現(xiàn)在，讓我們看看你如何能做到配置在struts.xml文件，取而代之的是注解。
Struts2注釋的概念的解釋，我們需要重新考慮我們的驗證為例說明在 Struts2的驗證 一章中。
在這里，我們將采取一個例子，雇員Employee 將被捕獲的姓名和年齡使用一個簡單的頁面，我們將會把兩個驗證，以確保使用總是進入一個名字和年齡應該是在28和65之間。所以，讓我們先從主JSP頁面的例子。
創(chuàng)建主頁：
讓我們寫主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的標簽，我們還沒有覆蓋，但我們將研究這些標簽相關的章節(jié)。但現(xiàn)在，假設s:textfield 標簽打印一個輸入字段 s:submit 打印一個提交按鈕。我們已經(jīng)使用label屬性標簽，每個標簽每個標簽創(chuàng)建。
創(chuàng)建視圖：
我們將使用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>
創(chuàng)建動作：
這是將用于注釋的地方。讓我們重新定義行動Employee類的注釋，然后添加一個方法稱為validate() ，如下所示在Employee.java文件。請確保操作類擴展ActionSupport類，否則validate方法將不會被執(zhí)行。
package com.yiibai.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;
}
}
在這個例子中，我們已經(jīng)使用了一些注解。讓我逐個說明：
首先，我們已經(jīng)Result注解。結果注解的結果是一個集合。結果注解下，我們有兩個結果注釋。結果注釋的名稱對應的執(zhí)行方法的結果。它們還含有一個視圖應擔任相應的execute() 返回值的位置。
下一個注解是行動注解。這是用來修飾 execute()方法。操作方法也需要一個值，該URL上調用操作。
最后，使用兩個驗證的注解。已經(jīng)配置了所需的字段驗證的年齡字段"name“字段和整數(shù)范圍驗證。也指定了自定義驗證消息。
配置文件：
我們不需要struts.xml 配置文件，讓我們刪除該文件，并讓我們檢查web.xml文件中的內(nèi)容：
<?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>
現(xiàn)在，右鍵點擊項目名稱，并單擊 Export > WAR File創(chuàng)建一個WAR文件。然后部署此WAR在Tomcat的webapps目錄下。最后，啟動Tomcat服務器和嘗試訪問URL http://localhost:8080/HelloWorldStruts2/index.jsp。這會給出以下畫面：
現(xiàn)在不輸入任何所需信息，只需點擊“Submit ”按鈕。將看到以下結果：
輸入所需的信息，但輸入了錯誤的“From ”字段，讓我們說“test”和年齡為30名，最后點擊“Submit ”按鈕。將看到以下結果：
Struts 2的注釋類型
Struts 2 應用程序可以使用Java5注釋作為替代XML和Java屬性配置?？梢詸z查最重要的注解涉及不同類別的列表：
Struts 2 應用程序可以使用Java5注釋作為替代XML和Java屬性配置。這里是清單的不同的類別有關的最重要的注解：
命名空間注釋（動作注釋）：
@ Namespace注釋允許在Action類中，而不是基于零配置的約定動作的命名空間的定義。
@Namespace("/content")
public class Employee extends ActionSupport{
...
}
結果注釋 - （動作譯注）：
@ Result注解允許在Action類中，而不是一個XML文件中定義的動作結果。
@Result(name="success", value="/success.jsp")
public class Employee extends ActionSupport{
...
}
結果注釋 - （動作譯注）：
@ Results注解定義了一套動作的結果。
@Results({
@Result(name="success", value="/success.jsp"),
@Result(name="error", value="/error.jsp")
})
public class Employee extends ActionSupport{
...
}
注釋后（攔截注釋）：
@After注解標志著一個需要調用后的主要操作方法和執(zhí)行結果的操作方法。返回值將被忽略。
public class Employee extends ActionSupport{
@After
public void isValid() throws ValidationException {
// validate model object, throw exception if failed
}
public String execute() {
// perform secure action
return SUCCESS;
}
}
注釋之前（攔截注釋）：
@ Before注釋標記需要一個操作方法的主要操作方法之前被調用執(zhí)行結果。返回值將被忽略。
public class Employee extends ActionSupport{
@Before
public void isAuthorized() throws AuthenticationException {
// authorize request, throw exception if failed
}
public String execute() {
// perform secure action
return SUCCESS;
}
}
BeforeResult注釋 - （攔截注釋）：
@ BeforeResult注解標志著一個結果之前需要執(zhí)行的操作方法。返回值將被忽略。
public class Employee extends ActionSupport{
@BeforeResult
public void isValid() throws ValidationException {
// validate model object, throw exception if failed
}
public String execute() {
// perform action
return SUCCESS;
}
}
ConversionErrorFieldValidator注釋 - （驗證譯注）：
此驗證注解如果有任何轉換錯誤進行了實地檢查，并適用于他們，如果他們存在。
public class Employee extends ActionSupport{
@ConversionErrorFieldValidator(message = "Default message",
key = "i18n.key", shortCircuit = true)
public String getName() {
return name;
}
}
DateRangeFieldValidator注釋 - （驗證譯注）：
這驗證注解檢查日期字段的值在指定范圍內(nèi)。
public class Employee extends ActionSupport{
@DateRangeFieldValidator(message = "Default message",
key = "i18n.key", shortCircuit = true,
min = "2005/01/01", max = "2005/12/31")
public String getDOB() {
return dob;
}
}
DoubleRangeFieldValidator注釋 - （驗證譯注）：
此驗證注解檢查雙字段有一個值，該值在指定范圍內(nèi)。如果既不最小或最大，什么都不會做的。
public class Employee extends ActionSupport{
@DoubleRangeFieldValidator(message = "Default message",
key = "i18n.key", shortCircuit = true,
minInclusive = "0.123", maxInclusive = "99.987")
public String getIncome() {
return income;
}
}
EmailValidator注釋 - （驗證譯注）：
這驗證注解檢查一個字段是一個有效的E-mail地址，如果它包含一個非空的字符串。
public class Employee extends ActionSupport{
@EmailValidator(message = "Default message",
key = "i18n.key", shortCircuit = true)
public String getEmail() {
return email;
}
}
ExpressionValidator注釋 - （驗證譯注）：
這種非字段級驗證驗證所提供的正則表達式。
@ExpressionValidator(message = "Default message", key = "i18n.key",
shortCircuit = true, expression = "an OGNL expression" )
IntRangeFieldValidator注釋 - （驗證譯注）：
這驗證注解檢查一個數(shù)字字段的值在指定的范圍內(nèi)。如果既不最小或最大，什么都不會做的。
public class Employee extends ActionSupport{
@IntRangeFieldValidator(message = "Default message",
key = "i18n.key", shortCircuit = true,
min = "0", max = "42")
public String getAge() {
return age;
}
}
RegexFieldValidator 注釋 - （驗證譯注）：
這個注解驗證一個字符串字段，使用正則表達式。
@RegexFieldValidator( key = "regex.field", expression = "yourregexp")
RequiredFieldValidator 注釋 - （驗證譯注）：
這驗證注解檢查一個字段不為空。標注必須被應用在方法層面。
public class Employee extends ActionSupport{
@RequiredFieldValidator(message = "Default message",
key = "i18n.key", shortCircuit = true)
public String getAge() {
return age;
}
}
RequiredStringValidator注釋 - （驗證譯注）：
這驗證注解檢查一個字符串字段不為空（即非空，長度> 0）。
public class Employee extends ActionSupport{
@RequiredStringValidator(message = "Default message",
key = "i18n.key", shortCircuit = true, trim = true)
public String getName() {
return name;
}
}
StringLengthFieldValidator注釋 - （驗證譯注）：
這個驗證檢查字符串字段是合適的長度。假定該字段是一個字符串。如果設置既不是minLength 也不是最大長度，什么都不會做。
public class Employee extends ActionSupport{
@StringLengthFieldValidator(message = "Default message",
key = "i18n.key", shortCircuit = true,
trim = true, minLength = "5", maxLength = "12")
public String getName() {
return name;
}
}
UrlValidator注釋 - （驗證譯注）：
這個驗證檢查一個字段是一個有效的URL。
public class Employee extends ActionSupport{
@UrlValidator(message = "Default message",
key = "i18n.key", shortCircuit = true)
public String getURL() {
return url;
}
}
驗證注釋 - （驗證譯注）：
如果想使用多個相同類型的注釋，這些注釋必須嵌套在@Validations() 注釋。
public class Employee extends ActionSupport{
@Validations(
requiredFields =
{@RequiredFieldValidator(type = ValidatorType.SIMPLE,
fieldName = "customfield",
message = "You must enter a value for field.")},
requiredStrings =
{@RequiredStringValidator(type = ValidatorType.SIMPLE,
fieldName = "stringisrequired",
message = "You must enter a value for string.")}
)
public String getName() {
return name;
}
}
CustomValidator注釋 - （驗證譯注）：
這個注解可以用于自定義驗證。使用ValidationParameter的注釋，以提供額外的 params.
@CustomValidator(type ="customValidatorName", fieldName = "myField")
轉換注釋 - （類型轉換注釋）：
這是一個標記注釋類型轉換類型級別。轉換注釋必須應用在類型級別。
@Conversion()
public class ConversionAction implements Action {
}
CreateIfNull注釋 - （類型轉換注釋）：
這個注解設置類型轉換CreateIfNull。必須應用在域或方法級CreateIfNull注解。
@CreateIfNull( value = true ) private List<User> users;
元素注釋 - （類型轉換注釋）：
這個注解設置元素進行類型轉換。必須應用在字段域或方法級元素的注解。
@Element( value = com.acme.User ) private List<User> userList;
關鍵注釋 - （類型轉換注釋）：
這個注解設置進行類型轉換的關鍵。必須應用在域或方法級的關鍵注解。
@Key( value = java.lang.Long.class ) private Map<Long, User> userMap;
KeyProperty注釋 - （類型轉換注釋）：
這個注解設置類型轉換KeyProperty。必須應用在域或方法級KeyProperty注解。
@KeyProperty( value = "userName" ) protected List<User> users = null;
TypeConversion注釋 - （類型轉換注釋）：
這個注解的注解是用于類和應用程序的轉換規(guī)則。注解可以應用于TypeConversion在屬性和方法的級別。
@TypeConversion(rule = ConversionRule.COLLECTION,
converter = "java.util.String")
public void setUsers( List users ) {
this.users = users;
}
相關文章
Netty分布式ByteBuf使用SocketChannel讀取數(shù)據(jù)過程剖析
這篇文章主要為大家介紹了Netty源碼分析ByteBuf使用SocketChannel讀取數(shù)據(jù)過程，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2022-03-03
這篇文章主要為大家詳細介紹了如何利用Java語言實現(xiàn)讀取Jar文件屬性的功能，文中的示例代碼講解詳細，感興趣的小伙伴可以跟隨小編一起學習一下2022-08-08
這篇文章主要介紹了RocketMQ中的消費者啟動流程解讀,RocketMQ是一款高性能、高可靠性的分布式消息中間件,消費者是RocketMQ中的重要組成部分,消費者負責從消息隊列中獲取消息并進行處理,需要的朋友可以參考下2023-10-10
這篇文章主要介紹了Java中深拷貝和淺拷貝的區(qū)別解析,淺拷貝是源對象和拷貝對象的存放地址不同,但被復制的源對象的引用類型屬性存放的地址仍然和源對象的引用類型屬性相同,修改引用類型屬性的屬性會影響相互影響,需要的朋友可以參考下2024-01-01
這篇文章主要為大家詳細介紹了java字符流緩沖區(qū)的相關資料，具有一定的參考價值，感興趣的小伙伴們可以參考一下2017-08-08
這篇文章主要介紹了springboot集成Swagger2的方法，幫助大家更好的理解和使用springboot框架，感興趣的朋友可以了解下2020-12-12
spring的jdbctemplate的crud的基類dao
本文主要介紹了使用spring的jdbctemplate進行增刪改查的基類Dao的簡單寫法,需要的朋友可以參考下2014-02-02
這篇文章主要給大家介紹了關于Spring MVC項目開發(fā)踩過的一些bug，文中通過圖文介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2020-11-11
Java開發(fā)環(huán)境配置教程(win7 64bit)
這篇文章主要為大家詳細介紹了win7 64bit下Java開發(fā)環(huán)境的配置教程，具有一定的參考價值，感興趣的小伙伴們可以參考一下2017-08-08
本文主要介紹了java中@requestMappling注解的使用，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2023-01-01