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

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

 前 次 目次 索引 PDFで表示  

プロセス エンジン情報へのアクセス

この章では、WebLogic Integration プロセス エンジンに関する情報にアクセスする方法について説明します。この章の内容は以下のとおりです。

この章に記載されているメソッドの詳細については、Javadoc の com.bea.wlpi.server.serverproperties.ServerProperties または com.bea.wlpi.client.common.WLPI を参照してください。

 


サーバ バージョンの取得

サーバ バージョンを取得するには、次の com.bea.wlpi.server.serverproperties.ServerProperties メソッドを使用します。

public com.bea.wlpi.common.VersionInfo getServerVersion(
) throws java.rmi.RemoteException

このメソッドにより、サーバ バージョンが VersionInfo オブジェクトとして返されます。バージョンに関する情報にアクセスするには、VersionInfo オブジェクトに記載の VersionInfo オブジェクト メソッドを使用します。

たとえば、次のコードは、バージョンを取得して version オブジェクトに保存します。このコード例では propertiesServerProperties EJB への EJBObject 参照を表しています。

VersionInfo version = properties.getServerVersion();

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

 


パッケージ バージョンの取得

サーバがサポートするパッケージ バージョンを取得するには、次の com.bea.wlpi.server.serverproperties.ServerProperties メソッドを使用します。

public com.bea.wlpi.common.VersionInfo getPackageVersion(
) throws java.rmi.RemoteException

このメソッドにより、パッケージ バージョンが VersionInfo オブジェクトとして返されます。バージョンに関する情報にアクセスするには、VersionInfo オブジェクトに記載の VersionInfo オブジェクト メソッドを使用します。

たとえば、次のコードは、パッケージ バージョンを取得して version オブジェクトに保存します。このコード例では propertiesServerProperties EJB への EJBObject 参照を表しています。

VersionInfo version = properties.getPackageVersion();

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

 


テンプレート定義バージョンの取得

サーバがサポートするテンプレート定義バージョンを取得するには、次の com.bea.wlpi.server.serverproperties.ServerProperties メソッドを使用します。

public com.bea.wlpi.common.VersionInfo getTemplateDefinitionVersion(
) throws java.rmi.RemoteException

このメソッドによって、サーバがサポートするテンプレート定義バージョンが VersionInfo オブジェクトとして返されます。バージョンに関する情報にアクセスするには、VersionInfo オブジェクトに記載の VersionInfo オブジェクト メソッドを使用します。

たとえば次のコードは、サーバがサポートするテンプレート定義バージョンを取得して version オブジェクトに保存します。このコード例では propertiesServerProperties EJB への EJBObject 参照を表しています。

VersionInfo version = properties.getTemplateDefinitionVersion();

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

 


サーバ プロパティの取得

サーバ プロパティを取得するには、次の com.bea.wlpi.server.serverproperties.ServerProperties メソッドを使用します。

public java.util.Properties getProperties(
) throws java.rmi.RemoteException

このメソッドにより、Java システム プロパティやその他の定義済みプロパティを含むサーバ プロパティが返されます。

注意: クラスタ化された環境では、コンフィグレーションされているルーティング アルゴリズムに従ってメソッド要求がサーバに送信されるので、Java システム プロパティのリモート検査機能が制限されます。メソッド呼び出しによって返される情報は変化します(特に、クラスタ内のシステムの仕様が一意の場合)。

たとえば次のコードは、サーバ プロパティを取得して props オブジェクトに保存します。このコード例では propertiesServerProperties EJB への EJBObject 参照を表しています。

Properties props = properties.getProperties();

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

 


コンビニエンス メソッドの使い方

com.bea.wlpi.client.common.WLPI クラスには、サーバ情報にアクセスするためのコンビニエンス メソッド群が含まれています。これらのメソッドを次の表にまとめます。

表4-1 サーバ情報にアクセスするためのコンビニエンス メソッド

メソッド

説明

public com.bea.wlpi.common.VersionInfo
getServerVersion(
) throws java.lang.IllegalStateException, com.bea.wlpi.common.WorkflowException

ServerProperties セッション EJB にアクセスして BPM サーバ バージョンを返す。このメソッドによって、テンプレートに対応する com.bea.wlpi.common.VersionInfo オブジェクトが返される。バージョンに関する情報にアクセスするには、VersionInfo オブジェクトに記載の VersionInfo オブジェクト メソッドを使用する。

public com.bea.wlpi.common.VersionInfo
getServerTemplateDefinitionVersion(
) throws java.lang.IllegalStateException, com.bea.wlpi.common.WorkflowException

