BEA ホーム | 製品 | デベロッパ・センタ | support | askBEA
 ドキュメントのダウンロード   サイト マップ   用語集 
検索

BPM クライアント アプリケーション プログラミング

 前 次 目次 索引 PDFで表示  

ワークフロー オブジェクトの発行

この章では、発行可能なオブジェクト、およびワークフロー オブジェクトの発行方法について説明します。内容は以下のとおりです。

この章に記載するメソッドの詳細については、Javadoc の com.bea.wlpi.server.admin.Admin を参照してください。WebLogic Integration Studio を使用したワークフロー オブジェクトの発行については、『WebLogic Integration Studio ユーザーズ ガイド』の「ワークフロー テンプレートの定義」を参照してください。

 


発行可能オブジェクトについて

発行可能オブジェクトは、com.bea.wlpi.common.Publishable インタフェースを実装する任意のオブジェクトで構成されます。Publishable インタフェースは、パッケージの作成、エクスポート、およびインポートをサポートします。

WebLogic Integration Studio またはカスタム設計クライアントを使用することにより、有効な発行可能オブジェクトであるワークフロー オブジェクトの作成、エクスポート、およびインポートが可能になります。

Publishable インタフェースで定義された発行可能オブジェクトを、その対応するタイプと共に次の表に示します。

表18-1 発行可能オブジェクトおよびタイプ

発行可能オブジェクト

タイプ

BusinessCalendarInfo

BUSINESS_CALENDAR

ClassInvocationDescriptor

BUSINESS_OPERATION

EJBInvocationDescriptor

BUSINESS_OPERATION

EventKeyInfo

EVENT_KEY

OrganizationInfo

ORG

RepositoryFolderInfoHelper

XML_REPOSITORY_FOLDER

RoleInfo

ROLE

TemplateDefinitionInfo

TEMPLATE_DEFINITION

TemplateInfo

TEMPLATE

XMLEntityInfoHelper

XML_REPOSITORY_ENTITY

UserInfo

USER

Publishable インタフェースが提供するメソッドの中で、発行可能オブジェクトの情報を取得するために使用できるメソッドを次の表に示します。

表18-2 Publishable インタフェース メソッド

メソッド

説明

public java.lang.Object getContents()

発行可能オブジェクトの内容を取得する。

public java.lang.String getEntryName()

発行可能オブジェクトのエントリ名を取得する。

public java.lang.String getOwnerName()

発行可能オブジェクトのオーナ名を取得する。

public java.util.List getReferencedPublishables(
java.util.Map publishables
)

指定された発行可能エンティティのマップ オブジェクトを基本にして、参照するすべての発行可能エンティティを取得する。

public int getType()

発行可能オブジェクトのタイプを取得する。有効なタイプのリストについては、発行可能オブジェクトおよびタイプの表を参照。


 

詳細については、Javadoc の com.bea.wlpi.common.Publishable を参照してください。

 


パッケージ エントリの作成

エクスポートの準備でパッケージ エントリを作成するには、com.bea.wlpi.common.PackageEntry オブジェクトを作成する必要があります。

次のコード例では、コンストラクタに対して新しい PackageEntry オブジェクトを作成します。

public PackageEntry(
com.bea.wlpi.common.Publishable p,
java.util.Map r,
boolean b
)

PackageEntry オブジェクトのデータ、データの定義に使用するコンストラクタ パラメータ、およびオブジェクトの定義後にそのデータへのアクセスに使用できる取得メソッドと設定メソッドを次の表に示します。

表18-3 PackageEntry オブジェクト データ

オブジェクト データ

コンストラクタ パラメータ

取得メソッド

設定メソッド

発行可能オブジェクト

有効な発行可能オブジェクトのリストについては、発行可能オブジェクトについてを参照。

p

public com.bea.wlpi.common.Publishable getPublishable()

public void setPublishable(com.bea.wlpi.common.Publishable p)

参照する発行可能オブジェクト

発行可能オブジェクト データの収集については、Publishable インタフェース メソッドの表を参照。

r

public java.util.Map getReferences()

public void setReferences(java.util.Map r)

発行可能オブジェクトをロックするかどうかを指定するブール フラグ

b

public boolean getPublished()

public void setPublished(boolean b)

エントリのタイプ

有効なタイプのリストについては、発行可能オブジェクトおよびタイプの表を参照。

なし

public java.lang.String getEntryType()

なし


 

詳細については、Javadoc のcom.bea.wlpi.common.PackageEntry を参照してください。

 


発行可能オブジェクトのパッケージのエクスポート

発行可能オブジェクトのパッケージを JAR ファイルにエクスポートするには、次の com.bea.wlpi.server.admin.Admin メソッドを使用します。

public byte[ ] exportPackage(
com.bea.wlpi.common.PublishPackage publishables,
java.lang.Object credential
) throws java.rmi.RemoteException,
com.bea.wlpi.common.WorkflowException

exportPackage() メソッドのパラメータを次の表に示します。パラメータには値を指定する必要があります。

表18-4 exportPackage() メソッドのパラメータ

パラメータ

説明

有効な値

publishables

エクスポートするワークフロー発行可能オブジェクト

Jar パッケージにエクスポートされる、エントリ タイプ com.bea.wlpi.common.PackageEntry を含むオブジェクト タイプ com.bea.wlpi.common.PublishPackage

発行可能エンティティの有効なタイプのリストについては、発行可能オブジェクトおよびタイプの表を参照。

