Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

1.4. Seam と jBPM : todo 一覧サンプル

jBPM はワークフローやタスク管理に対して優れた機能を提供します。 jBPM の Seam との統合例として、 簡単な「todo 一覧」アプリケーションを見てみます。 タスク一覧の管理は jBPM の中核となる機能のため、 このサンプルには Java コードがほとんどありません。
View larger image

1.4.1. コードの理解
リンクのコピー

このサンプルの中心は jBPM のプロセス定義です。 2 種類の JSP と 2種類の基本的な JavaBean も使用します。 (セッション Bean はデータベースにアクセスせず、トランザクション動作も持たないためここでは必要ありません。) プロセス定義から始めましょう。

例1.16 todo.jpdl.xml

<process-definition name="todo">
  
  <start-state name="start">                                    
    <transition to="todo"/>
  </start-state>
  
  <task-node name="todo">                                       
    <task name="todo" description="#{todoList.description}">    
      <assignment actor-id="#{actor.id}"/>                      
    </task>
    <transition to="done"/>
  </task-node>
  
  <end-state name="done"/>                                      
  
</process-definition>
Copy to Clipboard Toggle word wrap

1

<start-state> ノードはプロセスの論理的な開始を表します。プロセスが開始すると、直ちに todo ノードに遷移します。

2

<task-node> ノードは、待ち状態 を表します。 ビジネスプロセスの実行が一時停止され、1 つまたは複数のタスクが行われるのを待機します。

3

<task> エレメントはユーザーにより実行されるタスクを定義します。このノードでは 1 つのタスクしか定義されていないため、それが完了すると実行が再開し、終了状態に遷移します。このタスクは todoList (JavaBeans の 1 つ) という Seam コンポーネントからその詳細を取得します。

4

タスクは生成されるとユーザーまたはユーザーグループに割り当てられる必要があります。 このサンプルでは、タスクは現在のユーザーに割り当てられ、actor という名前の Seam 組み込みコンポーネントから取得されます (いずれの Seam コンポーネントを使ってもタスク割り当てを実行できます)。

5

<end-state> ノードは、ビジネスプロセスの論理的な終了を定義します。 実行がこのノードに到達したとき、 プロセスインスタンスは破棄されます。
JBossIDE で提供されるプロセス定義エディタを使用してプロセス定義を見た場合、 以下のようになります。
View larger image
このドキュメントはノードのグラフとして ビジネスプロセス を定義します。 これは可能な限りシンプルにしたビジネスプロセスです。 実行すべき タスク がひとつあり、 そのタスクが完了するとビジネスプロセスが終了します。
最初の JavaBean はログイン画面 login.jsp を処理します。 単に actor コンポーネントを使用して jBPM actor ID を初期化します。 実際のアプリケーションではユーザー認証も必要となります。

例1.17 Login.java

@Name("login")
public class Login {
    @In
    private Actor actor;
  
    private String user;

    public String getUser() {
        return user;
    }

    public void setUser(String user) {
        this.user = user;
    }
  
    public String login() {
        actor.setId(user);
        return "/todo.jsp";
    }
}
Copy to Clipboard Toggle word wrap
ここでは、組み込み Actor コンポーネントをインジェクトするために @In を使用しているのがわかります。
次の JSP 自体は重要ではありません。

例1.18 login.jsp

<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h"%>
<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f"%>
<html>
  <head>
    <title>Login</title>
  </head>
  <body>
    <h1>Login</h1>
    <f:view>
      <h:form>
        <div>
          <h:inputText value="#{login.user}"/>
          <h:commandButton value="Login" action="#{login.login}"/>
        </div>
      </h:form>
    </f:view>
  </body>
</html>
Copy to Clipboard Toggle word wrap
2 つ目の JavaBean は、ビジネスプロセスインスタンスの開始とタスクの終了を担当します。

例1.19 TodoList.java

@Name("todoList")
public class TodoList
{
   private String description;                       
   
   public String getDescription()
   {
      return description;
   }

   public void setDescription(String description)
   {
      this.description = description;
   }
   
   @CreateProcess(definition="todo")                 
   public void createTodo() {}
   
   @StartTask @EndTask                               
   public void done() {}

}
Copy to Clipboard Toggle word wrap

1

description プロパティは JSP ページからユーザ入力を受け取りプロセス定義に公開して、タスクの description が設定されるようにします。

2

Seam @CreateProcess アノテーションは、名前付きプロセス定義のために jBPM プロセスインスタンスを生成します。

3

Seam @StartTask アノテーションはタスク上で作業を開始します。@EndTask はタスクを終了し、ビジネスプロセスの再開を可能にします。
より現実的なサンプルでは、 @StartTask と @EndTask は同じメソッドには登場しません。 タスクを完了するためにはアプリケーションを使用して何らかの作業が行われる必要があるためです。
最後に、このアプリケーションの中核となるのは todo.jsp です。

例1.20 todo.jsp

