DIV CSS 佈局教程網

以 Stripes 框架進行 Java Web 開發
編輯:JavaScript綜合知識     

Stripes 是一款以「讓程式員的 Web 開發既簡單又高效」為設計準則的開源 Java Web 框架,屬於基於動作(Action-based)的類型。本文將說明它與 Struts 等類似框架的差異,以及它如何提供近似 Ruby on Rails 的簡潔開發體驗。

傳統的 Java Web 開發著眼於透過解耦(Decoupling)來換取靈活性,卻導致設定檔繁多、額外物件與資源分散等問題,這些障礙讓不少程式員付出更高的學習成本與更低落的效率。結果是部分 Java 程式員被 Ruby on Rails 或 Django 等非 Java 框架吸引。像 Stripes 這樣的 Java Web 框架,正開始從這些非 Java 框架汲取成功經驗——簡單而高效的開發。基本上它就是一個 MVC 框架,而與其他基於動作的框架最大的不同在於:它沒有一個外部設定檔。我們稍後會看到,Stripes 以 annotation 與「約定」取代「設定」,藉此提升產出並減少雜亂。

撰寫第一個 Stripes 動作(Action)

我們現在就透過建立 Hello World 範例來認識 Stripes 並理解其運作。HelloWorldAction 類別會提示使用者輸入姓氏與名字,再在另一個檢視中顯示。先來撰寫 controller 類別:

public class HelloWorldAction implements ActionBean
{
@ValidateNestedProperties(
{
@Validate(field = "firstName", required = true, on = {"hello"}),
@Validate(field = "age", required = true, minvalue = 13, on = {"hello"})
})
private Person person;
private ActionBeanContext context;
@DefaultHandler public Resolution index()
{
return new ForwardResolution("Hello.jsp");
}
public Resolution hello()
{
return new ForwardResolution("SayHello.jsp");
}
public void setPerson(String person) { this.person = person; }
public String getPerson() { return person; }
public void setContext(ActionBeanContext c) { this.context = c; }
public ActionBeanContext getContext() { return context; } }

Controller 類別是一個實作了 Stripes 專有介面 ActionBean 的 POJO。所有 Stripes 動作類別都必須實作此介面,好讓 StripesDispatcher servlet 在執行時為它注入一個 ActionBeanContext 物件。ActionBeanContext 讓你能存取 request、response、servlet context 等 Servlet API 物件,但大多數時候在 Stripes 應用中並不需要讀取這些底層物件。ActionBeanContext 類別還能提供目前動作的狀態,並可加入訊息與錯誤訊息;由於所有 Stripes 動作都要實作它,因此這些變數與其讀寫方法通常會被放進一個基底類別中。

Controller 類別的其他部分對任何 Java 程式員而言都很熟悉:有一個 Person 物件及其讀寫方法,用來把使用者姓名讀寫給檢視。雖然這只是簡單的嵌套物件,但 Stripes 還能透過 Java 集合、泛型支援與下標化屬性來處理更複雜的資料捆綁。由於 Stripes 能處理複雜的資料捆綁,你的領域物件(Domain Object)得以在其他需要它們的層重用;例如你可以輕易用 Stripes 收集領域物件資訊,再用 Hibernate 或 EJB3 等 POJO 框架將其持久化。

Person 物件變數上有一個 Stripes 驗證 annotation,用來確保使用者在觸發 hello 方法時已輸入姓名。若使用者未填這兩個必填欄位,原始頁面會被返回並顯示相關錯誤訊息。由於 annotation 屬性中指定了 (on = {"hello"}),此驗證只有在 hello 事件被請求時才會啟動。Stripes 還會依「實用預設法則」,根據驗證方法與變數名稱自動產生錯誤訊息。例如,若提交時未提供 Person 類別的 firstName 變數,使用者會看到:

Person First Name is a required field.

這則訊息是將 Person.firstName 加以可讀化處理後得到的,若有需要,這些訊息都可被覆寫以提供更進一步的客戶自訂。

