Seam無縫整合 JSF: 藉助 Seam 進行對話

                

  org.springframework.web.jsf.DelegatingVariableResolver

                

  courseAction
  com.ibm.dw.open18.CourseAction
  
    courseManager
    #{courseManager}
  

                
@Name("courseAction")
public class CourseAction {
    @In("#{courseManager}")
    private GenericManager courseManager;
}

                
Courses

  No courses found.


  <!-- column definitions go here --&gt

                
public class CourseAction {
    // ...

    private DataModel coursesModel = new ListDataModel();

    public DataModel getCourses() {
        System.out.println("Retrieving courses...");
        coursesModel.setWrappedData(courseManager.getAll());
        return coursesModel;
    }
    
    public void setCourses(DataModel coursesModel) {
        this.coursesModel = coursesModel;
    }
}

Retrieving courses...
Retrieving courses...
Retrieving courses...

                
public class CourseAction {
    // ...

    private DataModel coursesModel = null;

    public DataModel getCourses() {
        if (coursesModel == null) {
            System.out.println("Retrieving courses...");
            coursesModel = new ListDataModel(courseManager.getAll());
        }
        return coursesModel;
    }
    
    public void setCourses(DataModel coursesModel) {
        this.coursesModel = coursesModel;
    }
}

                
@Name("courseAction")
public class CourseAction {
    // ...

    @DataModel
    private List courses;
    
    @Factory("courses")
    public void findCourses() {
        System.out.println("Retrieving courses...");
        courses = courseManager.getAll();
    }
}

                
Courses

  No courses found.


  <!-- column definitions goes here --&gt

 Retrieving courses...

                
Courses

  No courses found.


  
    Course Name
    
  
  <!-- additional properties --&gt

                
@Name("courseAction")
@Scope(ScopeType.CONVERSATION)
public class CourseAction implements Serializable {
    // ...

    @DataModel
    private List courses;
  
    @DataModelSelection
    private Course selectedCourse;
    
    @Begin(join=true)
    @Factory("courses")
    public void findCourses() {
        System.out.println("Retrieving courses...");
        courses = courseManager.getAll();
    }
  
    public String selectCourse() {
        System.out.println("Selected course: " + selectedCourse.getName());
        System.out.println("Redirecting to /courses.jspx");
        return "/courses.jspx";
    }
}

Retrieving courses...
Selected course: Sample Course
Redirecting to /courses.jspx

Retrieving courses...
Selected course: Sample Course
Redirecting to /courses.jspx
Retrieving courses...

                
    // ...

    @DataModelSelection
    @Out(value="course", required=false)
    private Course selectedCourse;
    
    public String selectCourse() {
        System.out.println("Selected course: " + selectedCourse.getName());
        // refetch the course, loading all lazy associations
        selectedCourse = courseManager.get(selectedCourse.getId());
        System.out.println("Redirecting to /courses.jspx");
        return "/courses.jspx";
    }

    // ...

                

  
Course Detail
  
    <!-- additional properties --&gt


    

      
Course Name
      
#{course.name}
    














回頁首



重新注入課程
Open 18 應用程式最複雜的用例是建立和更新操作。但是藉助 Seam，實現起來並不困難。要完成這兩項需求，必須使用一個額外的註釋：@In。將課程提取到呈現課程編輯器表單的檢視之後，必須在回發時捕獲已更新的物件。就像使用 @Out 將變數推送到檢視中一樣，可以使用 @In 在回發時重新捕獲它們。
當使用者處理載入到表單中的課程資訊時，該課程實體耐心地在 conversation 作用域中等待。因為應用程式使用無狀態的服務介面，所以此時的課程例項看作已經與持久化上下文 “分離”。提交該表單時，最終到達 JSF 的更新模型值（Update Model Value）階段。此時，與表單中欄位有關的課程物件將收到使用者的更新。當呼叫該操作方法時，必須重新使已更新的物件與持久化上下文建立聯絡。通過使用 save() 方法將該物件傳遞迴服務層，就可以實現。
但是等等 —— 驗證在哪裡？您肯定不希望無效資料損壞您的資料庫！另一方面，您可能不希望驗證標記打亂您的檢視模板。您甚至可能同意驗證程式碼不屬於檢視層的說法。幸運的是，Seam 負責完成 JSF 驗證的瑣碎工作！
藉助 Seam 和 Hibernate 進行驗證
如果您將整個表單包裝到一個 s:validateAll 元件標記中， Seam 允許您在 JSF 的流程驗證（Process Validation）階段執行對資料模型定義的驗證。這種驗證方法比以下方法更有吸引力：在檢視中到處設定 JSF 驗證器標記，或者維護一個配置檔案，寫滿針對第三方驗證框架的驗證定義。取而代之，可以使用 Hibernate Validator 註釋向實體類屬性指派驗證標準，如清單 13 所示。然後 Hibernate 在持久化物件時，對驗證進行兩次檢查，為您提供雙重保護。這個雙重保障方法意味著檢視中不小心出現的 bug 沒有任何機會危害您的資料質量。（請參閱 參考資料 瞭解關於 Hibernate Validator 的更多內容。）

清單 13. 帶有 Hibernate 驗證註釋的課程實體




                
@Entity
@Table(name = "course")
public class Course implements Serializable {

    private long id;
    private String name;
    private CourseType type = CourseType.PUBLIC;
    private Address address;
    private String uri;
    private String phoneNumber;
    private String description;

    public Course() {}

    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    @Column(name = "id")
    @NotNull
    public long getId() {
        return this.id;
    }

    public void setId(long id) {
        this.id = id;
    }

    @Column(name = "name")
    @NotNull
    @Length(min = 1, max = 50)
    public String getName() {
        return this.name;
    }

    public void setName(String name) {
        this.name = name;
    }

    @Column(name = "type")
    @Enumerated(EnumType.STRING)
    @NotNull
    public CourseType getType() {
        return type;
    }

    public void setType(CourseType type) {
        this.type = type;
    }

    @Embedded
    public Address getAddress() {
        return address;
    }
    
    public void setAddress(Address address) {
        this.address = address;
    }
    
    @Column(name = "uri")
    @Length(max = 255)
    @Pattern(regex = "^https?://.+$", message = "validator.custom.url")
    public String getUri() {
        return this.uri;
    }

    public void setUri(String uri) {
        this.uri = uri;
    }

    @Column(name = "phone")
    @Length(min = 10, max = 10)
    @Pattern(regex = "^\\d*$", message = "validator.custom.digits")
    public String getPhoneNumber() {
        return this.phoneNumber;
    }

    public void setPhoneNumber(String phoneNumber) {
        this.phoneNumber = phoneNumber;
    }

    @Column(name = "description")
    public String getDescription() {
        return this.description;
    }

    public void setDescription(String description) {
        this.description = description;
    }

    // equals and hashCode not shown
}



只需少量步驟 ...
課程物件僅在回發時注入，而回發是使用者提交課程編輯器表單觸發的，不是由每個涉及 courseAction 元件的請求觸發的。要想有條件地使用 @In 註釋，必須在定義它時將其 required 標誌設定為 false。這樣做可以確保 Seam 在找不到要注入的課程物件時不會發出警報。
當提交課程編輯器表單時，就可以注入以前提取的課程物件。要確保將該例項重新注入回同一屬性，則向 @In 註釋提供的名稱必須等價於 @Out 註釋所使用的名稱。作為新增這些內容的結果，selectedCourse 屬性現在擁有三個註釋。（情況變得複雜起來！）
還必須向支援 bean 提供三個額外的操作方法，以處理講述到的新 CRUD 操作。新註釋以及 addCourse()、editCourse() 和 saveCourse() 操作方法如清單 14 所示：

清單 14. 用於建立、編輯和儲存課程的其他操作




                
    // ...

    @DataModelSelection
    @In(value="course", required=false)
    @Out(value="course", required=false)
    private Course selectedCourse;
    
    public String addCourse() {
        selectedCourse = new Course();
        selectedCourse.setAddress(new Address());
        return "/courseEditor.jspx";
    }
    
    public String editCourse() {
        selectedCourse = courseManager.get(selectedCourse.getId());
        return "/courseEditor.jspx";
    }
    
    public String saveCourse() {
        // remove course from cached collection
        // optionally, the collection could be nullified, forcing a refetch
        if (selectedCourse.getId() > 0) {
            courses.remove(selectedCourse);
        }
        courseManager.save(selectedCourse);
        // add course to the cached collection
        // optionally, the collection could be nullified, forcing a refetch
        courses.add(selectedCourse);
        FacesMessages.instance().add("#{course.name} has been saved.");
        return "/courses.jspx";
    }

    // ...


課程編輯器頁面負責建立和更新。Seam 之所以這麼酷，是因為它能夠暗中指揮通訊，在這個例子中，是通過在您瀏覽頁面時將所選課程儲存在上下文中實現的。不需要使用 HttpSession 請求引數，也不需要想方設法儲存所選課程。而僅僅是提取想要公開的內容，並注入期望接收的內容。













回頁首



編輯器模板
從編輯器頁面（如清單 15 所示）觀察表單元件。該頁使用了以下兩個 Seam 元件標記，使得開發檢視的工作變得更加簡單：

s:decorate 結合 afterInvalidField facet 在每個輸入元件之後插入 s:message 元件，輸入元件使您不必在頁面中重複標記。 
s:validateAll 指導 Seam 將 Hibernate Validator 註釋結合到 JSF 驗證過程，以便在回發時驗證表單中的每個欄位。 
您不會在課程編輯器檢視頁面上發現任何本地 JSF 驗證器，因為 Seam 在利用 Hibernate Validator 時，完全不需使用本地驗證器。該頁面還顯示了 Seam 附帶的列舉轉換器 元件，以防您碰巧使用 Java 5 列舉型別。

清單 15. 課程編輯器檢視















回頁首



新增刪除功能
回顧程式碼片段，可以發現到目前為止重點內容大多涉及消除程式碼、選擇，而不是通過註釋描述功能，並由框架負責處理細節。這種簡單性允許您集中精力處理更復雜的問題，並新增深受大家喜歡的奇特 Ajaxian 效果。您可能尚未認識到只需再做少量工作，就可以實現所有 CRUD 操作 —— 實際上即將到達最後階段！
在應用程式中實現刪除功能是一項簡單的事情。只需向每行新增另一個 h:commandLink，該命令連結能啟用支援 bean 的刪除方法（deleteCourse()）。我們已經實現了公開所選課程的工作，僅僅需要將繫結到課程屬性的課程物件傳遞給 CourseManager 以終止該課程，如清單 16 中所示：

清單 16. 向 deleteCourse 新增命令連結




                

  
    Course Name
    
  
  
    Actions
    
  
  <!-- additional properties --&gt



在 deleteCourse() 方法中，如清單 17中所示，利用 Seam 的 FacesMessages 元件警告使用者正在發生的操作。該訊息是以典型的途徑在檢視中使用 h:messages JSF 元件顯示的。但是首先請注意，建立訊息是多麼簡單！您可以徹底拋棄以前令人頭疼的 JSF 工具類；Seam 可靠地消除了 JSF 以前的陰影。

清單 17. 向 deleteCourse 新增操作方法




                
    // ...

    public String deleteCourse() {
        courseManager.remove(selectedCourse.getId());
        courses.remove(selectedCourse);
        FacesMessages.instance().add(selectedCourse.getName() + " has been removed.");
        // clear selection so that it won't be shown in the detail pane
        selectedCourse = null;
        return "/courses.jspx";
    }

    // ...














回頁首



完整的課程列表
處理完所有 CRUD 操作，就即將完工了！剩下的惟一的一個步驟是將整個課程列表組裝到一起，如清單 18 所示：

清單 18. 完整的課程列表檢視




                
Courses




  No courses found.



  
    Course Name
    
  
  
    Location
    
  
  
    Phone Number
    Actions
    
      
      
    
  





  
Course Detail
  

    
    
    

      
Course Name
      
#{course.name} (#{course.type})
    
    

      
Website
      
#{course.uri}
    
    

      
Phone
      
#{course.phoneNumber}
    
    

      
State
      
#{course.address.state}
    
    

      
City
      
#{course.address.city}
    
    

      
ZIP Code
      
#{course.address.postalCode}
    
  
  
  
...#{course.description}
  



恭喜！您完成了第一個基於 Seam 的 CRUD 應用程式。













回頁首



結束語
在 無縫 JSF 系列第二篇文章中，您親自發現了 Seam 的 Java 5 註釋如何簡化程式碼，conversation 作用域如何自動在一系列請求期間管理狀態，以及如何同時使用 Seam 和 Hibernate Validator 對輸入資料執行資料模型驗證。
實際上可以使用 seam-gen 自動完成大多數 CRUD 工作（請參見 參考資料）， seam-gen 是 Ruby-on-Rails 樣式的 Seam 應用程式生成器。但是我希望您從本文的練習中瞭解到 Seam 不僅僅是另一個 Web 框架。採用 Seam 並不強制您拋棄 JSF 經驗。相反，Seam 是對 JSF 非常強大的擴充套件，實際上它增強了 JSF 的生命週期。Seam 和 JSF 結合起來可以順利地和任何無狀態的服務層或 EJB3 模型進行整合。
既然已經瞭解 Seam 減輕 JSF 開發的一些方式，您可能想知道它對 第 1 部分 中討論的更高階 Web 2.0 技術的支援程度。在本系列的最後一個部分中，將講述如何使用 Ajax remoting 通過在課程目錄和 Google Maps 之間建立 mashup，進一步開發 Open 18 應用程式，在這個過程中，您將瞭解 Seam 的 Java
                                                            

                    

                                                    來自 “ ITPUB部落格 ” ，連結：http://blog.itpub.net/13270562/viewspace-244087/，如需轉載，請註明出處，否則將追究法律責任。
                                            

                
            
                            

                    
                    
0
                    
0
                    

                        

                            分享到：
                            
                            
                            
                            
                        

                        

                

                

                    

                        上一篇：
                                                    Seam必須要學的東西
                        
                    
                    

                        下一篇：
                                                    Seam: 為 JSF 量身定做的應用程式框架
                                            
                

                


                
                

                    

                        
                        
                        
                            
                        

                        

                            請登入後發表評論
                            
                                登入
                            
                        

                        
                        


                    
                    

                        
全部評論 
                        
                        

                            

            

        
        
            
    

        
        

        

        
    
    
梧桐雨—168
            

        
    
            
註冊時間：2008-02-28
            

        

            
博文量
            141
        
        

            
訪問量
            
402975
        
    






                
        

            
最新文章
            

                            

                
                       Scala，基於JVM的併發語言
                
                
                            

                
                       Scala—Java的避難所之main(String[])
                
                
                            

                
                       面向 Java 開發人員的 Scala 指南: 類操作
                
                
                            

                
                       Java之外選擇Scala還是Groovy？
                
                
                            

                
                       為什麼選擇Scala？
                
                
                            

                
                       JSF的加減法與Seam
                
                
                            

                
                       測試Seam應用程式
                
                
                            

                
                       Seam應用程式框架
                
                
                            

                
                       Seam和JBoss規則
                
                
                            

                
                       Seam中的JSF表單驗證
                
                
                        



        
        
            


    


    



    

        

            
                

                    

                
            
            
        
        

            支援我們
            作者招募
            使用者協議
            FAQ
            Contact Us
            

        

        
北京盛拓優訊資訊科技有限公司. 版權所有  京ICP備09055130號-4  北京市公安局海淀分局網監中心備案編號：11010802021510
        
廣播電視節目製作經營許可證(京) 字第1234號 中國網際網路協會會員