7.3.1 アダプタ出口用Javaインタフェース

アダプタ出口機能で呼び出す出口アプリケーションは、以下に示すISIが提供するアダプタ出口用Javaインタフェースを利用し作成します。

表7.2 アダプタ出口用Javaインタフェース
クラス名	説明
パッケージ
com.fujitsu.esi.process.api	アダプタ出口機能を利用するためのAPI群です。
インタフェース
ESIPreProcess	前出口用インタフェースです。
ESIPostProcess	後出口用インタフェースです。
ESIErrorHandler	エラー出口用インタフェースです。
データ格納クラス
ESIProcessDataBean	共通メッセージのペイロードとヘッダ、アダプタ固有情報オブジェクトを格納するデータ格納クラスです。
ESISOAPInfo	SOAPアダプタのアダプタ固有情報オブジェクトを格納するデータ格納クラスです。
例外クラス
ESIProcessException	エラー発生時の例外情報を格納するExceptionクラスです。

7.3.1.1 インタフェース

7.3.1.1.1 ESIPreProcess

パッケージ: com.fujitsu.esi.process.api

インタフェース: public interface ESIPreProcess

メソッド

public void callPreProcess(ESIProcessDataBean msg) throws ESIProcessException
前出口アプリケーション用のインタフェースです。前出口で実行したいアプリケーションは本インタフェースを実装する必要があります。
パラメーターのmsg内に格納されている情報（共通メッセージのペイロードとヘッダ、アダプタ固有情報）を更新することで、以降の処理で使用するデータを変更することができます。
パラメーター
msg：共通メッセージのペイロードとヘッダ、アダプタ固有情報オブジェクトを格納したオブジェクト
例外
ESIProcessException：出口アプリケーション内でエラーが発生した場合

7.3.1.1.2 ESIPostProcess

パッケージ: com.fujitsu.esi.process.api

インタフェース: public interface ESIPostProcess

メソッド

public void callPostProcess(ESIProcessDataBean msg) throws ESIProcessException
後出口アプリケーション用のインタフェースです。後出口で実行したいアプリケーションは本インタフェースを実装する必要があります。
パラメーターのmsg内に格納されている情報（共通メッセージのペイロードとヘッダ、アダプタ固有情報）を更新することで、以降の処理で使用するデータを変更することができます。
パラメーター
msg：共通メッセージのペイロードとヘッダ、アダプタ固有情報オブジェクトを格納したオブジェクト
例外
ESIProcessException：出口アプリケーション内でエラーが発生した場合

7.3.1.1.3 ESIErrorHandler

パッケージ: com.fujitsu.esi.process.api

インタフェース: public interface ESIErrorHandler

メソッド

public void handleException(ESIProcessException error, ESIProcessDataBean msg) throws ESIProcessException
エラー出口アプリケーション用のインタフェースです。アダプタの処理でエラーが発生した場合に、エラー出口で実行したいアプリケーションは本インタフェースを実装する必要があります。
パラメーター
error：アダプタの処理で発生したエラー情報
msg：共通メッセージのペイロードとヘッダ、アダプタ固有情報オブジェクトを格納したオブジェクト
例外
ESIProcessException：出口アプリケーション内でエラーが発生した場合

注意

エラー出口処理で、パラメーターのmsg内に格納されている情報を更新したあとの情報をエラーシーケンスに通知する場合は、同期サービス呼出しメディエータファンクションの定義で、「呼出し先サービスからのエラーメッセージをエラーシーケンスに通知する」のチェックボックスをオン（チェックつき）にしてください。デフォルトでは、チェックボックスがオフ（チェックなし）になっているため、更新した情報がエラーシーケンスに通知されません。

同期サービス呼出しメディエータファンクションの定義については、“ISI Studio ヘルプ”の“同期サービスを呼び出す”および“ルーティングして同期サービスを呼び出す”を参照してください。

7.3.1.2 データ格納クラス

7.3.1.2.1 ESIProcessDataBean

パッケージ: com.fujitsu.esi.process.api

クラス

public class ESIProcessDataBean

出口アプリケーション用のデータ格納クラスです。ESIProcessDataBeanクラスは以下の情報を保持します。

共通メッセージのペイロード
共通メッセージのヘッダ
アダプタ固有情報オブジェクト

メソッド

public byte[] getPayload()
共通メッセージのペイロードを取得します。
復帰値
共通メッセージのペイロード

public void setPayload(byte[] payload)
共通メッセージのペイロードを設定します。
パラメーター
payload：共通メッセージのペイロード

public Map<String, String> getHeader()
共通メッセージのヘッダを取得します。
復帰値
共通メッセージのヘッダを格納したMap

public void setHeader(Map<String, String> header)
共通メッセージのヘッダを設定します。
パラメーター
header：共通メッセージのヘッダを格納したMap

public Object getAdapterInfo()
アダプタ固有情報オブジェクトを取得します。
復帰値
アダプタ固有情報オブジェクト

7.3.1.2.2 ESISOAPInfo

パッケージ: com.fujitsu.esi.process.api

クラス: public class ESISOAPInfo

メソッド

public MimeMultipart getMimeMultipart()
アダプタ固有情報オブジェクトから、SOAPアダプタの情報を取得します。
復帰値
SOAPメッセージと添付ファイルを含むマルチパートのMIME情報をMimeMultipartとして取得します。

7.3.1.3 例外クラス

7.3.1.3.1 ESIProcessException

パッケージ: com.fujitsu.esi.process.api

クラス

public class ESIProcessException extends Exception

出口アプリケーション用の例外クラスです。

コンストラクタ

public ESIProcessException(String message)
エラーメッセージを設定します。
パラメーター
message：エラーメッセージ

public ESIProcessException(String message, Throwable cause)
エラーメッセージと原因例外を設定します。
パラメーター
message：エラーメッセージ
cause：原因例外

public ESIProcessException(String, errorCode, String message)
エラーコードとエラーメッセージを設定します。
パラメーター
errorCode：エラーコード
message：エラーメッセージ

public ESIProcessException(String, errorCode, String message, Throwable cause)
エラーコードとエラーメッセージと原因例外を設定します。
パラメーター
errorCode：エラーコード
message：エラーメッセージ
cause：原因例外