开始Seam2.0的学习,首先来写第一个入门Demo--注册。
一、按照上一篇步骤创建SeamRegisterDemo.
1、首先写一个实体类
package org.su.reg.model; import java.io.Serializable; import javax.persistence.Entity; import javax.persistence.Id; import javax.persistence.Table; import org.hibernate.validator.Length; import org.hibernate.validator.NotNull; import org.jboss.seam.ScopeType; import org.jboss.seam.annotations.Name; import org.jboss.seam.annotations.Scope; @Entity // EJB标准注解@Entity表明了User类是个实体bean @Name("User") // Seam组件需要一个组件名称,由@Name指定。必须Seam应用内唯一 @Scope(ScopeType.SESSION) /*每当Seam实例化一个组件时,它就将始化后的实例绑定给组件中 默认上下文 的上下文变量。 * 默认的上下文由 @Scope注解指定。 UserBean是个会话作用域的组件*/ @Table(name = "users") //EJB标准注解@Table 表明了将 User 类映射到 users 表上。 public class User implements Serializable { private static final long serialVersionUID = 1881413500711441951L; private String username; private String password; private String name; /*name、 password 及 username 都是实体Bean的持久化属性。所有的持久化属性都定义了访问方法。 * 当JSF渲染输出及更新模型值阶段时需要调用该组件的这些方法。 * */ public String getUsername() { return username; } @Id @NotNull @Length(min=3,max=10) //标准EJB注解 @Id 表明是实体Bean的主键属性。 public void setUsername(String username) { this.username = username; } @NotNull @Length(min=3,max=10) public String getPassword() { return password; } public void setPassword(String password) { this.password = password; } @NotNull @Length(min=3,max=10) /*@NotNull 和 @Length 注解是Hibernate Validator框架的组成部份, * Seam集成了Hibernate Validator并让你用它来作为数据校验(尽管你可能并不使用Hibernate作为持久化层)。 */ public String getName() { return name; } public void setName(String name) { this.name = name; } public User(String name, String password, String username) { super(); this.name = name; this.password = password; this.username = username; } //EJB和Seam都要求有空的构造器。 public User() { } }
最值得注意的是 @Name 和 @Scope 注解,它们确立了这个类是Seam的组件。
接下来我们将看到 User 类字段在更新模型值阶段时直接被绑定给JSF组件并由JSF操作, 在此并不需要冗余的胶水代码来在JSP页面与实体Bean域模型间来回拷贝数据。
然而,实体Bean不应该进行事务管理或数据库访问。故此,我们无法将此组件作为JSF动作监听器,因而需要会话Bean。
2、无状态会话Bean:RegisterAction.java
在Seam应用中大都采用会话Bean来作为JSF动作监听器(当然我们也可选择JavaBean)。
在此示例中,只有一个JSF动作,并且我们使用会话Bean方法与之相关联并使用无状态Bean,这是由于所有与动作相关的状态都保存在 UserBean中。
package org.su.reg.action; import java.util.List; import javax.ejb.Stateless; import javax.persistence.EntityManager; import javax.persistence.PersistenceContext; import org.jboss.seam.annotations.In; import org.jboss.seam.annotations.Logger; import org.jboss.seam.annotations.Name; import org.jboss.seam.faces.FacesMessages; import org.jboss.seam.log.Log; import org.su.reg.model.User; @Stateless // EJB标准注解 @Stateless 将这个类标记为无状态的会话Bean。 @Name("register") public class RegisterAction { @In // 注解 @In将Bean的一个属性标记为由Seam来注入。 在此例中,此属性由名为 user 的上下文变量注入(实例的变量名)。 private User user; @PersistenceContext // EJB标准注解 @PersistenceContext 用来注入EJB实体管理器。 private EntityManager em; @Logger // Seam的 @Logger 注解用来注入组件的 Log 实例。 private Log log; /* * 动作监听器方法使用标准的EJB3 EntityManager API来与数据库交互,并返回JSF的输出结果。 * 请注意,由于这是个会话Bean,因此当 register() 方法被调用时事务就会自动开始,并在结束时提交(commit)。 */ public String register() { /* * * 请注意Seam让你在EJB-QL中使用JSF EL表达式。因此可在标准JPA Query 对象上调用普通的JPA * setParameter() 方法, 这样岂不妙哉? */ List list = em.createQuery( "select username from User where username=#{user.username}") .getResultList(); if (list.size() == 0) { em.persist(list); // Log API为显示模板化的日志消息提供了便利。 log.info("Registered new user #{user.username}"); /* * * 多个JSF动作监听器方法返回一个字符串值的输出,它决定了接下来应显示的页面内容。 * 空输出(或返回值为空的动作监听器方法)重新显示上一页的内容。 在普通的JSF中, 用JSF的导航规则(navigation * rule) 来决定输出结果的JSF视图id是很常用的。 * 这种间接性对于复杂的应用是非常有用的,值得去实践。但是,对于象示例这样简单的的应用, * Seam让你使用JSF视图id作为输出结果,以减少对导航规则的需求。请注意,当你用视图id作为输出结果时, * Seam总会执行一次浏览器的重定向。 */ return "/registered.jsp"; } else { /* * * Seam提供了大量的 内置组件(built-in components) 来协助解决那些经常遇到的问题。 用 * FacesMessages 组件就可很容易地来显示模板化的错误或成功的消息。 内置的Seam组件还可由注入或通过调用 * instance() 方法来获取。 */ FacesMessages.instance() .add("User #{user.username} already exists"); System.out.println("Register successful."); return null; } } }
这次我们并没有显式指定 @Scope ,若没有显式指定时,每个Seam 组件类型就使用其默认的作用域。对于无状态的会话Bean, 其默认的作用域就是无状态的上下文。实际上 所有的 无状态的会话Bean都属于无状态的上下文。
会话Bean的动作监听器在此小应用中履行了业务和持久化逻辑。在更复杂的应用中,我们可能要将代码分层并重构持久化逻辑层成 专用数据存取组件,这很容易做到。但请注意Sean并不强制你在应用分层时使用某种特定的分层策略。
此外,也请注意我们的SessionBean会同步访问与web请求相关联的上下文(比如在 User 对象中的表单的值),状态会被保持在事务型的资源里(EntityManager 对象)。 这是对传统J2EE的体系结构的突破。再次说明,如果你习惯于传统J2EE的分层,也可以在你的Seam应用实行。但是对于许多的应用,这是明显的没有必要 。
3、会话Bean的本地接口:Register.java
很自然,我们的会话Bean需要一个本地接口。
@Local public interface Register { public String register(); }
所有的Java代码就这些了,现在去看一下部署描述文件。
4、web.xml
<?xml version="1.0" encoding="UTF-8"?> <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"> <!-- Seam --> <listener> <listener-class>org.jboss.seam.servlet.SeamListener</listener-class> </listener> <!-- MyFaces --> <listener> <listener-class> org.apache.myfaces.webapp.StartupServletContextListener </listener-class> </listener> <context-param> <param-name>javax.faces.STATE_SAVING_METHOD</param-name> <param-value>client</param-value> </context-param> <servlet> <servlet-name>Faces Servlet</servlet-name> <servlet-class>javax.faces.webapp.FacesServlet</servlet-class> <load-on-startup>1</load-on-startup> </servlet> <!-- Faces Servlet Mapping --> <servlet-mapping> <servlet-name>Faces Servlet</servlet-name> <url-pattern>*.seam</url-pattern> </servlet-mapping> </web-app>
此 web.xml 文件配置了Seam和JSF。所有Seam应用中的配置与此处的配置基本相同。
5.JSF配置:faces-config.xml
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE faces-config PUBLIC "-//Sun Microsystems, Inc.//DTD JavaServer Faces Config 1.0//EN" "http://java.sun.com/dtd/web-facesconfig_1_0.dtd"> <faces-config> <!-- A phase listener is needed by all Seam applications --> <lifecycle> <phase-listener>org.jboss.seam.jsf.SeamPhaseListener</phase-listener> </lifecycle> </faces-config>
注意我们不需要申明任何JSF managed Bean!因为我们所有的managed Bean都是通过经过注释的Seam组件。所以在Seam的应用中,faces-config.xml比原始的JSF更少用到。
实际上,一旦你把所有的基本描述文件配置完毕,你所需写的 唯一类型的 XML文件就是导航规则及可能的jBPM流程定义。对于Seam而言, 流程(process flow) 及 配置数据 是唯一真正属于需要XML定义的。
在此简单的示例中,因为我们将视图页面的ID嵌入到Action代码中,所以我们甚至都不需要定义导航规则。
6.ejb-jar.xml 文件将 SeamInterceptor 绑定到压缩包中所有的会话Bean上,以此实现了Seam与EJB3的整合。
<ejb-jar xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/ejb-jar_3_0.xsd"
version="3.0">
<interceptors>
<interceptor>
<interceptor-class>org.jboss.seam.ejb.SeamInterceptor</interceptor-class>
</interceptor>
</interceptors>
<assembly-descriptor>
<interceptor-binding>
<ejb-name>*</ejb-name>
<interceptor-class>org.jboss.seam.ejb.SeamInterceptor</interceptor-class>
</interceptor-binding>
</assembly-descriptor>
</ejb-jar>
persistence.xml 文件告诉EJB的持久化层在哪找到数据源,该文件也含有一些厂商特定的设定。此例在程序启动时自动创建数据库Schema。
<?xml version="1.0" encoding="UTF-8"?>
<persistence xmlns="http://java.sun.com/xml/ns/persistence"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd"
version="1.0">
<persistence-unit name="userDatabase">
<provider>org.hibernate.ejb.HibernatePersistence</provider>
<jta-data-source>java:/DefaultDS</jta-data-source>
<properties>
<property name="hibernate.hbm2ddl.auto" value="create-drop"/>
</properties>
</persistence-unit>
</persistence>
视图层:
未完
分享到:
相关推荐
Seam 2.0引入了CDI,这是Java EE 6中的一个重要组成部分,它提供了一种统一的依赖注入机制,简化了对象的生命周期管理和依赖管理。 2.4 JPA集成 Seam 2.0与JPA的集成使得数据库操作变得更加简单,支持实体管理和...
Seam2.0是一个基于Java的框架,用于简化企业级应用的开发过程。它建立在Java EE标准之上,通过提供一系列高级功能,如依赖注入、面向切面编程、事件驱动架构等,帮助开发者快速构建复杂的应用系统。Seam2.0的目标是...
Seam 2.0是其一个重要版本,它在1.x的基础上进行了许多改进,旨在提供更高效、更灵活的开发体验。本文档集合将深入探讨Seam 2.0的关键特性、工作原理以及如何有效地利用它进行开发。 一、Seam 2.0的核心概念 1. ...
Seam 2.0 是一个基于Java的开源框架,主要用于构建富互联网应用程序(Rich Internet Applications,简称RIA)。这个框架在企业级应用开发中被广泛使用,因为它提供了强大的数据管理、事务处理、安全性以及用户界面...
- **入门指南**:介绍如何开始使用Seam,包括安装、配置和创建第一个Seam项目。 - **组件和事件**:详细解释Seam组件的工作原理,以及如何使用事件进行通信。 - **JSF和Seam的集成**:讲解如何在JSF页面中使用Seam...
1. **Context(上下文)管理**:Seam 提供了一个灵活的上下文模型,允许开发者在不同层面上管理和访问对象。这包括请求上下文、会话上下文和应用上下文。请求上下文存储与HTTP请求相关的数据,会话上下文则跨多个...
JBoss Seam 2.0 是一个开源的Java EE框架,它将企业级服务与富互联网应用(RIA)开发紧密结合,简化了构建复杂Web应用的过程。Seam的核心特性之一是其对上下文(Contexts)和依赖注入(CDI)的支持,这使得开发者...
##### 1.2 第一个例子:注册示例 本节通过一个简单的用户注册示例来介绍Seam应用的基本结构和开发流程。 **1.2.1.1 实体Bean:User.java** `User.java` 是一个实体Bean,用于表示应用中的用户信息。它通常包含了...
seam2.0_api帮助文件,chm文件
Seam 2.0 是一个全面的Java EE框架,它为开发人员提供了一种整合多种技术,如JavaServer Faces (JSF)、Enterprise JavaBeans (EJB)、Java Persistence API (JPA)以及Spring等的强大工具。这个"Seam_2.0_Reference_zh...
整理自jboss seam 中文站,压缩为chm格式,便于广大jboss seam爱好者阅读,所有版权归jboss seam中文站所有。
根据提供的文件信息,我们可以推断出这是一份关于Seam 2.0的中文参考文档。Seam是一个基于Java EE平台的应用程序框架,它集成了JSF、EJB和其他技术来简化企业级应用的开发过程。下面将从几个方面详细阐述Seam 2.0中...
#### 第一章:Seam 入门 本章通过几个示例介绍了如何使用 JBoss Seam 开发简单的 Web 应用程序,并对其中的关键概念进行了讲解。 ##### 1.1 试试看 这部分内容介绍了如何在 JBoss AS 和 Tomcat 上运行 Seam 应用...
Jboss_Seam_2.0中文手册
Seam 2.0_R中文手册则聚焦于Seam框架,这是一个整合了JSF(JavaServer Faces)、EJB 3、JPA(Java Persistence API)等技术的全栈式框架。Seam的目标是提供一个无缝的开发环境,让开发者能够轻松地构建富互联网应用...
Seam是一个开源的企业级Java框架,由JBoss公司开发,旨在简化Java EE应用程序的开发。它将多种技术如JavaServer Faces (JSF),Java Persistence API (JPA),EJB 3,Inversion of Control (IoC)和Aspect-Oriented ...
Seam - 语境相关的组件 [满江红20080327] Java EE框架
JBoss Seam是一个基于Java EE的应用框架,主要用于简化企业级应用的开发过程。它整合了多种技术和模式,如JSF(JavaServer Faces)、EJB 3.0、JPA(Java Persistence API)等,从而提供了一个强大的开发平台。Seam ...