使用Seam Framework + JBoss 5.0 开发第一个Web应用 – 简单投票程序

Seam这个单词的本意是缝合、连接，因而，Seam的作用即是把Java EE 规范里的JSF 和 EJB技术完美融合在一起，免去了很多胶合代码，并增强了JSF 和 EJB的很多功能。Seam的设计目标之一是，写最少的代码，做最多的事，并且极力减少 “对XML的编程”。现在我们就用Seam_2.2.2_Final 来开发一个简单的投票程序。截图如下：

使用 seam-gen 生成应用程序骨架

在终端运行

seam setup

启动seam-gen。按照提示回答所有问题。这里使用postgreSQL数据库，以EAR的格式部署应用程序，工程名为: icon_vote。

关于sean-gen的使用方法，可以从官方的 seam_reference中找到详细说明。

开发Entity Bean

Entity Bean，即实体Bean，它的对象代表一个现实事物的实体。在Seam中(包括EJB中)，Entity Bean可以通过JPA持久化到数据库中。这里我们设计一个名为 Candidate的实体，用来表示一个候选人。Candidate 实体定义如下：

package com.lab.vote.model;import java.io.Serializable;import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;@Entity
public class Candidate implements Serializable {
@Id @GeneratedValue
private int id;
private String name; //候选人名
private String photoName; //照片文件名
private int voteAmount; //票数//get and set method}

@Entity注解用来告诉Seam这是一个实体bean，可以将其持久化的数据库中。 在没有指定@Table和@Column的情况下，seam默认使用名为作为表名，属性名作为字段名。JPA规定，每一个Entity Bean必须有一个属性被标注为@Id。这就是该实体的主键。我们用@GeneratedValue注解来指定，让提供持久化服务的数据库自动生成主键。
对于以上实体，seam会为我们自动创建一个如下的表：

开发POJO

POJO，即纯Java类。Seam允许我们使用单纯的Java类来实现EJB中Session Bean的功能。这样做的好处是，你的应用可以部署在没有EJB容器的应用服务器中，如Tomcat。还有一个好处是，不需要实现特定接口，减少了工作量。 VoteAction类的定义如下：

package com.lab.vote.action;import java.util.List;import javax.persistence.EntityManager;import org.jboss.seam.ScopeType;
import org.jboss.seam.annotations.Factory;
import org.jboss.seam.annotations.In;
import org.jboss.seam.annotations.Name;
import org.jboss.seam.annotations.Out;
import org.jboss.seam.annotations.Scope;
import org.jboss.seam.annotations.datamodel.DataModel;import com.lab.vote.model.Candidate;@Name("voteAction")
@Scope(ScopeType.SESSION)
public class VoteAction {
@In
private EntityManager em;
@DataModel
private List<Candidate> candidates;/*
 * 从数据库中取出所有候选人票数
 */
@SuppressWarnings("unchecked")
@Factory("candidates")
public void findCandidate() {
candidates = em.createQuery("select can from Candidate can order by can.name").getResultList();
}/*
 * 给指定候选人投票
 * 更新数据库
 */
public void vote(Candidate select) {
Candidate can = em.find(Candidate.class, select.getId());
can.setVoteAmount(can.getVoteAmount() + 1);
em.flush();
}
}

其中，@Name注解表示给该组件起一个名字，以便于我们在EL表达式中进行引用。 @Scope注解则指定该组件的生存范围，这里为Session。 @In注解表示要求Seam从上下文中注入一个EntityMenager类型的组件，以便于我们实现持久化工作。 @DataModel会将被标注的candidates属性自动注出到上下文，这样在EL表达式中就能直接引用candiates而不需要指定组件名了。

创建页面

修改 resource/WEB-INF/pages.xml文件，添加<page>节点，以指定Seam在渲染home.xhtm之前先调用 findCandidate()方法。

<page view-id="/home.xhtml">
        <action execute="#{voteAction.findCandidate()}"/>
    </page>

修改 view/home.xthml文件，内容如下：

<ui:define name="body">        <center>
        <h:dataTable value="#{candidates}" var="can">        <h:column>
        <p>Name: #{can.name}</p>
        </h:column>        <h:column>
        <img src="img/#{can.photoName}" />
        </h:column>        <h:column>
        <p>当前票数：#{can.voteAmount}</p>
        </h:column>        <h:column>
        <h:form><h:commandButton action="#{voteAction.vote(can)}" value="投票" /></h:form>
        </h:column>        </h:dataTable>
        </center>    </ui:define>

至此一个简单的投票程序开发完毕。 打开终端，进入工程目录下，运行

ant explode

即可将应用部署到JBoss下。

可以看到，在该过程中，除了pages.xml中的少量代码外，我们没有动过任何的xml配置文件。整个开发过程通过注解即可完成大部分功能。