ServerProperties セッション EJB にアクセスし、現バージョンの WebLogic Integration でサポートされているテンプレート定義バージョンを返す。このメソッドによって、テンプレートに対応する com.bea.wlpi.common.VersionInfo オブジェクトが返される。バージョンに関する情報にアクセスするには、VersionInfo オブジェクトに記載の VersionInfo オブジェクト メソッドを使用する。


 

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

 


プロセス エンジンに関する情報へのアクセス例

この節では、コマンドライン管理クライアント サンプルから抜粋して、サーバ プロパティへのアクセス方法を示します。

ユーザと通信を行うための入力ストリームが定義されており、ユーザはどのアクションを実行するかを指定するよう求められます。ユーザが Server Properties オプションを選択した場合、システムによってサーバ バージョンとテンプレート定義バージョンが取得され、返された VersionInfo オブジェクトにより、サーバとテンプレート定義に関する他の情報(名前、メジャー/マイナー/ビルド バージョンなど)が取得されます。さらに、サーバ プロパティの名前と値も表示されます。

重要なコード行は、太字で強調されています。このサンプルでは、文字列 serverPropertiesServerProperties EJB への EJBObject 参照を表しています。

/* ツール タイトルを表示する */
System.out.print( "¥n--- Command Line Administration v1.1 ---" );

/* メイン メニューを表示してユーザと交信する */
while( true ) {
/* メニューを表示する */
System.out.println( "¥n--- Main Menu ---" );
System.out.println( "¥nEnter choice:" );
System.out.println( "1) Organizations" );
System.out.println( "2) Roles" );
System.out.println( "3) Users" );
System.out.println( "4) Security Realm" );
System.out.println( "5) Business Operations" );
System.out.println( "6) Event Keys" );
System.out.println( "7) Business Calendars" );
System.out.println( "8) EJB Catalog" );
System.out.println( "9) Server Properties" );
System.out.println( "Q) Quit" );
System.out.print( ">> " );
.
.
.
/**
* ServerProperties インタフェースで使用可能な
* 公開 API メソッドを示すメソッド(ユーザとの交信なし、表示モードのみ)
*/
public static void mngServerProperties( ) {
Properties serverSystemProperties;
String answer;

try {
/* システム プロパティの表示が必要かどうかをユーザに求める */
if( ( answer = askQuestion( "¥nList system properties (y/n)?" ) )
== null ) {
/* ユーザによる操作の取り消し */
System.out.println( "*** Cancelled" );
return;
}

/* 応答を解析する */
boolean isListSysProperties = ( answer.equals( "y" ) ||
answer.equals( "Y" ) );
/* すべてのサーバ プロパティと属性を表示する */
System.out.println( "¥nServer Version:" );

/* WLPI 公開 API メソッド */
/* サーバ属性を取り出す */
serverVersion = serverProperties.getServerVersion( );

/* WLPI v1.2.1 で使用可能な全属性を表示する */
System.out.println( "- Release Name: " + serverVersion.getName( ) );
System.out.println( "- Version: " + serverVersion +
" (Major=" + serverVersion.getMajorVersion( ) +
" Minor=" + serverVersion.getMinorVersion( ) +
" Build=" + serverVersion.getBuild( ) + ")" );

/* すべてのテンプレート定義プロパティと属性を表示する */
System.out.println( "¥nTemplate Definition version supported:" );

/* WLPI 公開 API メソッド */
/* テンプレート定義属性を取り出す */
serverDTDVersion = serverProperties.getTemplateDefinitionVersion( );

/* 使用可能なすべての属性を表示する */
System.out.println( "- Release Name: " + serverDTDVersion.getName( ) );
System.out.println( "- Version: " + serverDTDVersion +
" (Major=" + serverDTDVersion.getMajorVersion( ) +
" Minor=" + serverDTDVersion.getMinorVersion( ) +
" Build=" + serverDTDVersion.getBuild( ) + ")" );

if( isListSysProperties ) {
System.out.println( "¥nSystem Properties: " );

      /* WLPI 公開 API メソッド */
/* サーバ システム プロパティを取り出す */
serverSystemProperties = serverProperties.getProperties( );

/* すべてのプロパティを表示するループ */
for( Enumeration e = serverSystemProperties.propertyNames( );
e.hasMoreElements( ); ) {
String propertyName = e.nextElement( ).toString( );
System.out.println( "- Name: '" + propertyName + "' Value: '" +
serverSystemProperties.getProperty( propertyName ) + "'¥n" );
}
}
}
catch( Exception e ) {
System.out.println( "*** Failed to retrieve properties" );
System.err.println( e );
}
return;
}

 

ページの先頭 前 次