此外還有一個 Integer 型別的變數 age,是 Person 物件的屬性。Stripes 會先嘗試把 request 中名為 person.age 的參數轉為 Integer 並綁定到 Person 物件上;赋值後,再驗證該整數是否小於 13。若使用者輸入字串而非整數,會看到:

The value (Mark) entered in field Person Age must be a valid number.

若輸入一個小於 13 的整數,則會看到:

The minimum allowed value for Age is 13.

同樣地,我們不必為這些錯誤訊息提供任何外部設定檔。annotation 提供的驗證與變數位於同一處,讓程式員定位、理解與維護驗證都更加容易。

這個 Stripes 動作還有兩個可被觸發的方法(稱為事件),事件是 ActionBean 類別中具備如下簽名的方法:

public Resolution eventName

請注意 index 方法被標註為 @DefaultHandler。由於本動作有多個事件,其中必須指定一個為預設事件;若呼叫本動作的 URL 未指明事件,Stripes 便會找出標註有 @DefaultHandler 的事件並執行。

顯示層(View)

現在為 Hello World 範例加上顯示層邏輯。Stripes 預設以 JSP 作為標準顯示技術,但你也能改用 FreeMaker 等方案。除了 Stripes 的 tag 庫之外,沒有什麼新東西要學。Hello.jsp 是初始顯示畫面,供使用者輸入並提交姓名:

<%@ taglib prefix="stripes" uri="https://stripes.sourceforge.net/stripes.tld" %>
......
<stripes:errors/>
<stripes:form beanclass="com.myco.web.stripes.action.example.HelloWorldAction"> Say hello t
First name:
<stripes:text name="person.firstName"/><br>
Age:<stripes:text name="person.age"/><br>
<stripes:submit name="hello" value="Say Hello" />
</stripes:form>
......

這個 JSP 易讀易維護,而 Stripes 用於 form 與 input 的 tag 和對應的 HTML 碼非常相似。stripes:form tag 含有一個 beanclass 屬性,其值就是前面定義的 controller 類別完整類名。我們也可以用 action 屬性來取代 beanclass,但 beanclass 能讓日後重構 Stripes 動作時更方便。若要在 stripes:form 中使用 action 屬性,寫法如下:

<stripes:form action="/example/HelloWorld.action">

有一個 stripes:input tag 指定了名為 person.firstName 的屬性,用來把輸入值賦給 controller 中 Person 物件的 firstName 變數。最後,stripes:submit tag 以 name 屬性告訴 Stripes 的 HelloWorldAction 要使用哪一個事件。

完成姓名提交後,剩下的就是在另一個檢視中把結果回饋給使用者:

<%@ taglib prefix="stripes" uri="https://stripes.sourceforge.net/stripes.tld" %>
......
<stripes:errors/>
<h2>Hello {actionBean.person.firstName} your age is {actionBean.person.age}</h2><p/>
<stripes:link beanclass="com.myco.web.stripes.action.example.HelloWorldAction"> Say Hello Again
</stripes:link>
......

這個 JSP 透過對動作的參照讀取 person 的姓名並顯示。為此,Stripes 會自動在 request 屬性中加入一個名為 actionBean 的動作物件,供 JSTL 存取。最後我們用一個 stripes:link tag 建立返回 HelloWorldAction 的連結,以便輸入不同姓名。若要顯式建立指向 index 事件的 stripes:link,可寫成:

<stripes:link beanclass="com.myco.web.stripes.action.example.HelloWorldAction" event="index">
Say Hello Again
</stripes:link>

由於我們已用 annotation 把 index 方法標記為 @DefaultHandler,Stripes 無須 event 屬性也知道要執行哪個方法。

用約定、不用設定檔

有了 Java 元件後,接下來該做設定了——把動作對應到某個 URL,並連接到兩個檢視。等等!我們在用 Stripes,根本不需要外部設定檔!