credential

パスワードの値(必要な場合)

有効なパスワードを指定する、またはパスワードが不要な場合は null 値を指定する java.lang.Object オブジェクト。


 

このメソッドは、エクスポートしたすべてのオブジェクトを含む JAR ファイルのイメージである byte[ ] の配列を返します。

たとえば、次のコードでは、前回定義した発行可能な Map オブジェクトで指定された発行可能オブジェクトのパッケージをエクスポートします。このコード例では、adminAdmin EJB への EJBObject 参照を表します。

byte[ ] exportResults = admin.exportPackage(publishableMap);

exportPackage() メソッドの詳細については、Javadoc の com.bea.wlpi.server.admin.Admin を参照してください。

 


発行可能オブジェクトのパッケージのインポート

発行可能オブジェクトのパッケージをインポートするには、次の com.bea.wlpi.server.admin.Admin メソッドを使用します。

public java.lang.String importPackage(
byte[ ] pkg,
java.util.Map publishables,
java.lang.String orgId,
boolean activate,
java.lang.Object credential
) throws java.rmi.RemoteException,
com.bea.wlpi.common.WorkflowException

importPackage() メソッドのパラメータを次の表に示します。パラメータには値を指定する必要があります。

表18-5 importPackage() メソッドのパラメータ

パラメータ

説明

有効な値

pkg

インポートする発行可能オブジェクトの JAR ファイル

発行可能オブジェクトを含む JAR ファイルのイメージで構成された、有効な byte[ ] オブジェクト。

発行可能オブジェクトのパッケージのエクスポートについては、発行可能オブジェクトのパッケージのエクスポートを参照。

publishables

インポートするワークフロー発行可能オブジェクト

発行可能エンティティのタイプをキーとして指定し、PackageEntry オブジェクトを値として指定する「key-value」ペア付きの java.util.Map オブジェクト。

発行可能エンティティの有効なタイプのリストについては、発行可能オブジェクトおよびタイプの表を参照。

orgId

パッケージをインポートするオーガニゼーションの ID

有効なオーガニゼーション ID を指定する文字列。

オーガニゼーション ID のリストの取得については、すべてのオーガニゼーション名を取得するを参照。

activate

インポート時にパッケージをアクティブ化するかどうかを指定するブール フラグ

true (アクティブ化する) または false (アクティブ化しない)。

credential

パスワードの値(必要な場合)

有効なパスワードを指定する、またはパスワードが不要の場合は null 値を指定する java.lang.Object オブジェクト。


 

このメソッドは、未解決の参照など、報告された問題を含む文字列の値を返します。

たとえば、次のコードでは、shipping.jar ファイルと publishPackage マップ内で指定したとおり、発行可能オブジェクトを ORG1 オーガニゼーションにインポートします。このコード例では、adminAdmin EJB への EJBObject 参照を表します。

//JAR ファイルをバイト配列に読み込む
File jarFile = new File(“shipping.jar”);
pkg = new byte[(int)jarFile.length()];
FileInputStream fin = new FileInputStream(jarFile);
fin.read(pkg);
fin.close();
//コンテンツをマッピングしてインポートする
Map contents = admin.readPackage(pkg, “password”);
String importResults = admin.importPackage(
pkg, contents, “ORG1”, true, “password”);

発行可能オブジェクトはインポート時にアクティブ化され(アクティブ化の値は true に設定される)、abcd がパスワードとして使用されます。

importPackage() メソッドの詳細については、Javadoc の com.bea.wlpi.server.admin.Admin を参照してください。

 


発行可能オブジェクトのパッケージの読み取り

発行可能オブジェクトのパッケージを読むには、次の com.bea.wlpi.server.admin.Admin メソッドを使用します。

public java.util.Map readPackage(
byte[ ] pkg,
java.lang.Object credential
) throws java.rmi.RemoteException,
com.bea.wlpi.common.WorkflowException

readPackage() メソッドのパラメータを次の表に示します。パラメータには値を指定する必要があります。

表18-6 readPackage() メソッドのパラメータ

パラメータ

説明

有効な値

pkg

読み取りする発行可能オブジェクトの JAR ファイル

発行可能オブジェクトを含む JAR ファイルのイメージで構成された、有効な byte[ ] オブジェクト。

発行可能オブジェクトのパッケージのエクスポートについては、発行可能オブジェクトのパッケージのエクスポートを参照。

credential

パスワードの値(必要な場合)

有効なパスワードを指定する、またはパスワードが不要な場合は null 値を指定する java.lang.Object オブジェクト。


 

このメソッドは、発行可能エンティティのタイプをキーで指定し、また(発行可能エンティティのタイプに対応した xxxInfo オブジェクトを含む)異機種間の java.util.List オブジェクトを値として指定する、「key-value」付きの java.util.Map オブジェクトを返します。有効な発行可能オブジェクトとそれらのタイプのリストについては、発行可能オブジェクトおよびタイプの表を参照してください。

たとえば、次のコードでは、パスワードの abcd を使用して、shipping.jar ファイル内で指定された発行可能オブジェクトを読み込みます。このコード例では、adminAdmin EJB への EJBObject 参照を表します。

byte[ ] pkg = readFile(“shipping.jar”);
Map contents = admin.readPackage(pkg, “abcd”);

readPackage() メソッドの詳細については、Javadoc の com.bea.wlpi.server.admin.Admin を参照してください。

 

ページの先頭 前 次