<%@ 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>Todo List</title>
  </head>
  <body>
    <h1>Todo List</h1>
    <f:view>
      <h:form id="list">
        <div>
          <h:outputText value="There are no todo items." 
                        rendered="#{empty taskInstanceList}"/>
          <h:dataTable value="#{taskInstanceList}" var="task" 
                       rendered="#{not empty taskInstanceList}">
            <h:column>
              <f:facet name="header">
                <h:outputText value="Description"/>
              </f:facet>
              <h:inputText value="#{task.description}"/>
            </h:column>
            <h:column>
              <f:facet name="header">
                <h:outputText value="Created"/>
              </f:facet>
              <h:outputText value=
                            "#{task.taskMgmtInstance.processInstance.start}">
                <f:convertDateTime type="date"/>
              </h:outputText>
            </h:column>
            <h:column>
              <f:facet name="header">
                <h:outputText value="Priority"/>
              </f:facet>
              <h:inputText value="#{task.priority}" style="width: 30"/>
            </h:column>
            <h:column>
              <f:facet name="header">
                <h:outputText value="Due Date"/>
              </f:facet>
              <h:inputText value="#{task.dueDate}" style="width: 100">
                <f:convertDateTime type="date" dateStyle="short"/>
              </h:inputText>
            </h:column>
            <h:column>
              <s:button value="Done" action="#{todoList.done}" 
                        taskInstance="#{task}"/>
            </h:column>
          </h:dataTable>
        </div>
        <div>
          <h:messages/>
        </div>
        <div>
          <h:commandButton value="Update Items" action="update"/>
        </div>
      </h:form>
      <h:form id="new">
        <div>
          <h:inputText value="#{todoList.description}"/>
          <h:commandButton value="Create New Item" 
                           action="#{todoList.createTodo}"/>
        </div>
      </h:form>
    </f:view>
  </body>
</html>
Copy to Clipboard Toggle word wrap
簡単にするためにセクションごとに見ていきます。
ページはタスク一覧を表示しています。 taskInstanceList と呼ばれる Seam 組み込みコンポーネントから取得します。 この一覧は JSF フォームの中で定義されています。

例1.21 todo.jsp (taskInstanceList)

<h:form id="list">
  <div>
    <h:outputText value="There are no todo items." 
                  rendered="#{empty taskInstanceList}"/>
    <h:dataTable value="#{taskInstanceList}" var="task" 
                 rendered="#{not empty taskInstanceList}">
      ...
    </h:dataTable>
  </div>
</h:form>
Copy to Clipboard Toggle word wrap
一覧の各エレメントは jBPM クラス TaskInstance のインスタンスです。 以下のコードは一覧中の各タスクの特定のプロパティを表示しています。 記述内容 (Description)、 優先順 (Priority)、 納期の値 (Due Date) には入力コントロールを使用し、ユーザーはこれらの値を更新することができます。

例1.22 TaskInstance List のプロパティ

<h:column>
  <f:facet name="header">
    <h:outputText value="Description"/>
  </f:facet>
  <h:inputText value="#{task.description}"/>
</h:column>
<h:column>
  <f:facet name="header">
    <h:outputText value="Created"/>
  </f:facet>
  <h:outputText value="#{task.taskMgmtInstance.processInstance.start}">
    <f:convertDateTime type="date"/>
  </h:outputText>
</h:column>
<h:column>
  <f:facet name="header">
    <h:outputText value="Priority"/>
  </f:facet>
  <h:inputText value="#{task.priority}" style="width: 30"/>
</h:column>
<h:column>
  <f:facet name="header">
    <h:outputText value="Due Date"/>
  </f:facet>
  <h:inputText value="#{task.dueDate}" style="width: 100">
    <f:convertDateTime type="date" dateStyle="short"/>
  </h:inputText>
</h:column>
Copy to Clipboard Toggle word wrap

注記

Seam では文字列を日付に変換するデフォルトの JSF 日付コンバータを提供しているので、 #{task.dueDate} にバインドされるフィールドにはコンバータは必要ありません。
このボタンは @StartTask @EndTask アノテーション付きのアクションメソッドを呼び出すことによりタスクを終了します。 タスク ID を要求パラメータとして Seam に渡します。 
<h:column> 
  <s:button value="Done" action="#{todoList.done}" 
            taskInstance="#{task}"/>
</h:column>
Copy to Clipboard Toggle word wrap
seam-ui.jar パッケージから Seam <s:button> JSF コントロールを使用していることに留意してください。 このボタンがタスクのプロパティを更新します。 フォームがサブミットされると、 Seam と jBPM はタスクの永続に対して変更を加えます。 アクションリスナーメソッドには必要ありません。 
 <h:commandButton value="Update Items" action="update"/>
Copy to Clipboard Toggle word wrap
ページの 2 つ目のフォームでは @CreateProcess アノテーション付きアクションメソッドを使って新しい項目を作成します。 
 <h:form id="new">
   <div> 
      <h:inputText value="#{todoList.description}"/> 
      <h:commandButton value="Create New Item" 
         action="#{todoList.createTodo}"/>
    </div> 
</h:form>
Copy to Clipboard Toggle word wrap
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat