SEAM学习(七)---Seam事件
Seam事件
Seam组件模型是为使用 事件驱动的应用程序 而开发的,特别是在一个细粒度的事件模型里进行细粒度的松耦合组件的开发。 Seam的事件有几种类型,大部分是我们已经见过的:
JSF事件
jBPM的状态转移事件
Seam页面动作
Seam组件驱动事件
Seam上下文事件
所有这些不同种类的事件都通过绑定了表达式的JSF EL方法映射到Seam组件去。JSF事件是在JSF模板中定义的:
<h:commandButton value="Click me!" action="#{helloWorld.sayHello}"/>对于jBPM的转换事件,是在jBPM过程定义或页面流定义中指定的:
<start-page name="hello" view-id="/hello.jsp">
<transition to="hello">
<action expression="#{helloWorld.sayHello}"/>
</transition>
</start-page>你可以在其他地方找到更多关于JSF事件和jBPM事件的信息。我们现在主要关注由Seam定义的两种新增类型的事件上。
5.1.1. 页面动作
Seam的页面动作是指就在我们渲染页面之前发生的事件。我们在 WEB-INF/pages.xml 中声明页面动作。 我们可以为任何一个特殊的JSF视图id定义一个页面动作:
<pages>
<page view-id="/hello.jsp" action="#{helloWorld.sayHello}"/>
</pages>或者,我们可以使用一个通配符 * 作为 view-id 的后缀来指定一个动作,应用到所有符合该模式的视图ID中:
<pages>
<page view-id="/hello/*" action="#{helloWorld.sayHello}"/>
</pages>如果多通配符的页面动作匹配当前的view-id,Seam将按照从最通用到最特殊的顺序来调用所有的动作。
页面动作方法可以返回一个JSF的结果。如果这个结果非空,Seam将用定义好的导航规则导航到一个视图中去。
此外,在元素 <page> 里提到的视图id不需要对应一个真实的JSP或Facelets页面! 因此,我们可以再生传统的面向动作的框架的功能,就像Struts或WebWork使用页面动作那样。例如:
TODO: translate struts action into page action如果你想要应non-faces的请求做点复杂的事情(例如HTTP GET请求),这就非常有用。
对于多页面或者条件页面的动作,可以使用 <action> 标签指定:
<pages>
<page view-id="/hello.jsp">
<action execute="#{helloWorld.sayHello}" if="#{not validation.failed}"/>
<action execute="#{hitCount.increment}"/>
</page>
</pages>5.1.1.1. 页面参数
一个JSF faces请求(表单提交)同时封装了一个“动作action”(一个方法绑定)和“多个参数parameters”(输入值绑定)。一个页面动作也可能需要参数!
由于GET请求是可以做标记的,页面参数是作为人类易读的请求参数来传递的。(不像JSF form的输入,什么都有就是不具有可读性!)
你可以使用页面参数,带不带动作方法都可以。
5.1.1.1.1. 将请求参数映射到模型
Seam让我们提供一个值绑定,来将一个已命名的请求参数映射成一个模型对象的属性。
<pages>
<page view-id="/hello.jsp" action="#{helloWorld.sayHello}">
<param name="firstName" value="#{person.firstName}"/>
<param name="lastName" value="#{person.lastName}"/>
</page>
</pages><param> 的声明是双向的,就像一个JSF输入的值绑定:
当视图id的一个non-faces(GET)请求发生时,Seam在执行了相应的类型转变之后,就在模型对象上设置已命名的请求参数的值。
任何 <s:link> 或 <s:button> 透明地或者说自动地包括request带有的参数。 参数的值由渲染阶段(当 <s:link> 被渲染)的绑定值来决定。
使用 <redirect/> 到视图id的任何导航规则很明显是含有请求参数。 参数的值由调用应用程序阶段结束时的值绑定大小来决定。
这个值很明显是由带有视图id的被提交的任何JSF页面传播的。 这意味着视图参数表现得就像faces请求的 PAGE 范围内上下文变量一样。
最理想的情形是 无论 我们从什么页面到 /hello.jsp (或者从/hello.jsp回到/hello.jsp), 在值绑定中被引用的模型属性的值都应该被“记住”,而不需要对话来存储(或者其他的服务器端状态来存储)。
5.1.1.1.2. 传播请求参数
如果只是指定 name 属性,那么请求参数就会利用 PAGE 进行上下文传播(它没有被映射成模型属性)。
<pages>
<page view-id="/hello.jsp" action="#{helloWorld.sayHello}">
<param name="firstName" />
<param name="lastName" />
</page>
</pages>如果你想要建立多层的复杂CRUD页面,页面参数的传递尤其有用。你可以用它“记住”你前面到过的页面(例如当按了保存按钮时)和正在编辑的实体。
很明显,如果参数是视图的页面参数的话,任何 <s:link> 或者 <s:button> 都会传播请求参数。
这个值很明显是由带有指定视图id的页面的任何jsf页面表单提交传播的。 (这意味着视图参数表现得就像faces请求的PAGE范围内视图参数一样。)
所有这些听起来很复杂,你可能会想这么一个外来的构造是否真的值得去努力。实际上,一旦你“掌握了它”,有这种想法非常自然。 理解这些资料显然需要花费时间的。页面参数是跨越non-faces请求来传播状态的最优雅方式。 对于用可标记的结果页,搜索屏幕的问题尤其有效,在这种情况下,我们喜欢可以写应用程序代码、用同一段代码来处理POST和GET请求。 页面参数消除了视图定义中请求参数的重复清单,并使得重定向更容易用代码实现。
5.1.1.1.3. 转换和验证
你可以为复杂的模型属性指定一个JSF转换器:
<pages>
<page view-id="/calculator.jsp" action="#{calculator.calculate}">
<param name="x" value="#{calculator.lhs}"/>
<param name="y" value="#{calculator.rhs}"/>
<param name="op" converterId="com.my.calculator.OperatorConverter" value="#{calculator.op}"/>
</page>
</pages>或者:
<pages>
<page view-id="/calculator.jsp" action="#{calculator.calculate}">
<param name="x" value="#{calculator.lhs}"/>
<param name="y" value="#{calculator.rhs}"/>
<param name="op" converter="#{operatorConverter}" value="#{calculator.op}"/>
</page>
</pages>JSF验证器和 required="true" 也可以这样用:
<pages>
<page view-id="/blog.xhtml">
<param name="date"
value="#{blog.date}"
validatorId="com.my.blog.PastDate"
required="true"/>
</page>
</pages>或者:
<pages>
<page view-id="/blog.xhtml">
<param name="date"
value="#{blog.date}"
validator="#{pastDateValidator}"
required="true"/>
</page>
</pages>更好的方式,基于模型的Hibernate验证器注解会自动被识别和验证。
当类型转换或者验证失败后,一个全局的 FacesMessage 就会被添加到 FacesContext 中。
5.1.1.2. 导航
你可以使用在Seam应用程序的 faces-config.xml 中定义的标准JSF导航规则。然而,JSF导航规则也有许多烦人的限制:
在重定向时,不可能指定一个将要使用的请求参数。
不可能由一个规则来开始或者结束对话。
通过给动作方法求取返回值来运作规则;不可能去给一个任意的EL表达式取值。
更深层次的问题在于”管理“逻辑在 pages.xml 和 faces-config.xml 之间是分散的。 最好是把这种逻辑统一进 pages.xml 中。
这个JSF导航规则:
<navigation-rule>
<from-view-id>/editDocument.xhtml</from-view-id>
<navigation-case>
<from-action>#{documentEditor.update}</from-action>
<from-outcome>success</from-outcome>
<to-view-id>/viewDocument.xhtml</to-view-id>
<redirect/>
</navigation-case>
</navigation-rule>可以重写如下:
<page view-id="/editDocument.xhtml">
<navigation from-action="#{documentEditor.update}">
<rule if-outcome="success">
<redirect view-id="/viewDocument.xhtml"/>
</rule>
</navigation>
</page>如果我们不必用字符类型的返回值(JSF的结果)来污染 DocumentEditor 组件的话会更好。 因此Seam允许我们写成:
<page view-id="/editDocument.xhtml">
<navigation from-action="#{documentEditor.update}"
evaluate="#{documentEditor.errors.size}">
<rule if-outcome="0">
<redirect view-id="/viewDocument.xhtml"/>
</rule>
</navigation>
</page>或者甚至可以写成:
<page view-id="/editDocument.xhtml">
<navigation from-action="#{documentEditor.update}">
<rule if="#{documentEditor.errors.empty}">
<redirect view-id="/viewDocument.xhtml"/>
</rule>
</navigation>
</page>第一种形式计算一个值绑定,来确定要被后面的一系列导航规则所使用的结果值。 第二种方法忽略结果,并为每个可能的规则来计算值绑定。
当然,当一个更新成功,我们可能想要结束当前的对话。我们可以这样做:
<page view-id="/editDocument.xhtml">
<navigation from-action="#{documentEditor.update}">
<rule if="#{documentEditor.errors.empty}">
<end-conversation/>
<redirect view-id="/viewDocument.xhtml"/>
</rule>
</navigation>
</page>由于我们终止了会话,后面的任何请求都无法知道我们对哪个文档感兴趣。 我们可以将文档id作为一个请求参数传递,这样也使得视图变成是可标记的:
<page view-id="/editDocument.xhtml">
<navigation from-action="#{documentEditor.update}">
<rule if="#{documentEditor.errors.empty}">
<end-conversation/>
<redirect view-id="/viewDocument.xhtml">
<param name="documentId" value="#{documentEditor.documentId}"/>
</redirect>
</rule>
</navigation>
</page>在JSF中,null是一个特殊的结果。结果null被解释成“重新显示页面”。 下面的导航规则符合任何非null的结果,而 不符合 null的结果:
<page view-id="/editDocument.xhtml">
<navigation from-action="#{documentEditor.update}">
<rule>
<render view-id="/viewDocument.xhtml"/>
</rule>
</navigation>
</page>如果结果出现null,你还想执行导航,就使用下面的形式:
<page view-id="/editDocument.xhtml">
<navigation from-action="#{documentEditor.update}">
<render view-id="/viewDocument.xhtml"/>
</navigation>
</page>view-id可以作为一个JSF EL表达式提供:
<page view-id="/editDocument.xhtml">
<navigation if-outcome="success">
<redirect view-id="/#{userAgent}/displayDocument.xhtml"/>
</navigation>
</page>5.1.1.3. 导航的定义、页面动作和参数的细粒度文件
如果你有很多不同的页面动作和页面参数,或者甚至是很多导航规则,你就会很想把这些声明分开放到多个文件中去。 你可以在一个名为 calc/calculator.page.xml 的资源中,为一个有着视图id /calc/calculator.jsp 的页面定义动作和参数。 这个例子中的根元素是 <page> 元素,隐含着视图id:
<page action="#{calculator.calculate}">
<param name="x" value="#{calculator.lhs}"/>
<param name="y" value="#{calculator.rhs}"/>
<param name="op" converter="#{operatorConverter}" value="#{calculator.op}"/>
</page>5.1.2. 组件驱动的事件
Seam组件可以通过方法间简单的调用相互影响。状态组件甚至实现 Observer/Observable 模式。 但在组件直接调用彼此方法的时候,为了使组件在一个比可能存在的更加松耦合的方式下相互作用,Seam提供了 组件驱动事件。
我们在 components.xml 里指定了事件监听器(观察者)。
<components>
<event type="hello">
<action execute="#{helloListener.sayHelloBack}"/>
<action execute="#{logger.logHello}"/>
</event>
</components>在这里,event type 是任意的字符串。
事件发生时,该事件已经注册过的动作将按照它们在 components.xml 中出现的顺序被依次调用。 组件如何发起事件?Seam为此提供了一个内置的组件。
@Name("helloWorld")
public class HelloWorld {
public void sayHello() {
FacesMessages.instance().add("Hello World!");
Events.instance().raiseEvent("hello");
}
}或者你可以使用注解。
@Name("helloWorld")
public class HelloWorld {
@RaiseEvent("hello")
public void sayHello() {
FacesMessages.instance().add("Hello World!");
}
}注意这个事件产生器没有依赖任何事件消费者。事件监听器现在可以完全不依赖于产生器而实现:
@Name("helloListener")
public class HelloListener {
public void sayHelloBack() {
FacesMessages.instance().add("Hello to you too!");
}
}上述在 components.xml中定义的方法绑定关心把事件映射到消费者去。 如果你不喜欢 components.xml 文件中的那一套,可以用注解来替代:
@Name("helloListener")
public class HelloListener {
@Observer("hello")
public void sayHelloBack() {
FacesMessages.instance().add("Hello to you too!");
}
}你可能想知道为什么在这个讨论中没有提到关于任何事件对象的东西。 在Seam中,对事件对象而言,不需要在事件生产者和监听器之间传播状态。 状态保留在Seam上下文中,在组件之间共享。然而,如果你真想传递事件对象,你可以:
@Name("helloWorld")
public class HelloWorld {
private String name;
public void sayHello() {
FacesMessages.instance().add("Hello World, my name is #0.", name);
Events.instance().raiseEvent("hello", name);
}
}@Name("helloListener")
public class HelloListener {
@Observer("hello")
public void sayHelloBack(String name) {
FacesMessages.instance().add("Hello #0!", name);
}
}5.1.3. 上下文事件
Seam定义了许多内置事件,应用程序可以用它们来进行特殊类型的框架集成。这些事件是:
org.jboss.seam.validationFailed — JSF验证失败时被调用
org.jboss.seam.noConversation — 没有长时间运行的对话在运行或者长时间运行的对话被请求时调用
org.jboss.seam.preSetVariable.<name> — 设置上下文变量 <name> 时调用
org.jboss.seam.postSetVariable.<name> — 设置上下文变量 <name> 时调用
org.jboss.seam.preRemoveVariable.<name> — 未设置上下文变量 <name> 时调用
org.jboss.seam.postRemoveVariable.<name> — 未设置上下文变量 <name> 时调用
org.jboss.seam.preDestroyContext.<SCOPE> — 在 <SCOPE> 上下文被销毁之前调用
org.jboss.seam.postDestroyContext.<SCOPE> — 在 <SCOPE> 上下文被销毁之后调用
org.jboss.seam.beginConversation — 当一个长时间运行的对话开始的时候调用
org.jboss.seam.endConversation — 当一个长时间运行的对话结束的时候调用
org.jboss.seam.beginPageflow.<name> — 在页面流 <name> 开始时调用
org.jboss.seam.endPageflow.<name> — 在页面流 <name> 结束时调用
org.jboss.seam.createProcess.<name> — 在创建进程 <name> 时调用
org.jboss.seam.endProcess.<name> — 在进程 <name> 结束时调用
org.jboss.seam.initProcess.<name> — 在进程 <name> 与对话相关联时调用
org.jboss.seam.initTask.<name> — 在任务 <name> 与对话相关联时调用
org.jboss.seam.startTask.<name> — 在任务 <name> 开始时调用
org.jboss.seam.endTask.<name> — 在结束任务 <name> 时调用
org.jboss.seam.postCreate.<name> — 在创建组件 <name> 时调用
org.jboss.seam.preDestroy.<name> — 在销毁组件 <name> 时调用
org.jboss.seam.beforePhase — 在开始一个JSF阶段之前调用
org.jboss.seam.afterPhase — 在一个JSF阶段结束之后调用
org.jboss.seam.postInitialization — 当Seam被初始化并启动所有组件时被调用
org.jboss.seam.postAuthenticate.<name> — 用户认证之后调用
org.jboss.seam.preAuthenticate.<name> — 在尝试认证用户之前调用
org.jboss.seam.notLoggedIn — 在不需要认证用户和需要认证的时候调用
org.jboss.seam.rememberMe — 当Seam安全在cookie中发现用户名时发生
org.jboss.seam.exceptionHandled.<type> — 在Seam处理未被捕捉的异常时被调用
org.jboss.seam.exceptionHandled — 在Seam处理未被捕捉的异常时被调用
org.jboss.seam.exceptionNotHandled — 在没有未被捕捉异常的处理器时被调用
org.jboss.seam.afterTransactionSuccess — 当事务在Seam Application Framework中成功时调用
org.jboss.seam.afterTransactionSuccess.<name> — 当管理具名 <name> 实体的事务在Seam Application Framework中成功时调用
Seam组件可以用它们观察任何其他组件驱动事件的同样方式来观察这些事件中的任何一种。
分享到:
相关推荐
7. **事件和回调**:了解Seam事件系统的工作方式,以及如何创建和监听自定义事件。 8. **错误处理和日志**:熟悉Seam的异常处理和日志记录机制。 9. **国际化与本地化**:学习如何配置Seam进行多语言支持。 10. **...
9. **Seam事件和上下文**:Seam引入了一种独特的事件模型和组件上下文,使得组件间的通信和状态管理更为简单,这是Seam区别于其他框架的一大特色。 10. **Seam安全性和事务管理**:Seam提供了内置的安全框架和事务...
- `@Event`: 标记一个方法作为事件监听器,当特定的Seam事件发生时,该方法会被调用。 - `@BypassInterceptors`: 如果添加这个注解,那么该方法将绕过拦截器链,这对于性能敏感的操作特别有用。 5. **实战应用**...
- **点击事件**:当用户点击某条消息时,触发相应的 Seam 事件处理器。 - **页面更新**:Seam 根据用户操作自动更新页面显示。 #### 第三部分:Seam 和 jBPM 示例 本节介绍了一个结合 Seam 和 jBPM 的待办事项应用...
Seam事件提供了一个统一的编程模型,能够将JSF、EJB、JPA等技术整合在一起,提供了一个强大且灵活的开发环境。 Seam拦截器 Seam拦截器是一个基于拦截器的编程模型,能够帮助开发者快速构建企业级应用程序。Seam...
Seam - 语境相关的组件[满江红20071230]............................................................................................................................ 1 Java EE 框架...........................
2. **事件(Events)**: 事件模型是Seam的一大特色,允许组件之间通过发布和监听事件进行通信,增强了组件间的解耦合。 3. **注入(Injection)**: Seam支持依赖注入,可以将一个组件的实例自动注入到其他组件中,...
2. **事件驱动**:Seam支持基于事件的编程模型,使得在不同组件之间传递信息变得更加简单。这有助于实现松散耦合,让代码更易于维护和扩展。 3. **JSF集成**:Seam与JavaServer Faces紧密集成,提供了一种优雅的...
- 事件处理:Seam提供了一种强大的事件发布和订阅机制,允许组件之间通过事件进行通信。 - 集成性:与JSF、EJB、Hibernate等Java EE技术无缝集成,简化了开发流程。 二、Seam 2.0的主要组件和服务 2.1 JSF(Java...
还有可能包含`seam-core.jar`,这是Seam框架的基础模块,提供了核心功能,如事件处理、安全性、会话管理和事务管理。此外,`seam-persistence.jar`可能包含Seam对JPA(Java Persistence API)的支持,用于数据库持久...
- **事件上下文**:处理特定事件,通常在事件触发时创建,事件处理完毕即销毁。 - **页面上下文**:对应Web页面的生命周期,保持页面间的数据传递。 - **业务对话上下文**:维持一个业务流程中的数据一致性,直到...
- **Seam事件模型**:Seam的事件驱动模型允许组件之间松耦合通信,增强了应用的灵活性和可扩展性。 - **Seam Inversion of Control (IoC) 和 Dependency Injection (DI)**:Seam实现了IoC和DI,简化了对象之间的...
Seam 提供了许多内置的功能,如状态管理、事件处理等,这些特性有助于改善用户界面的交互性和响应性,从而提升用户体验。 ### 四、结论 《Seam in Action》这本书系统地介绍了 Seam 框架的基础知识和高级特性,适合...
1. **Seam上下文**:介绍了Seam如何通过不同层次的上下文来管理应用的状态,包括无状态上下文、事件上下文、页面上下文、会话上下文、业务流程上下文、应用上下文等。 2. **组件类型**:详细列举了Seam支持的各种...
此外,Seam还提供了事件驱动的通信机制,使得组件间可以利用事件进行非侵入式的交互。 Seam的另一个亮点是其对持久层的集成。通过与JPA的集成,开发者可以方便地进行数据库操作,如CRUD(创建、读取、更新和删除)...
- **事件上下文**:处理特定的事件触发。 - **页面上下文**:维护当前页面的状态。 - **业务会话上下文**:管理长时间的会话。 - **Session上下文**:存储用户级别的数据。 - **业务流程上下文**:跟踪整个业务...
此外,Seam还提供了事件处理和依赖注入等功能,使得在整个应用中管理这些级联菜单的数据变得更加方便。例如,`@Observes`注解可用于监听特定事件,而`@In`和`@Out`注解则用于在不同组件之间共享数据。 总的来说,这...
Seam与JSF的结合,通过Seam组件,可以轻松处理复杂的数据绑定和事件处理,提高了UI开发的效率。 Seam中的EJB支持则允许开发者利用Enterprise JavaBeans进行业务逻辑处理。Seam简化了EJB的使用,不需要繁琐的接口和...
2. **事件处理**:Seam扩展了JSF的事件处理机制,允许开发者定义更复杂的业务逻辑事件,并在组件间传递。 3. **事务管理**:Seam自动管理Hibernate的事务,使得开发者无需编写繁琐的事务控制代码。在JSF动作事件...