BlogJava-phyeas-文章分类-Seam项目实战

Seam新手实战(4)：外键

phyeas — Wed, 24 Dec 2008 15:02:00 GMT

一个图书管理系统中的两个对象：Book(书籍),BookType(书籍类型)。Book和BookType之间是多对一关系。

说到主从表的关联关系，自然而然地想起的一种实现方式就是选择框，比如在Book的编辑界面是使用一个类型的下拉选择框，选择一个类型，然后保存。于是就有下例代码：

<h:selectOneMenu id="type" value="#{bookHome.instance.bookType.typeId}">
<f:selectItems value="#{bookTypeList.typeSelectItems}" />
h:selectOneMenu>

这段代码的作者（我）原本的想法是让这个下拉框与bookHome.instance里的bookType.typeId帮定。比如当前的book类型id是1，修改后将book类型的id改为2，更新到数据库。但是很不幸。这段代码并不能执行预期的行为，或者说它还附加了其他行为。即Seam已经觉察到了在这个book中的类型的一个属性（主键值）已经改变了。于是，试图更新这个类型。但是JPA的规范中是不允许更改主键的，这就引起了一个错误。不信可以试下哦，呵呵。（以上描述我已经尽可能说清楚我的想法，但可能还是不怎么清楚，希望大家看不懂的说说哪里看不懂，我好改正）。我想说的是，不要直接帮定到外键，而是现帮定到一个临时变量，比如在bookHome中多写一个变量：

public class BookHome extends EntityHome<Book>{
private Long typeId;
//..getter setter
}

然后将下拉框邦定到这个变量上，比如：

<h:selectOneMenu id="type" value="#{bookHome.typeId}">
<f:selectItems value="#{bookTypeList.typeSelectItems}" />
h:selectOneMenu>

。然后在重载的persist或者update方法中写上：

BookType newType = getEntityManager().find(BookType.class, typeId);
instance.setType(newType);
return super.persist();

就完成了。我叫它“转移邦定”，呵呵

Seam的解决方案：
其实Seam有另一种解决方案。比如如果你是自动生成代码的方式，在BookEdit.xhtml中就会看到这样的代码：

<div class="association" id="bookTypeParent">

        <h:outputText value="There is no bookType associated with this book."
                   rendered="#{bookHome.instance.bookType == null}"/>

        <rich:dataTable var="bookType"
                   value="#{bookHome.instance.bookType}"
                rendered="#{bookHome.instance.bookType != null}"
              rowClasses="rvgRowOne,rvgRowTwo"
                      id="bookTypeTable">
            <h:column>
                <f:facet name="header">typeIdf:facet>
                #{bookType.typeId}
            h:column>
            <h:column>
                <f:facet name="header">bookType typeIdf:facet>
                #{bookType.bookType.typeId}
            h:column>
            <h:column>
                <f:facet name="header">typeNamef:facet>
                #{bookType.typeName}
            h:column>
            <h:column>
                <f:facet name="header">actionf:facet>
                <s:link view="/BookType.xhtml"
                         id="viewbookType"
                      value="View"
                propagation="none">
                    <f:param name="bookTypeTypeId"
                           value="#{bookType.typeId}"/>
                s:link>
            h:column>
        rich:dataTable>

        <div class="actionButtons">
            <s:button value="Select bookType"
                       view="/BookTypeList.xhtml">
                <f:param name="from" value="BookEdit"/>
            s:button>
        div>

    div>

点击“Select bookType”页面就自动跳转到BookTypeList页面，列出所有的类型，每个类型后面都有一个select连接，点击这个连接就可选中这个类型。然后回到BookEdit.xhtml。很Seam很强大吧，呵呵。其实为何这样能完成一个选择都是在BookEdit.page.xml里配置的。配置大概如下：

   <begin-conversation join="true"/>

   <action execute="#{bookHome.wire}"/>

   <param name="bookFrom"/>
   <param name="bookBookId" value="#{bookHome.bookBookId}"/>
   <param name="bookTypeFrom"/>
   <param name="bookTypeTypeId" value="#{bookTypeHome.bookTypeTypeId}"/>

<begin-conversation join="true"/> ：开始一个conversation（我暂称之为“页面流”），如果已存在，就加入。而不重新创建。
<action execute="#{bookHome.wire}"/> ：一最重要的这个。如果没有执行这个方法这段跳转就没有任何效果了。，先来看下这个方法是怎么写的吧：

public void wire() {
        getInstance();//获取instance，放在这里是为了加在instance
        BookType bookType = bookTypeHome.getDefinedInstance();//获取类型。
        if (bookType != null) {//如果选择的类型不为null
            getInstance().setBookType(bookType);//设置书籍类型
        }
    }

那bookTypeHome从哪来的呢？天上掉下的？呵呵，当然不是。就在BookHome的上部分：

@In(create = true)
BookTypeHome bookTypeHome;

前面我说过了。这个@In就是拿来做双向注入的。bookTypeHome是要注入的组件名称。
其他的都是参数了，没啥好解释的。
但为什么在BookTypeList页面点select，怎么就会自动跳转到BookEdit.xhtml呢？奥秘就在这段代码里（BookTypeList.xhtml）：

<s:link view="/#{empty from ? 'BookType' : from}.xhtml"
                   value="Select"
                      id="bookType">
                <f:param name="bookTypeTypeId"
                        value="#{bookType.typeId}"/>
            s:link>

从BookEdit里传来一个from。

<s:button value="Select bookType"
                       view="/BookTypeList.xhtml">
                <f:param name="from" value="BookEdit"/>
            s:button>

就告诉了BookTypeList，是从BookEdit里来的，点Select的时候就不要去其他地方了。直接回去。

好了，今天到这，困了，上面讲的不明白的欢迎email或qq联系我。。

phyeas 2008-12-24 23:02 发表评论

Seam新手实战(3)：entities

phyeas — Fri, 19 Dec 2008 15:51:00 GMT

对于一个应用来说，实体对象即是这个应用的数据基础，一开始设计都是从数据模型设计开始的。那我们就从这个Seam的entities开始吧。

在Seam中你有两种方式创建你的实体对象，一是从数据库生成，二是自己创建，再由seam帮你将对应的数据表建起来。从应用的角度来说，两种方式没有啥区别，但从开发的角度讲，推荐使用生成的方式。因为这样可以剩下很多敲代码的时间。呵呵。好戏放后面，让我们先看自己创建entity的过程。

前提是你的工程已经创建完毕（如何创建过程请看本系列《1》）。

一般实体类都放在src/model下。便于辨别那些是业务对象，哪些是数据对象（关于Seam的分层网上很多地方有说，这里就不说了）。在src/model文件夹上右键－》new->Seam Entity。就可以看到如下界面：

这里就只需要填写名称即可。解释一下它们的意思：
                                                    Seam Project:即属于那个工程
                                                    Seam entity class name:即这个类的名称
                                                    Package name:属于那个包的
                                                    Master page name:这个会自动生成的家伙是说你的列表页面和业务动作处理（action）的名称
                                                    Page name：这个也会自动生成，是指明细页面的名称和业务动作处理的名称（两个是相同名称的）

随便起个名字，点Finish，可能需要等待一段时间，这是因为Seam自动创建了一个xhtml页面，正在试图打开。打开这个东西需要一点时间
创建成功后。在你所选的包下就会多一个类。里面只有三个属性：id,version,name。以我创建的User类为例：

@Entity
public class User implements Serializable {

    //seam-gen attributes (you should probably edit these)
    private Long id;
    private Integer version;
    private String name;

    //add additional entity attributes

    //seam-gen attribute getters/setters with annotations (you probably should edit)

    @Id @GeneratedValue
    public Long getId() {
         return id;
    }

    public void setId(Long id) {
         this.id = id;
    }

    @Version
    public Integer getVersion() {
         return version;
    }

    private void setVersion(Integer version) {
         this.version = version;
    }

    @Length(max=20)
    public String getName() {
         return name;
    }

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

这个类实现自Serializable是因为这个类需要被序列化，当遇到特殊情况时可以起写作用。先解释下这些注解吧。
@Entity：标注这是一个实体对象这是JPA的标记。表明即是类名，当然，你也可以让这两个东西不是对应关系，在@Entity下加个＠Table注解即可。比如
@Entity
@Table(name = "BookType", catalog = "test")
@Id 主键标识，为了确保对象的唯一性，建议每个entity都加一个主键，否则你就等着出错吧。呵呵
@GeneratedValue 表示主键值为自动生成值
@Version 这个是jpa的乐观锁机制。有兴趣了解乐观锁及悲观锁的可以看hibernate的资料，篇幅太长，这里就不介绍了。
@Length(max=20) 限制长度为最大20，这个在作验证时有用。
恩。这个实体类就这么简单。呵呵，你还需要其他字段就再加上去吧。。
其实到这个，整个CRUD的页面和处理方法都写好了。这时只要将项目部署到服务器，然后访问列表页面即可。忘了说了，我这里生成的页面是userList.xhtml和user.xhtml。工程名为SeamTest。所以我要访问http://localhost:8080/SeamTest/userList.seam，一个增删改查就出来了哦。还有比这更快的吗。呵呵，现在要在页面上添加东西就照葫芦画瓢。Ctrl+C and Ctrl+v就出来了。如果页面不符合规则，再调也可以，这里简单说下seam的帮定机制，还是已我的user为例：

<h:inputText id="name" required="true"
value="#{userHome.instance.name}"/>

seam 的帮定机制是根据value进行的。也就是说，无论你的id写的是什么。这个文本框的东西最终都要赋值到name上。这就是seam的邦定机制。这样邦定会有一个问题。等以后介绍，现在先接着看

生成entities。用数据库表生成entities就更简单了。在src/model文件夹上右键，然后选择new->Seam Generate entities。会弹出这样的窗口：

不用修改什么选项，直接finish就可以了。这样entity就会生成了，就连页面什么的都生成了。增删改查也写好了。呵呵，你就做下微调就可以了。这里需要注意的是，你刚刚通过Seam创建的表也被当作普通表生成到你的应用程序里。这样如果你使用的是linux平台，就会多一个UserList.xhtml（刚才那个是userList.xhtml）。如果是windows平台不知道会怎么样哦(windows文件名不分大小写)。

可能的错误：有几个网友跟我说他们生成entities时发生了错误。错误大意是找不到模板或session包。这个是由于使用的版本太新造成的。JBoss Tools3.0仅支持Seam2.0，不要使用2.1哦。过写时候我把那个错误信息贴上来，供大家参考。

大概就这些了。有什么问题欢迎讨论。

phyeas 2008-12-19 23:51 发表评论

Seam新手实战(2)：自动生成的代码2-xhtml文件

phyeas — Mon, 15 Dec 2008 01:15:00 GMT

在Eclipse生成的代码中页面是使用facelets、richFaces等编写的，所以页面使用的文件格式是xhtml。而非jsp。当然了，你也可以是用jsp编写。这些生成的xhtml全部都在WebContent下

首先看home.xhtml。

<ui:composition xmlns="http://www.w3.org/1999/xhtml"
    
                xmlns:s="http://jboss.com/products/seam/taglib"
    
                xmlns:ui="http://java.sun.com/jsf/facelets"
    
                xmlns:f="http://java.sun.com/jsf/core"
    
                xmlns:h="http://java.sun.com/jsf/html"
    
                xmlns:rich="http://richfaces.org/rich"
    
                template="layout/template.xhtml">
    
ui:composition>

ui:composition元素：UI组件，使用这个元素做根元素表示这个页面并不是一个完整的页面，而是需要一个template页面作为摸版的内容页面。

xmlns：根元素命名空间。就是那些不带前缀标签比如

xmlns:s：Seam元素的命名空间。

template：摸版页面

摸版页面：

<html xmlns="http://www.w3.org/1999/xhtml"
    
      xmlns:ui="http://java.sun.com/jsf/facelets"
    
      xmlns:h="http://java.sun.com/jsf/html"
    
      xmlns:f="http://java.sun.com/jsf/core"
    
      xmlns:s="http://jboss.com/products/seam/taglib">
    
<head>
    
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    
    <title>SeamTesttitle>
    
