Struts2 注釋類型

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注解標誌著一個需要調用後的主要操作方法和執行結果的操作方法。返回值將被忽略。

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注釋標記需要一個操作方法的主要操作方法之前被調用執行結果。返回值將被忽略。

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注解標誌著一個結果之前需要執行的操作方法。返回值將被忽略。

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注釋 - （驗證譯注）：

這驗證注解檢查日期字段的值在指定範圍內。

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注釋 - （驗證譯注）：

此驗證注解檢查雙字段有一個值，該值在指定範圍內。如果既不最小或最大，什麼都不會做的。

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注釋 - （驗證譯注）：

這驗證注解檢查一個數字字段的值在指定的範圍內。如果既不最小或最大，什麼都不會做的。

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注釋 - （類型轉換注釋）：

這個注解的注解是用於類和應用程式的轉換規則。注解可以應用於TypeConversion在屬性和方法的級別。

@TypeConversion(rule = ConversionRule.COLLECTION,
converter = "java.util.String")
public void setUsers( List users ) {
   this.users = users;
}