BEA ホーム | 製品 | デベロッパ・センタ | support | askBEA |
![]() |
![]() |
|
![]() |
e-docs > WebLogic Integration > BPM トピック > BPM クライアント アプリケーション プログラミング > プロセス エンジン情報へのアクセス |
BPM クライアント アプリケーション プログラミング
|
プロセス エンジン情報へのアクセス
この章では、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 オブジェクトに保存します。このコード例では properties は ServerProperties 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 オブジェクトに保存します。このコード例では properties は ServerProperties 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 オブジェクトに保存します。このコード例では properties は ServerProperties 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 オブジェクトに保存します。このコード例では properties は ServerProperties EJB への EJBObject 参照を表しています。
Properties props = properties.getProperties();
getProperties() メソッドの詳細については、Javadoc の com.bea.wlpi.server.serverproperties.ServerProperties を参照してください。
コンビニエンス メソッドの使い方
com.bea.wlpi.client.common.WLPI クラスには、サーバ情報にアクセスするためのコンビニエンス メソッド群が含まれています。これらのメソッドを次の表にまとめます。
詳細については、Javadoc の com.bea.wlpi.client.common.WLPI を参照してください。
プロセス エンジンに関する情報へのアクセス例
この節では、コマンドライン管理クライアント サンプルから抜粋して、サーバ プロパティへのアクセス方法を示します。
ユーザと通信を行うための入力ストリームが定義されており、ユーザはどのアクションを実行するかを指定するよう求められます。ユーザが Server Properties オプションを選択した場合、システムによってサーバ バージョンとテンプレート定義バージョンが取得され、返された VersionInfo オブジェクトにより、サーバとテンプレート定義に関する他の情報(名前、メジャー/マイナー/ビルド バージョンなど)が取得されます。さらに、サーバ プロパティの名前と値も表示されます。
重要なコード行は、太字で強調されています。このサンプルでは、文字列 serverProperties は ServerProperties 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;
}
![]() |
![]() |
![]() |
![]() |
||
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |