Seam 入门

Example 1.1. 

@Entity@Name("user")@Scope(SESSION)@Table(name="users")public class User implements Serializable
{
   private static final long serialVersionUID = 1881413500711441951L;

   private String username;private String password;
   private String name;

   public User(String name, String password, String username)
   {
      this.name = name;
      this.password = password;
      this.username = username;
   }

   public User() {}@NotNull @Length(min=5, max=15)public String getPassword()
   {
      return password;
   }

   public void setPassword(String password)
   {
      this.password = password;
   }

   @NotNull
   public String getName()
   {
      return name;
   }

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

   @Id @NotNull @Length(min=5, max=15)public String getUsername()
   {
      return username;
   }

   public void setUsername(String username)
   {
      this.username = username;
   }

}

	EJB3标准注解@Entity表明了User类是个实体Bean.
	Seam组件需要一个组件名称，此名称由注解@Name来指定。此名称必须在Seam应用内唯一。当JSF用一个与组件同名的名称去请求Seam来解析上下文变量， 且该上下文变量尚未定义（null）时，Seam就将实例化那个组件，并将新实例绑定给上下文变量。 在此例中，Seam将在JSF第一次遇到名为user的变量时实例化User。
	每当Seam实例化一个组件时，它就将始化后的实例绑定给组件中默认上下文的上下文变量。默认的上下文由@Scope注解指定。UserBean是个会话作用域的组件。
	EJB标准注解@Table表明了将User类映射到users表上。
	name、password及username都是实体Bean的持久化属性。所有的持久化属性都定义了访问方法。当JSF渲染输出及更新模型值阶段时需要调用该组件的这些方法。
	EJB和Seam都要求有空的构造器。
	@NotNull和@Length注解是Hibernate Validator框架的组成部份， Seam集成了Hibernate Validator并让你用它来作为数据校验（尽管你可能并不使用Hibernate作为持久化层）。
	标准EJB注解@Id表明了实体Bean的主键属性。

这个例子中最值得注意的是@Name和@Scope注解，它们确立了这个类是Seam的组件。

接下来我们将看到User类字段在更新模型值阶段时直接被绑定给JSF组件并由JSF操作， 在此并不需要冗余的胶水代码来在JSP页面与实体Bean域模型间来回拷贝数据。

然而，实体Bean不应该进行事务管理或数据库访问。故此，我们无法将此组件作为JSF动作监听器，因而需要会话Bean。

Example 1.2. 

@Stateless@Name("register")
public class RegisterAction implements Register
{

   @Inprivate User user;

   @PersistenceContextprivate EntityManager em;

   @Loggerprivate Log log;

   public String register(){
      List existing = em.createQuery(
         "select username from User where username=#{user.username}").getResultList();

      if (existing.size()==0)
      {
         em.persist(user);
         log.info("Registered new user #{user.username}");return "/registered.jsp";}
      else
      {
         FacesMessages.instance().add("User #{user.username} already exists");return null;
      }
   }

}

	EJB标准注解@Stateless将这个类标记为无状态的会话Bean。
	注解@In将Bean的一个属性标记为由Seam来注入。 在此例中，此属性由名为user的上下文变量注入（实例的变量名）。
	EJB标准注解@PersistenceContext用来注入EJB实体管理器。
	Seam的@Logger注解用来注入组件的Log实例。
	动作监听器方法使用标准的EJB3EntityManagerAPI来与数据库交互，并返回JSF的输出结果。 请注意，由于这是个会话Bean，因此当register()方法被调用时事务就会自动开始，并在结束时提交（commit）。
	请注意Seam让你在EJB-QL中使用JSF EL表达式。因此可在标准JPAQuery对象上调用普通的JPAsetParameter()方法，这样岂不妙哉？
	LogAPI为显示模板化的日志消息提供了便利。
	多个JSF动作监听器方法返回一个字符串值的输出，它决定了接下来应显示的页面内容。 空输出（或返回值为空的动作监听器方法）重新显示上一页的内容。 在普通的JSF中，用JSF的导航规则（navigation rule）来决定输出结果的JSF视图id是很常用的。 这种间接性对于复杂的应用是非常有用的，值得去实践。但是，对于象示例这样简单的的应用，Seam让你使用JSF视图id作为输出结果，以减少对导航规则的需求。请注意，当你用视图id作为输出结果时，Seam总会执行一次浏览器的重定向。
	Seam提供了大量的内置组件（built-in components）来协助解决那些经常遇到的问题。 用FacesMessages组件就可很容易地来显示模板化的错误或成功的消息。 内置的Seam组件还可由注入或通过调用instance()方法来获取。

这次我们并没有显式指定@Scope，若没有显式指定时，每个Seam 组件类型就使用其默认的作用域。对于无状态的会话Bean， 其默认的作用域就是无状态的上下文。实际上所有的无状态的会话Bean都属于无状态的上下文。

会话Bean的动作监听器在此小应用中履行了业务和持久化逻辑。在更复杂的应用中，我们可能要将代码分层并重构持久化逻辑层成 专用数据存取组件，这很容易做到。但请注意Sean并不强制你在应用分层时使用某种特定的分层策略。

此外，也请注意我们的SessionBean会同步访问与web请求相关联的上下文（比如在User对象中的表单的值），状态会被保持在事务型的资源里（EntityManager 对象）。 这是对传统J2EE的体系结构的突破。再次说明，如果你习惯于传统J2EE的分层，也可以在你的Seam应用实行。但是对于许多的应用，这是明显的没有必要 。

Example 1.3. 

@Local
public interface Register
{
   public String register();
}

Example 1.4. 

<components xmlns="http://jboss.com/products/seam/components"
            xmlns:core="http://jboss.com/products/seam/core">
     <core:init jndi-pattern="@jndiPattern@"/>
</components>

Example 1.5. 

<?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>

Example 1.6. 

<?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>

Example 1.7. 

<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %>
<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %>
<%@ taglib uri="http://jboss.com/products/seam/taglib" prefix="s" %>
<html>
 <head>
  <title>Register New User</title>
 </head>
 <body>
  <f:view>
   <h:form>
     <table border="0">
       <s:validateAll>
         <tr>
           <td>Username</td>
           <td><h:inputText value="#{user.username}"/></td>
         </tr>
         <tr>
           <td>Real Name</td>
           <td><h:inputText value="#{user.name}"/></td>
         </tr>
         <tr>
           <td>Password</td>
           <td><h:inputSecret value="#{user.password}"/></td>
         </tr>
       </s:validateAll>
     </table>
     <h:messages/>
     <h:commandButton type="submit" value="Register" action="#{register.register}"/>
   </h:form>
  </f:view>
 </body>
</html>

Example 1.8. 

<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %>
<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %>
<html>
 <head>
  <title>Successfully Registered New User</title>
 </head>
 <body>
  <f:view>
    Welcome, <h:outputText value="#{user.name}"/>,
    you are successfully registered as <h:outputText value="#{user.username}"/>.
  </f:view>
 </body>
</html>

Example 1.9. 

<?xml version="1.0" encoding="UTF-8"?>
<application 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/application_5.xsd"
             version="5">

    <display-name>Seam Registration</display-name>

    <module>
        <web>
            <web-uri>jboss-seam-registration.war</web-uri>
            <context-root>/seam-registration</context-root>
        </web>
    </module>
    <module>
        <ejb>jboss-seam-registration.jar</ejb>
    </module>
    <module>
        <java>jboss-seam.jar</java>
    </module>
    <module>
        <java>el-api.jar</java>
    </module>
    <module>
        <java>el-ri.jar</java>
    </module>

</application>

Example 1.10. 

@Entity
@Name("message")
@Scope(EVENT)
public class Message implements Serializable
{
   private Long id;
   private String title;
   private String text;
   private boolean read;
   private Date datetime;

   @Id @GeneratedValue
   public Long getId() {
      return id;
   }
   public void setId(Long id) {
      this.id = id;
   }

   @NotNull @Length(max=100)
   public String getTitle() {
      return title;
   }
   public void setTitle(String title) {
      this.title = title;
   }

   @NotNull @Lob
   public String getText() {
      return text;
   }
   public void setText(String text) {
      this.text = text;
   }

   @NotNull
   public boolean isRead() {
      return read;
   }
   public void setRead(boolean read) {
      this.read = read;
   }

   @NotNull
   @Basic @Temporal(TemporalType.TIMESTAMP)
   public Date getDatetime() {
      return datetime;
   }
   public void setDatetime(Date datetime) {
      this.datetime = datetime;
   }

}

Example 1.11. 

@Stateful
@Scope(SESSION)
@Name("messageManager")
public class MessageManagerBean implements Serializable, MessageManager
{

   @DataModelprivate List<Message> messageList;

   @DataModelSelection@Out(required=false)private Message message;

   @PersistenceContext(type=EXTENDED)private EntityManager em;

   @Factory("messageList")public void findMessages()
   {
      messageList = em.createQuery("from Message msg order by msg.datetime desc").getResultList();
   }

   public void select(){
      message.setRead(true);
   }

   public void delete(){
      messageList.remove(message);
      em.remove(message);
      message=null;
   }

   @Remove @Destroypublic void destroy() {}

}

	注解@DataModel暴露了java.util.List类型的属性给JSF页面来作为javax.faces.model.DataModel的实例。 这允许我们在JSF<h:dataTable>的每一行中能使用可点击列表。在此例中，DataModel可在变量名为messageList的会话上下文中被使用。
	@DataModelSelection注解告诉了Seam来注入List元素到相应的被点击链接。
	注解@Out直接暴露了被选中的值给页面。 这样一来，每次可点击列表一旦被选中，Message就被会注入给有状态Bean的属性，紧接着向外注入（outjected）给变量名为message的事件上下文的属性。
	此有状态Bean有个EJB3的扩展持久化上下文（extended persistence context）。只要Bean存在，查询中获取的消息就会保留在受管理的状态中。 这样一来，此后对有状态Bean的所有方法调用勿需显式调用EntityManager就可更新这些消息了。
	当我们第一次浏览JSP页面时，messageList上下文变量尚未被初始化，@Factory注解告诉Seam来创建MessageManagerBean的实例并调用findMessages()方法来初始化上下文变量。 我们把findMessages()当作messages的工厂方法。
	select()将选中的Message标为已读，并同时更新数据库。
	delete()动作监听器方法将选中的Message从数据库中删除。
	对于每个有状态的会话Bean，Seam组件的所有方法中必须有一不带参数的方法被标为@Remove @Destroy以确保在Seam的上下文结束时删除有状态Bean，并同时清除所有服务器端的状态。

Example 1.12. 

<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %>
<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %>
<html>
 <head>
  <title>Messages</title>
 </head>
 <body>
  <f:view>
   <h:form>
     <h2>Message List</h2>
     <h:outputText value="No messages to display" rendered="#{messageList.rowCount==0}"/>
     <h:dataTable var="msg" value="#{messageList}" rendered="#{messageList.rowCount>0}">
        <h:column>
           <f:facet name="header">
              <h:outputText value="Read"/>
           </f:facet>
           <h:selectBooleanCheckbox value="#{msg.read}" disabled="true"/>
        </h:column>
        <h:column>
           <f:facet name="header">
              <h:outputText value="Title"/>
           </f:facet>
           <h:commandLink value="#{msg.title}" action="#{messageManager.select}"/>
        </h:column>
        <h:column>
           <f:facet name="header">
              <h:outputText value="Date/Time"/>
           </f:facet>
           <h:outputText value="#{msg.datetime}">
              <f:convertDateTime type="both" dateStyle="medium" timeStyle="short"/>
           </h:outputText>
        </h:column>
        <h:column>
           <h:commandButton value="Delete" action="#{messageManager.delete}"/>
        </h:column>
     </h:dataTable>
     <h3><h:outputText value="#{message.title}"/></h3>
     <div><h:outputText value="#{message.text2}"/></div>
   </h:form>
  </f:view>
 </body>
</html>