5.6.5　Java呼出アクティビティ

(a)　CustomClassInterfaceMインターフェース

package jp.co.Hitachi.soft.csc.bp.receiver.ejb;
 
public interface CustomClassInterfaceM {
    public Object invoke(
        String processName,
        int version,
        String activityName,
        Object... inputData
    ) throws CSBUserException, CSBSystemException;
}

Javaクラスの内容について次に説明します。

引数

仮引数名	説明
processName	ビジネスプロセス名
version	ビジネスプロセスのバージョン
activityName	アクティビティ名
inputData	［Java呼出アクティビティ］ダイアログの［引数用割当変数］で指定した変数※

戻り値

［Java呼出アクティビティ］ダイアログの［戻り値用割当変数］に指定した変数に代入されます。

例外

throwされる例外がCSBUserExceptionか，CSBSystemExceptionかによって処理が異なります。また，この2つの例外以外の例外が発生した場合，処理が中断されます。この場合，プロセスの実行状態を永続化しているときには，ロールバックが実行されます。

CSBUserExceptionがthrowされた場合

Java呼出アクティビティにフォルト処理が設定されている場合，CSBUserExceptionがthrowされると，フォルトコネクションでフォルト処理として定義されているアクティビティが実行されます。

Java呼出アクティビティにフォルト処理が設定されていない場合，invokeJavaFaultが発生したものとして処理が進められます。

CSBUserExceptionのインターフェースを次に示します。

 package jp.co.Hitachi.soft.csc.bp;
 
 public class CSBUserException extends Exception {
     public CSBUserException() { super(); }
     public CSBUserException(String message) { super(message); }
 }

CSBSystemExceptionがthrowされた場合

CSBSystemExceptionがthrowされると，システム例外が発生したものとして処理が中断されます。このとき，プロセスの実行状態を永続化している場合には，ロールバックが実行されます。

CSBSystemExceptionのインターフェースを次に示します。

package jp.co.Hitachi.soft.csc.bp;
 
 public class CSBSystemException extends Exception {
     public CSBSystemException() { super(); }
     public CSBSystemException(String message) { super(message); }
     public CSBSystemException(String message, Throwable cause) {
         super(message, cause);
     }
     public CSBSystemException(Throwable cause) { super(cause); }
 }

(b)　CustomClassInterfaceインターフェース

package jp.co.Hitachi.soft.csc.bp.receiver.ejb;
 
public interface CustomClassInterface {
    public Object invoke(
        String processName,
        int version,
        String activityName,
        Object inputData
    ) throws CSBUserException, CSBSystemException;
}

ポイント

CustomClassInterfaceは，CustomClassInterfaceMの互換用インターフェースです。CustomClassInterfaceMを使用することを推奨します。

Javaクラスの内容について次に説明します。

引数

仮引数名	説明
processName	ビジネスプロセス名
version	ビジネスプロセスのバージョン
activityName	アクティビティ名
inputData	［Java呼出アクティビティ］ダイアログの［引数用割当変数］で指定した変数※

戻り値

［Java呼出アクティビティ］ダイアログの［戻り値用割当変数］に指定した変数に代入されます。

例外

throwされる例外がCSBUserExceptionか，CSBSystemExceptionかによって処理が異なります。またこの2つの例外以外の例外が発生した場合，処理が中断されます。このとき，プロセスの実行状態を永続化している場合には，ロールバックが実行されます。

CSBUserException，またはCSBSystemExceptionがthrowされた場合の処理については，「(a)　CustomClassInterfaceMインターフェース」の戻り値の説明を参照してください。

CSBUserExceptionおよびCSBSystemException以外の例外が発生した場合，処理が中断されます。このとき，プロセスの実行状態を永続化している場合には，ロールバックが実行されます。

注意事項

• ［Java呼出アクティビティ］ダイアログの［引数用割当変数］および［戻り値用割当変数］に指定する変数の型と，このインターフェースの引数および戻り値の型の対応を次に示します。

  ［引数用割当変数］および［戻り値用割当変数］の変数型	引数および戻り値の型
  boolean	java.lang.Boolean
  numeric	java.lang.Double
  string	java.lang.String
  XML	byte[]
  non-XML	byte[]
  any	byte[]

  上記の型以外を指定した場合，エラー（KDEC20030-E）になります。

• 利用するJavaクラスのインターフェースはcscbp_ejb.jarに含まれます。そのため，コンパイルするときには，cscbp_ejb.jarをクラスパスに追加する必要があります。Eclipseのビルドパスにcscbp_ejb.jarが存在しないときは，<インストールディレクトリ>\CSC\lib\cscbp_ejb.jarをビルドパスに追加してください。

• Javaプログラムでは，呼び出しごとにデフォルトコンストラクタでインスタンスが生成されます。そのため，インスタンスにデータを保持することはできません。

(a)　フォルト処理を実行する場合の定義

フォルト処理の定義手順を次に示します。

1. フォルトが発生するアクティビティとフォルト処理を実行するアクティビティをキャンバスに配置し，詳細を定義します。

   フォルト処理を実行するアクティビティは複数定義できます。

   アクティビティの配置方法については，「5.4.1　アクティビティを配置する」を参照してください。各アクティビティの定義方法の詳細については，「5.6　アクティビティの定義」を参照してください。

2. フォルトコネクションを利用してフォルトが発生するアクティビティとフォルト処理を実行するアクティビティを連結します。

   アクティビティの連結方法については，「5.4.2(2)　連結の設定方法」を参照してください。また，フォルトコネクションを利用できるアクティビティについては，「5.4.2(5)　アクティビティの連結条件」を参照してください。

3. 連結線をダブルクリックします。

   ［フォルト処理の割当］ダイアログが表示されます。

   ［フォルト処理の割当］ダイアログの入力・表示内容の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「1.4.6　フォルト処理の割当ダイアログ」を参照してください。なお，フォルト処理に割り当てられる変数はメッセージ型（XML）だけです。メッセージ型（non-XMLおよびany）は割り当てられません。

4. フォルト処理の条件を定義します。

   フォルトの対象となる変数と，フォルトが発生した場合に処理する連絡先のアクティビティを，それぞれ［割当変数］および［遷移先］ドロップダウンリストで指定します。

   定義していないフォルトが発生した場合のフォルト処理を設定する場合，［割当変数］ドロップダウンリストで「catch-all」を選択します。

5. ［OK］ボタンをクリックします。

(b)　フォルト処理の定義で使用するフォルト電文を定義するスキーマファイル

フォルト電文を定義するスキーマファイルの格納先を次に示します。

<サービスプラットフォームのインストールディレクトリ>\CSC\schema\fault\cscinvokejavafault.xsd

フォルト電文を定義するスキーマファイルを次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema elementFormDefault="qualified"
            targetNamespace="http://www.msg.csc.soft.Hitachi.co.jp/cscBpJava"
            xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <xsd:element name="fault">
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element name="exception-name"       type="xsd:string"/>
        <xsd:element name="exception-message"    type="xsd:string"/>
        <xsd:element name="exception-error-code" type="xsd:string"/>
        <xsd:element name="exception-detail"     type="xsd:string"/>
        <xsd:element name="scope-name"           type="xsd:string"/>
        <xsd:element name="activity-name"        type="xsd:string"/>
        <xsd:element name="activity-type"        type="xsd:string"/>
        <xsd:element name="process-instance-id"  type="xsd:string"/>
        <xsd:element name="root-ap-info"         type="xsd:string"/>
      </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

設定できる要素を次に示します。

exception-name

例外名（完全修飾クラス名）を設定します。

exception-message^※

例外情報（CSBUserException.getMessage()で取得した情報）を設定します。

exception-error-code^※

CSBUserExceptionのerrorCodeに設定した情報（ユーザが任意に設定できる情報）を設定します。

exception-detail^※

CSBUserExceptionのdetailに設定した情報（ユーザが任意に設定できる情報）を設定します。

scope-name

Java呼出アクティビティが所属するスコープ名を設定します。

activity-name

フォルトが発生したアクティビティ名を設定します。

activity-type

フォルトが発生したアクティビティの型名を設定します。

アクティビティの型名には，javaを設定してください。

process-instance-id

プロセスインスタンス識別子を設定します。

root-ap-info

ルートアプリケーション情報を設定します。

注※

CSBUserExceptionに要素と対応する情報が設定されていない場合，空要素（空タグ）が設定されます。