    <link href="stylesheet/theme.css" rel="stylesheet" type="text/css" />
    
head>
    
<body>
    
    <ui:include src="menu.xhtml">
    
        <ui:param name="projectName" value="SeamTest"/>
    
    ui:include>
    
    <div class="body">
    
        <ui:insert name="body"/>
    
    div>
    
    <div class="footer">
    
        Powered by <a href="http://jboss.com/products/seam">Seama>.
    
        Generated by seam-gen.
    
    div>
    
body>
    
html>

ui:include：与差不多。但这里没有引入jsp命名空间。所以使用。

：这个是一个template页面。这个标签表示插入一个名为body的内容块。在内容页面--home.xhtml--与此对应的是：。在Seam-gen生成的页面中几乎所有的页面都将template指向template.xhtml。还有另一种使用摸板的方式。比如layout/edit.xhtml。

<ui:composition  xmlns="http://www.w3.org/1999/xhtml"
    
                 xmlns:ui="http://java.sun.com/jsf/facelets"
    
                 xmlns:h="http://java.sun.com/jsf/html"
    
                 xmlns:f="http://java.sun.com/jsf/core"
    
                 xmlns:s="http://jboss.com/products/seam/taglib">
    
    <div class="prop">
    
        <s:label styleClass="name #{invalid?'errors':''}">
    
            <ui:insert name="label"/>
    
            <s:span styleClass="required" rendered="#{required}">*s:span>
    
        s:label>
    
        <span class="value #{invalid?'errors':''}">
    
            <s:validateAll>
    
                <ui:insert/>
    
            s:validateAll>
    
        span>
    
        <span class="error">
    
            <h:graphicImage value="/img/error.gif" rendered="#{invalid}" styleClass="errors"/>
    
            <s:message styleClass="errors"/>
    
        span>
    
    div>
    
ui:composition>

这里依然是使用作为内容页面的插入块。这里有两块第一块是有name属性的，第二块则是没有name属性的。如果没有name属性，表示在插入块中没有放在

            <s:decorate id="nameDecoration" template="layout/edit.xhtml">
    
                <ui:define name="label">Nameui:define>
    
                <h:inputText id="name" required="true"
    
                             value="#{bookHome.instance.name}"/>
    
            s:decorate>

这里这就是定义那个有名字的插入块。而接下来的则是放在了下面没有名字的中。上面的代码也展示了使用摸板的另一种方式。使用使用摸板块，摸板页面的根需要是一个元素。s:decorate是一个seam元素。必须在seam的管理的页面中使用。

其他：

jsf中的form是不需要action的。比如

标签的rendered属性表示在什么情况下显示。html标签没有rendered属性，比如div标签没有rendered。

其他的jsf标签我们可以通过学习jsf学习。因为jsf标签，richFaces标签，faceslet标签太多了。这里就不一一介绍了。。。。大家有什么好的资料也麻烦告诉我哦。

phyeas 2008-12-15 09:15 发表评论

Seam新手实战(2)：自动生成的代码

phyeas — Tue, 09 Dec 2008 04:03:00 GMT

创建工程后会生成一大堆代码。基本上都是配置文件。而在做 Seam 开发的过程中是不需要整天修改配置文件的。最多写写pages.xml或者faces-config.xml。Seam生成的文件夹如下面的结构：

其中。build文件夹存放的是Ant编译后的东西。
            resources文件夹里就一个文件。XXXX-ds.xml。是用于存放数据源(DataSource)配置文件的。
            src：
                        src下有两个文件夹：action和modal。即存放页面动作与领域模型。
                        在modal中有个META-INF文件夹，JPA的配置文件persistence.xml就存放在这个文件夹里。
                        在Modal文件夹里还有几个值得注意的文件。
                        比如messages_en.properties和security.drl。messages_en.properties是存放系统消息的。
                        如果想让Seam的系统消息显示中文就需要翻译这个文件。而security.drl则是定义安全规则的。
                        在action文件夹中。有一个包：org\domain\SeamTest\session。其中Authenticator.java会自动生成。用于做登陆验证的。在这里简单介绍下，先看代码：

@Name("authenticator")
public class Authenticator
{
    @Logger Log log;

    @In Identity identity;

    public boolean authenticate()
    {
        log.info("authenticating #0", identity.getUsername());
        //write your authentication logic here,
        //return true if the authentication was
        //successful, false otherwise
        identity.addRole("admin");
        return true;
    }
}

         @Name 是用于定义Seam组件。这样定义的Seam组件可用于双向注入和其他页面操作。如果你没有这个注释。则表示这个并不是Seam组件，所以也起了一个标识Seam组件的目的。在这里Seam组件被命名为"authenticator"，在页面上要调用这个组件的authenticate方法需要这样写：#{authenticator.authenticate}
        @Logger用于注入日志组件
        @In        用于双向注入。在注入时Seam会寻找当前容器中与该变量名相符的组件。当然了。也可以注入变量名不同的组件。需要指定组件名称，例如：@In("ident")。这样的意思就是在容器中寻找名为"ident"的组件将其注入到该类中。（Seam的作用域比较复杂，本篇暂不介绍）
        接下来便是authenticate方法，这个方法中其实最重要的是后面两句。log.info(....)的意思即保存日志信息，最后那句意思即通过验证。如果验证的用户名密码不符合则return false;来表示拒绝登陆。比较复杂的是identity.addRole。这个方法是为当前用户添加一个角色。单如果该方法最终返回false。那么这些添加的角色将不保存。
         那么。如何让Seam知道当用户登陆时调用这个方法验证呢？在/WebContent/WEB-INF/components.xml中有这样一段配置：

   <security:identity authenticate-method="#{authenticator.authenticate}"
                           security-rules="#{securityRules}"
                              remember-me="true"/>

其中authenticate-method即验证的方法。是以组件形式调用。还有一个security-rules属性则是安全规则。在哪里配置的？就在上面。

   <drools:rule-base name="securityRules">
       <drools:rule-files><value>/security.drlvalue>drools:rule-files>
   drools:rule-base>

这就是刚刚说的那个文件。
既然说到components.xml，那我们就来看下这个文件里还有些什么东西。

<core:init debug="true" jndi-pattern="@jndiPattern@"/>

这段代码是定义jndi查找规则的。@jndiPattern@的定义是在/src/modal/components.properties里的这样一段配置：

#
#Fri Dec 05 10:37:03 CST 2008
jndiPattern=\#{ejbName}/local
embeddedEjb=false

这段配置的意思是开启jndi查找规则是ejb组件名称/local。即使用本地EJB组件。而非远程EJB组件

   <core:manager concurrent-request-timeout="500"
                 conversation-timeout="120000"
                 conversation-id-parameter="cid"
                 parent-conversation-id-parameter="pid"/>

conversation-timeout conversation(页面流)过期时间。我将conversation称为页面流可能不太合适。可以根据你的理解去称呼它。它是一段页面流转的过程定义。Seam中定义了一conversation作用域
conversation-id-parameter用于定义conversation的reuqest parameter name。即因为用户现在在哪个页面流中需要浏览器回传一个参数才知道。
parent-conversation-id-parameter。conversation允许定义子页面流。这个属性定义浏览器回传父conversation的参数名

   <persistence:managed-persistence-context name="entityManager"
                                     auto-create="true"
                          entity-manager-factory="#{SeamTestEntityManagerFactory}"/>

这个就是jpa的entityManager组件的定义了。在Seam组件中使用@In("entityManager")将会自动注入这个组件

   <event type="org.jboss.seam.security.notLoggedIn">
       <action execute="#{redirect.captureCurrentView}"/>
   event>
   <event type="org.jboss.seam.security.loginSuccessful">
       <action execute="#{redirect.returnToCapturedView}"/>
   event>

这个是对于登陆用的。当客户访问一个页面需要登陆。但用户又没有登陆。这时会转到一个登陆页面。登陆完毕后又转会用户要进入的页面。如果有这样的需求就要加上这两句配置。不过Seam已经自动生成了
其他：默认生成的 face-config.xml里没有支持中文。可以加入

    <application>
        <view-handler>com.sun.facelets.FaceletViewHandlerview-handler>
        <locale-config>
            <default-locale>endefault-locale>
            <supported-locale>bgsupported-locale>
            <supported-locale>desupported-locale>
            <supported-locale>ensupported-locale>
            <supported-locale>frsupported-locale>
            <supported-locale>trsupported-locale>
        locale-config>
    application>

代码:

<supported-locale>zh_CNsupported-locale>

phyeas 2008-12-09 12:03 发表评论

Seam新手实战(1)：环境搭建

phyeas — Fri, 05 Dec 2008 03:21:00 GMT

首先说下我使用的环境：JDK1.6,JBOSS4.2,JBOSS TOOLS 3.0,Eclipse with wtp3.4,JBOSS SEAM2.0
Eclipse下载地址：http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/ganymede/SR1/eclipse-jee-ganymede-SR1-win32.zip
JBOSS Tools下载地址：http://www.jboss.org/tools/download/index.html
其他JBOSS的东西都可以在这找到：http://www.jboss.org/download/
下载完毕后配置环境：
   JDK：这个网上大把。不说了
   Eclipse：这个就不用说了，直接解压就可以用。
JBossTools：如果你的环境和我的一样，那就在dropins下新建一个文件夹。然后将解压后的features和 plugins文件夹拷贝到里面，这样JBoss Tools就安装好了。安装完后启动Eclipse。将视图转到Seam视图下。

   配置Seam：下载JBoss Seam后随便解压到一个位置。然后在Eclipse中选择菜单：Windows->Preferences。在左边的树中选择JBoss Tools->Web->Seam。在右边会出现一个表格和一个add按钮。点Add跳出一个窗口。点Browser选择你刚刚解压出来的Seam的路径。点finish就配置好了。
配置JBoos Server：配置JBOSS服务器。还是选择Windows->Preferences。在左边的树中选择Server->runtime Environments。add->选择Jboss AS解压路径。finish。还有。。。。在工具栏中有个这个图标。点旁边的下拉框。选择New Server。选择路径，下一步时会让你填用户名密码，初始用户名和密码都是admin。
OK，配置好了

试下先。
将视图转到Seam视图下。不会的就先看前面。然后再 File -> New -> Seam Project

需要选的地方是Configureation。默认是1.2的。选择2.0

然后Next -> Next -> Next -> Next到配置数据库连接的位置
选择 new 一个。进入配置界面。我现在用的是sqlserver。以下以sqlserver为例：

选择要配置的数据库类型后填写Name；然后Next
配置驱动，New一个

配置Jar List后就FINISH了。

然后后面的步骤就简单了。直接可以finish。这样会新建两个工程。一个是主工程。一个是测试用的。
JBoss Tools已经帮你部署到了你选择的Jboos服务器里。
现在直接运行JBoss就OK了。如果你配置了Jboos Server。在工具栏中有个这样的东西第一个是运行Jboss服务器，第二个是用Debug模式运行，第三个是停止。直接点绿色的箭头。启动时可能会报一个错误：java.sql.SQLException: [Microsoft][SQLServer 2000 Driver for JDBC][SQLServer]对象名 'information_schema.system_sequences' 无效。这是因为Seam启动时需要这个东西。单数据库里却没有。。不要以为information_schema是库名，而system_sequences是表名哦。因为就算你在数据库里建了这样一个库和表也是没用的。解决办法是修改src/module/META-INF/下的persistence.xml。将里面的hibernate.hbm2ddl.auto设置为create-update。让seam自己去创建对象。但又不自动删除。不能用create-drop。因为如果用create-drop在服务器关闭时Seam会自动将它删除。下次重新创建。而这也会秧及你的数据表。。。只要用create-update启动一次即可。也可以只create，后面每次就可以用update了。其实可以不换成只update。用create-update也挺好。因为如果数据库中存在该数据表。Seam就不会再重新create
如果数据库中的表与将要创建的表结构一致。Seam就不会更新表结构
重新启动服务器。

启动完毕后访问http://localhost:8080/SeamTest/home.seam
如果出现如下页面就说明所有配置都已完成。让我们开始Seam吧。

phyeas 2008-12-05 11:21 发表评论