Struts2教學 » Struts2 注釋

Struts2 注釋

正如前面提到的，Struts提供了兩種形式的組態。傳統的方式是使用對所有組態struts.xml檔案。到目前為止，我們已經看到了這樣的例子很多。 Struts組態的另一種方法是使用Java5註釋功能。使用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

現在，讓我們看看你如何能做到組態在struts.xml檔案，取而代之的是註解。

Struts2注釋的概念的解釋，我們需要重新考慮我們的驗證為例說明在 Struts2的驗證 一章中。

在這裡，我們將採取一個例子，雇員Employee 將被捕獲的姓名和年齡使用一個簡單的頁面，我們將會把兩個驗證，以確保使用總是進入一個名字和年齡應該是在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 列印一個提交按鈕。我們已經使用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.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;
   }
}

在這個例子中，我們已經使用了一些註解。讓我逐個說明：

  • 首先，我們已經Result註解。結果註解的結果是一個集合。結果註解下，我們有兩個結果注釋。結果注釋的名稱對應的執行方法的結果。它們還含有一個檢視應擔任相應的execute() 返回值的位置。

  • 下一個註解是行動註解。這是用來修飾 execute()方法。操作方法也需要一個值，該URL上呼叫操作。

  • 最後，使用兩個驗證的註解。已經組態了所需的欄位驗證的年齡欄位"name“欄位和整數範圍驗證。也指定了自定義驗證訊息。

組態檔案：

我們不需要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>

現在，右鍵點選專案名稱，並單擊 Export > WAR File建立一個WAR檔案。然後部署此WAR在Tomcat的webapps目錄下。最後，啟動Tomcat伺服器和嘗試存取URL http://localhost:8080/HelloWorldStruts2/index.jsp。這會給出以下畫面：

Email User Input

現在不輸入任何所需資訊，只需點選“Submit ”按鈕。將看到以下結果： 

Error

輸入所需的資訊，但輸入了錯誤的“From ”欄位，讓我們說“test”和年齡為30名，最後點選“Submit ”按鈕。將看到以下結果：

Success

Struts 2的註釋型別：

Struts 2 應用程式可以使用Java5注釋作為替代XML和Java屬性組態。可以檢查最重要的註解涉及不同類別的列表：

Struts 2的註釋型別.