雖然聽起來好得不像真的,但這確實是 Stripes 最具生產力的一項功能。Stripes 以約定而非設定檔來把動作對應到 URL,也無須用外部設定檔把檢視對應到各個標記名稱,這代表程式員不必再為了追問某個標記名稱(例如 SUCCESS)的實際來源而在設定檔間跳來跳去。由於不必在 Java 與檢視元件外部進行配線,維護性與生產力都隨之提升。

Stripes 是如何在不必於外部逐一設定每個動作或額外 annotation 的情況下,提供隱式的 URL 對應呢?這可從它在 web.xml 中的設定,以及它如何以「實用預設法」建立 URL 對應來解釋。首先看 Servlet 過濾器 StripesFilter,其於 web.xml 中的預設設定如下:

<filter>
<display-name>Stripes Filter</display-name>
<filter-name>StripesFilter</filter-name>
<filter-class> net.sourceforge.stripes.controller.StripesFilter </filter-class>
<init-param>
<param-name>ActionResolver.UrlFilters</param-name>
<param-value>/WEB-INF/classes</param-value>
</init-param>
</filter>

當 Servlet 容器啟動時,StripesFilter 會對其 init-param 元素執行初始化,其中最重要的就是 ActionResolver.UrlFilters 參數。它告訴 Stripes 到哪裡尋找與 Stripes 相關的類別。在此範例中,Stripes 會查找 /WEB-INF/classes 目錄下所有實作 ActionBean 介面的類別,並把找到的每個類別及其綁定的 URL 加入一個 Map。

以我們的 HelloWorldAction 為例:由於它位於 /WEB-INF/classes 目錄下,會被視為 Stripes servlet。其完整類名為 com.myco.web.stripes.action.example.HelloWorldAction,接著會依下列規則被翻譯成一個 URL 綁定:

1. 刪去含 www、web、stripes、action 的部分及其之前的內容。此例有三個上述單詞,得到 example.HelloWorldAction。

2. 若類名含有 Action 或 Bean 結尾,刪去。由於類名以 Action 結尾,得到 example.HelloWorld。

3. 把 . 替換為 /,得到 example/HelloWorld。

4. 最後加上一個尾綴(預設是 .action),完成 URL 綁定,結果為 example/HelloWorld.action。

現在 Stripes 找到了 ActionBean 類別並為其建立 URL 綁定,存於 java.util.Map 之中,其中 key 是 URL 綁定,value 是實作 ActionBean 的類名。本例的 Map 為:

URL 綁定:/example/HelloWorld.action
ActionBean 類別:com.myco.web.stripes.action.example.HelloWorldAction

第二個要看的元件,是 Stripes 如何把 URL 綁定翻譯回你正在使用的 ActionBean 類別,這是 Stripes 調度 servlet 的職責,其於 web.xml 中的設定如下:

<servlet>
<servlet-name>StripesDispatcher</servlet-name>
<servlet-class>
net.sourceforge.stripes.controller.DispatcherServlet </servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>StripesDispatcher</servlet-name>
<url-pattern>*.action</url-pattern>
</servlet-mapping>

StripesDispatcher 的一項職責就是把 URL 解析為 Stripes 的 ActionBean 類別。當使用者請求 https://host/uri/example/HelloWorld.action 時,調度 servlet 會在 URL 對應表中查到 com.myco.web.stripes.action.example.HelloWorldAction 類別並加以實例化;最後 index 方法被觸發,因為它在 annotation 中被定義為預設處理器,而該 URL 並未指定事件。

若想直接執行 HelloWorldAction 中的 hello 方法,可把事件名稱放進 request 參數中:

https://host/uri/example/HelloWorld.action?hello=&firstName=Mark&age=13

請注意我們並未給 hello 這個 request 參數指定任何值。此時 StripesDispatcher 會把 hello 這個參數名與 HelloWorldAction 中帶有 public Resolution hello() 簽名的函式相識別並對應,該方法名會在初始化時為了效能而快取在另一個 Map 中。

我們已看到 Stripes 的基礎與運作細節。透過在 web.xml 中初始化,我們得以避免用多個獨立 XML 設定檔來把顯示層元件寫在一起。這麼做之所以重要,原因有三:其一,任何改動都能從一個 URL 立即知道該查看哪個類別;其二,不必再仰賴外部工具來管理過大而難以維護的設定檔;其三,透過消除設定檔,我們不再需要餵給框架一大堆 metadata,也不必再維護一個描述元件如何關聯的獨立檔案。

Ajax

想要更高階的功能?我們來看 Stripes 如何處理 Ajax。我們把先前的 Hello World 範例改成用 Ajax 呼叫 Stripes 動作。首先修改 Hello.jsp 以引用 Prototype JavaScript 函式庫,並為 Ajax 呼叫新增一個 JavaScript 函式,同時把提交按鈕加上 onclick 事件:

<%@ taglib prefix="stripes" uri="https://stripes.sourceforge.net/stripes.tld" %>
......
<script src="{pageContext.request.contextPath}/js/prototype.js" type="text/javascript"></script>
<script type="text/javascript">
function sayHelloAjax(){
var myAjax = new Ajax.Updater('hello', "<stripes:url beanclass="com.myco.web.stripes.action.example.HelloWorldAction" event="sayHelloAjax"/>", { method: 'get', parameters: Form.serialize('helloForm') });
}
</script>
......
<stripes:errors/>
<stripes:form beanclass="com.myco.web.stripes.action.example.HelloWorldAction" id="helloForm">
Say hello t
First name:
<stripes:text name="person.firstName"/><br>
Age:<stripes:text name="person.age"/><br>
<stripes:button name="helloAjax" value="Say Hello" onclick="sayHelloAjax()" />
<div id="hello"></div>
</stripes:form> ......

stripes:button 有一個 onclick 事件,會呼叫 HelloWorldAction 中的 sayHelloAjax 方法,並把結果回傳到名為 hello 的 div tag 中。以下是我們要在 HelloWorldAction 中新增的方法:

public Resolution sayHelloAjax()
{
return new ForwardResolution("SayHelloAjax.jsp");
}

這個方法工作量不多,因為 Stripes 已承擔了姓名內容的綁定,它唯一的責任就是轉發到一個名為 SayHelloAjax.jsp 的頁面片段。該片段內容如下:

<h2>Hello {actionBean.person.firstName} your age is {actionBean.person.age}!</h2>

Spring 整合

Stripes 還內建了對 Spring 的支援,你能自動把 Spring bean 注入到動作中。依 Stripes 的風格,除了 Spring 上下文設定檔之外不需要任何外部設定檔。若我們的 Spring 設定檔如下:

<bean id="personService" parent="abstractTxDefinition">
<property name="target">
<bean class="com.myco.service.impl.PersonServiceImpl"/>
</property>
</bean>

要把 person 服務注入到一個 Stripes 動作中,需加上一個與 Spring bean 名稱一致的屬性和 setter。Stripes 提供 @SpringBean annotation 來查詢正確的 Spring bean 並注入動作。以下是我們要放進動作類別的範例:

private PersonService personService;
@SpringBean public void setBlogService(BlogService blogService)
{
this.blogService = blogService;
}

本文無法涵蓋 Stripes 的所有進階功能,但它擁有相當完整的文件。Stripes 還包含一個類似 Tiles、卻無須外部設定檔的版面配置管理器,攔截器也可用於生命週期事件的各處、檔案上載等等。

結論

Stripes 是一款既強大又簡單的 Java Web 框架。它善用 Java 5 的 annotation 與泛型功能,讓 Java 程式員免於維護外部設定檔並提升工作效率。Stripes 能簡化繁難的 Web 開發工作,並讓簡單的工作變得更簡單!

 

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved