第12章 使用 Apache Wicket写你的持久化层

雷锋

第12章 使用 Apache Wicket写你的持久化层
 
Seam 支持 Wicket当做一个可选的JSF持久化层。看一看在 Seam中的例子， 其展示了移植到Wicket的Booking 例子。
 
注意，Wicket支持对Seam而言是新的，所以，当你使用Wicket时，那些在JSF中可用的一些特色至今是不可用的（如：页面流）。你也会注意到，文档是非常JSF中心化的，并且需要改造，反射最初类支持Wicket。
 
12.1.增加Seam 到你的wicket应用程序
 
特色增加到你的wicket应用程序，能被划分成两类：双向注入和安排。这些在后面详细讨论。
 
当构建wicket应用程序时，广泛的使用内部类是普遍的，用组件树在构造器中构建。Seam完全支持基于在内部类内和构造器内的控件（不象正规的Seam组件）注释的使用。
 
任何超类被调用后，注释被处理。这意味着，任何注入的属性在调用this()或 super()时不能被作为一个参数传递。
 
注意，我们正在着手这方面的改进。
 
当一个方法在一个内部类中被调用，对任何封装它的类，双向注入发生。这允许你设置你的双向注入变量在外部类，并且在任何内部类中引用它们。
 
12.1.1. 双向注入
 
一个Seam使Wicket应用程序可能完全访问所有的标准Seam上下文(EVENT,
CONVERSATION, SESSION, APPLICATION和 BUSINESS_PROCESS)。
 
从Wicket访问Seam组件，你只需要使用@In注入它：
 
@In(create=true)
private HotelBooking hotelBooking;
 
技巧：当你的Wicket类不完全是一个Seam组件时，不需要使用@Name注释它。
 
你也能从一个Wicket组件“注出”一个对象进到Seam上下文：
 
@Out(scope=ScopeType.EVENT, required=false)
private String verify;
 
TODO 进行更多和这种“用例驱动”
 
12.1.2.安排
 
你通过使用@Restrict注释，能够保护一个Wicket组件。这个能设置在外部组件或者任何内部组件。如果@Restrict被指定，组件会自动约束注册用户。你能随意地在值属性中使用EL表达式指定一个被应用的约束。对更多情况，请参考15章，安全。
 
例如：
@Restrict
public class Main extends WebPage {
   ...
 
技巧：Seam 会自动对任何嵌套的类应用约束。
 
TODO – 实现这个 (看 JBSEAM-3192)
 
通过使用@Begin和@End，在一个Wicket内组件你能区分对话。这些注释使用，在语法上，是和在一个Seam组件中用法是一样的。你能在任何方法上设置@Begin 和 @End。
 
注意：“反对的” ifOutcome属性是不被支持。
 
例如：
 
item.add(new Link("viewHotel") {
   @Override
   @Begin
   public void onClick() {
      hotelBooking.selectHotel(hotel);
      setResponsePage(org.jboss.seam.example.wicket.Hotel.class);
   }
};
 

如果你想进一步分离你的应用程序的类，你能使用Seam事件。当然，你能使用Events.instance().raiseEvent("foo")触发一个事件。做为选择，你能注释一个方法@RaiseEvent("foo")；如果事件返回一个没有异常的非空结果，事件会被触发。

 

通过@CreateProcess,@ResumeTask, @BeginTask, @EndTask, @StartTask and @Transition，你也能够控制在Wicket中的任务和过程。
 
TODO – 实现 BPM 控制 - JBSEAM-3194
 
12.2. 设置你的项目
 
在Wicket里，你必须放置你的类在WEB-INF/wicket中，才能通过注释让双向注入可用和进行安排控制。Seam需要你的Wicket类的字节码工具能解释你使用的注释。
 
注意： 通常只有使用一个自定义类加载器的字节码工具被支持，它读取在WEB-INF/wicket 中的类。当项目结果被构建时，用一个Ant 任务或Maven 插件可以开发来支持字节码工具。
 
12.2.1. 定义应用程序
 
一个使用Seam 的Wicket网页应用程序，使用SeamWebApplication作为基础类；这个创作物接入Wicket生命周期，当需要的时候允许Seam自动传播对话。它也增加状态消息到页面。
 
例如：
SeamAuthorizationStrategy传播授权到Seam安全， 允许在Wicket 组件上使用@Restrict。SeamWebApplication 为你安装授权策略。你能通过实现getLoginPage()方法指定注册页面。 你也需要通过实现getHomePage()方法设置应用程序主页。
 
public class WicketBookingApplication extends SeamWebApplication {
   @Override
   public Class getHomePage() {
      return Home.class;
   }
   @Override
   protected Class getLoginPage() {
      return Home.class;
   }
  
}
 
Seam自动为你安装Wicket 过滤器filter (确保它为你插入到正确的地方)。但是你仍然需要告诉Wicket使用那一个类：
 
<components xmlns="http://jboss.com/products/seam/components"
   xmlns:wicket="http://jboss.com/products/seam/wicket">
        
      <wicket:web-application  application-
class="org.jboss.seam.example.wicket.WicketBookingApplication" />
</components>
 
技巧：关于更多的授权策略和你能覆盖的有关应用程序类的其它方法，请看一下Wicket文档。
 
[Apache Wicket – Home   http://wicket.apache.org/]