Vest Open Source Project

Coconuts
   ドキュメント
   ダウンロード
   チュートリアル
   ライセンス

お問い合わせ
訪問者数：6097人

Coconuts チュートリアル

Coconutsチュートリアル

このページでは、初めてCoconutsを使う方を対象に環境設定から実際にCoconutsを使ったサンプルアプリケーションを構築します。

--目次--
■Step 0 -環境作成-
■Step 1 -Hello Coconuts-
■Step 2 -ログ拡張機能を使う-
■Step 3 -QueueInterfaceを使ったキューの登録-
■Step 4 -キューの設定をXMLに置き換える-
■Step 5 -カードのデータを表示する-

■Step 3 -QueueInterfaceを使ったキューの登録-

Step1とStep2ではCoconutsへのキューとActionの登録に"addQueueType"と"addActionType"を使いました。
CoconutsはSpringFrameworkを使用して、キューとActionの関連をXMLに置き換えることが出来ます。
Step3では、XMLに置き換える前段階として、キューと関連するActionをひとかたまりにする方法とひとかたまりの関連をCoconutsに登録する方法を紹介します。

Coconutsクラスには"addQueue"というメソッドがあります。
このメソッドのパラメータになっている"QueueInterface"が「一つのキューと関連するAction」を表します。

"QueueInterface"はインタフェースですので通常の登録では"Queue"クラスを使ってください。
特殊な用途のキューを作る場合に、"QueueInterface"を実装したクラスやQueue"を継承したクラスを作ります。

今回はキューは一つですので"Queue"インスタンスを一つ作ります

QueueInterface helloQueue = new Queue();

次はキュー名の指定です
キュー名の指定は"setQueueName"メソッドで行います。
エラーキュー名の指定は"setErrorQueueName"メソッドで行います。
今回はエラーキューは使いませんので"setQueueName"だけ使用します。

helloQueue.setQueueName("HelloQueue");

次に関連するActionの指定です。
Actionの指定は"setActionSet"メソッドで行います。
"setActionSet"にはActionインスタンスを保持するListインスタンスを指定します。
今回は"LoggingActionImpl"と"HelloAction"を指定します。

List helloActionSet = new ArrayList();
helloActionSet.add(new HelloAction());
helloActionSet.add(loggingActionImpl);
helloQueue.setActionSet(helloActionSet);

最後にQueueをCoconutsに登録します。
Queueの登録にはCoconutsクラスの"addQueue"メソッドを使います。

Coconuts.getInstance().addQueue(helloActionSet);

"HelloMain.java"はこのようになります。

import java.util.ArrayList;
import java.util.List;
import jp.co.vest.vosp.coconuts.Action;
import jp.co.vest.vosp.coconuts.Coconuts;
import jp.co.vest.vosp.coconuts.CoconutsInvalidParameterException;
import jp.co.vest.vosp.coconuts.Queue;
import jp.co.vest.vosp.coconuts.QueueInterface;
import jp.co.vest.vosp.coconuts.ext.logging.LoggingActionImpl;
public class HelloMain {
  public static void main(String[] args) {
    try {
      /*********** Action ***********/
      HelloAction helloAction = new HelloAction();
      
      LoggingActionImpl loggingActionImpl = new LoggingActionImpl();
      loggingActionImpl.setLogLevel("info");
      loggingActionImpl.setErrorLogLevel("error");
      loggingActionImpl.setMessageCreator(new HelloLogMessageCreator());
      
      /*********** Queue ************/
      QueueInterface helloQueue = new Queue();
      helloQueue.setQueueName("HelloQueue");
      List<Action> helloActionSet = new ArrayList<Action>();
      helloActionSet.add(new HelloAction());
      helloActionSet.add(loggingActionImpl);
      helloQueue.setActionSet(helloActionSet);
      
      Coconuts.getInstance().addQueue(helloQueue);
      
    } catch (CoconutsInvalidParameterException e) {
      e.printStackTrace();
    }
    try {
      Coconuts.getInstance().putEvent("HelloQueue","Coconuts");
    } catch (InterruptedException e) {
      e.printStackTrace();
    }
  }
}

では実際に起動してみましょう。
Step2と同様の結果が出ているはずです。