第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/]