Cosminexus ビジネスプロセス管理/エンタープライズサービスバス V8 サービスプラットフォーム 開発ガイド

[目次][用語][索引][前へ][次へ]

付録F.1 カスタムアダプタ開発フレームワークのAPI

ここでは,Cosminexus サービスプラットフォームが提供するカスタムアダプタ開発フレームワークのAPIについて説明します。

カスタムアダプタ開発フレームワークで定義されているインターフェースおよび例外クラスは,次の場所に格納されています。

 
<Cosminexusのインストールディレクトリ>\CSC\lib\csc_adapter.jar
 

カスタムアダプタをコンパイルするときは,このJARファイルをクラスパスに含めてください。

<この項の構成>
(1) プロトコルコンバータインターフェース
(2) アダプタコンテキストインターフェース
(3) メッセージインターフェース
(4) 例外クラス

(1) プロトコルコンバータインターフェース

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

説明
プロトコルコンバータを実装するためのインターフェースです。
CSCMsgCustomProtocolConverterのパッケージ名は,jp.co.Hitachi.soft.csc.msg.adapter.customです。

形式
 
public interface CSCMsgCustomProtocolConverter
{
  public void start()
          throws CSCMsgCustomAdapterException;
  public void stop();
  public void setCustomAdapterContext(CSCMsgCustomAdapterContext adapterContext);
  public void invoke(CSCMsgRequestMessage requestMessage, 
                     CSCMsgResponseMessage responseMessage)
          throws CSCMsgCustomAdapterException;
}
 

メソッド
CSCMsgCustomProtocolConverterインターフェースのメソッドを次の表に示します。
メソッド名 説明
startメソッド カスタムアダプタが開始されるときに呼び出されるメソッドです。プロトコルコンバータ開始処理を実装します。
このメソッドは,一度だけ呼び出されます。
stopメソッド カスタムアダプタが終了されるときに呼び出されるメソッドです。プロトコルコンバータ終了処理を実装します。
このメソッドは,一度だけ呼び出されます。
setCustomAdapterContextメソッド アダプタコンテキストが設定されるときに呼び出されるメソッドです。与えられたアダプタコンテキストをプロトコルコンバータのインスタンスフィールドに格納する処理を記述します。
このメソッドは,一度だけ呼び出されます。
invokeメソッド カスタムアダプタを介してサービス部品を呼び出すときに呼び出されるメソッドです。サービス部品を呼び出す処理を記述します。
このメソッドは,サービスアダプタの呼び出し要求があるたびに呼び出されます。
カスタムアダプタ開発フレームワークからの各メソッドの呼び出し順序を次の図に示します。

図F-1 カスタムアダプタ開発フレームワークからの各メソッドの呼び出し順序

[図データ]
1. コンストラクタ
プロトコルコンバータは,カスタムアダプタ開始時に,カスタムアダプタ開発フレームワークから呼び出されたデフォルトコンストラクタによってインスタンス化されます。
2. setCustomAdapterContextメソッド
プロトコルコンバータクラスがインスタンス化された直後に,カスタムアダプタ開発フレームワークから呼ばれます。このメソッドは,カスタムアダプタの開始時に一度だけ呼ばれます。引数として受け取ったアダプタコンテキストは,プロトコルコンバータのインスタンスフィールドに保持してください。
3. startメソッド
setServiceAdapterInfoメソッドの直後にカスタムアダプタ開発フレームワークから呼ばれます。このメソッドは,カスタムアダプタの開始時に一度だけ呼ばれます。
4. invokeメソッド
サービス部品呼び出し処理時にカスタムアダプタ開発フレームワークから呼ばれます。このメソッドで,プロトコル変換とサービス呼び出し処理を行います。
5. stopメソッド
カスタムアダプタがHCSCサーバから削除される直前にカスタムアダプタ開発フレームワークから呼ばれます。アダプタの終了時処理を行います。このメソッドは,カスタムアダプタの終了時に一度だけ呼ばれます。

注意事項
  • publicなデフォルトコンストラクタ
    カスタムアダプタ開発フレームワークは,このインターフェースを実装したクラスをインスタンス化するときに,デフォルトコンストラクタを使用します。そのため,このインターフェースを実装したクラスでは,publicなデフォルトコンストラクタを実装する必要があります。
  • マルチスレッド
    プロトコルコンバータは,複数のカスタムアダプタのインスタンスから共有されるため,スレッドセーフなクラスを実装する必要があります。
  • 例外の送出
    CSCMsgCustomProtocolConverterの各メソッドでは,指定された例外だけ送出できます。java.lang.RuntimeExceptionおよびその派生クラスは送出しないでください。送出した場合,動作の保証はできません。

 

●startメソッド
説明
カスタムアダプタが開始されるときに呼び出されるメソッドです。
カスタムアダプタのライフサイクルを通じて使用するリソースは,このメソッドで確保することを推奨します。
形式
 
public void start()
  throws CSCMsgCustomAdapterException;
 
パラメタ
なし。
例外
jp.co.Hitachi.soft.csc.msg.adapter.custom.CSCMsgCustomAdapterException:
startメソッドの実行に失敗した場合に発生させます。
戻り値
なし。

 

●stopメソッド
説明
カスタムアダプタ終了時に呼び出されるメソッドです。カスタムアダプタの終了処理を記述します。
形式
 
public void stop();
 
パラメタ
なし。
例外
なし。
戻り値
なし。

 

●setCustomAdapterContextメソッド
説明
アダプタコンテキストが設定されるときに呼び出されるメソッドです。
このメソッドのあとに必ずstartメソッドを呼び出します。
このメソッドで受け取ったアダプタコンテキストインターフェースは,カスタムアダプタのライフサイクルを通じて保持する必要があります。
形式
 
public void setCustomAdapterContext(CSCMsgCustomAdapterContext adapterContext);
 
パラメタ
adapterContext:
CSCMsgCustomAdapterContextのリファレンスが渡されます。
例外
なし。
戻り値
なし。

 

●invokeメソッド
説明
カスタムアダプタを経由してサービス部品を呼び出すときに,呼び出されるメソッドです。サービス部品を呼び出す処理を記述します。
requestMessageに格納されている要求電文を基にサービス部品を呼び出します。
通信モデルが同期の場合,応答電文はresponseMessageを格納します。
通信モデルが非同期の場合,responseMessageにはnullが渡されます。
形式
 
public void invoke (CSCMsgRequestMessage requestMessage, 
                    CSCMsgResponseMessage responseMessage)
  throws CSCMsgCustomAdapterException;
 
パラメタ
  • requestMessage:
    要求電文が格納されたCSCMsgRequestMessageのリファレンスが渡されます。
  • responseMessage:
    通信モデルが同期の場合,応答電文を格納するCSCMsgResponseMessageのリファレンスが渡されます。通信モデルが非同期通信の場合,nullが渡されます。
例外
jp.co.Hitachi.soft.csc.msg.adapter.custom.CSCMsgCustomAdapterException:
invokeメソッドの実行に失敗した場合に発生させます。
戻り値
なし。

(2) アダプタコンテキストインターフェース

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

説明
プロトコルコンバータがアダプタ情報を取得するためのインターフェースです。CSCMsgCustomAdapterContextのパッケージ名は,jp.co.Hitachi.soft.csc.msg.adapter.customです。
アダプタコンテキストインターフェースは,カスタムアダプタ開始処理の直前に,setCustomAdapterContextメソッドの引数として入力されます。プロトコルコンバータでは,この引数をインスタンスフィールドとして保持し,必要な情報を取得します。

形式
 
public interface CSCMsgCustomAdapterContext
{
  public String getAdapterName();
  public Properties getProperties();
  public byte[] getResourceAsBytes(String fileName)
    throws CSCMsgResourceAccessException;
  public java.io.InputStream getResourceAsStream(String fileName)
    throws CSCMsgResourceAccessException;
}
 

メソッド
CSCMsgCustomAdapterContextインターフェースのメソッドを次の表に示します。
メソッド名 説明
getAdapterNameメソッド カスタムアダプタの名称を取得します。
getPropertiesメソッド カスタムアダプタプロパティファイルの内容をPropertiesとして取得します。
getResourceAsBytesメソッド リソースファイルの内容をバイナリ形式で取得します。
getResourceAsStreamメソッド リソースファイルにアクセスするためのストリームを取得します。

 

●getAdapterNameメソッド
説明
カスタムアダプタの名称を取得します。
形式
 
public String getAdapterName();
 
パラメタ
なし。
例外
なし。
戻り値
カスタムアダプタの名称を返却します。

 

●getPropertiesメソッド
説明
カスタムアダプタプロパティファイルの内容をPropertiesとして取得します。
形式
 
public Properties getProperties();
 
パラメタ
なし。
例外
なし。
戻り値
プロパティファイルの内容を返却します。

 

●getResourceAsBytesメソッド
説明
リソースファイルの内容をバイナリ形式で取得します。
形式
 
public byte[] getResourceAsBytes(String fileName)
  throws CSCMsgResourceAccessException;
 
パラメタ
fileName:
アクセスしたいリソースのファイル名を指定します。
例外
CSCMsgResourceAccessException:
fileNameで指定したリソースが見つからなかった,またはjava.io.IOExceptionが発生しました。
戻り値
リソースファイルの内容をバイナリ形式で返却します。

 

●getResourceAsStreamメソッド
説明
リソースファイルにアクセスするためのストリームを取得します。
形式
 
public java.io.InputStream getResourceAsStream(String fileName)
  throws CSCMsgResourceAccessException;
 
パラメタ
fileName:
アクセスしたいリソースのファイル名を指定します。
例外
CSCMsgResourceAccessException:
fileNameで指定したリソースが見つからなかった,またはjava.io.IOExceptionが発生しました。
戻り値
リソースファイルの内容をストリーム形式で返却します。
注意事項
このメソッドで取得したストリームをstaticなフィールドに割り当てないでください。メモリリークが発生するおそれがあります。

 

(3) メッセージインターフェース

HCSCサーバとプロトコルコンバータの間でメッセージを交換するためのインターフェースの一覧を次の表に示します。

表F-1 メッセージ操作に使用するAPIの一覧

インターフェース名 説明
CSCMsgMessageConstantインターフェース メッセージの操作に必要な定数を定義します。
CSCMsgRequestMessageインターフェース サービス部品呼び出しに必要な情報(オペレーション名,電文など)を取得するためのメソッドを提供します。
CSCMsgResponseMessageインターフェース サービス部品呼び出し結果(電文またはフォルト情報)を格納するためのメソッドを提供します。
(a) CSCMsgMessageConstantインターフェース

説明
プロトコルコンバータがメッセージの操作に必要な定数を定義するインターフェースです。CSCMsgMessageConstantのパッケージ名は,jp.co.Hitachi.soft.csc.msg.adapter.customです。
プロトコルコンバータで要求メッセージに格納されている電文の種類,または応答メッセージに格納する電文の種類を確認するためにこの定数を使用します。

形式
 
public interface CSCMsgMessageConstant
{
  public static final int MESSAGE_TYPE_NONE;
  public static final int MESSAGE_TYPE_XML;
  public static final int MESSAGE_TYPE_BINARY;
  public static final int MESSAGE_TYPE_ANY;
}
 

メンバ属性
MESSAGE_TYPE_NONE:
電文が格納されていないことを示します。
MESSAGE_TYPE_XML:
電文の形式がXML形式(DOM形式)であることを示します。
MESSAGE_TYPE_BINARY:
電文の形式がバイナリであることを示します。
MESSAGE_TYPE_ANY:
電文の形式が任意形式であることを示します。

 

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

説明
サービス部品の呼び出しに必要な情報(オペレーション名,電文など)を取得するためのメソッドを提供するインターフェースです。
CSCMsgRequestMessageのパッケージ名は,jp.co.Hitachi.soft.csc.msg.adapter.customです。

形式
 
public interface CSCMsgRequestMessage
{
  public byte[] getBytes() 
          throws CSCMsgIllegalMessageTypeException,
                 CSCMsgInvalidMessageException;
  public Map getMessageContext();
  public int getMessageType();
  public String getOperationName();
  public org.w3c.dom.Document getXMLDocument() 
          throws CSCMsgIllegalMessageTypeException,
                 CSCMsgInvalidMessageException;
}
 

メソッド
CSCMsgRequestMessageインターフェースのメソッドを次の表に示します。
メソッド名 説明
getBytesメソッド バイナリ形式の電文を取得します。
getMessageContextメソッド 未サポートのメソッドです。
getMessageTypeメソッド 要求メッセージに格納されている電文の種別を取得します。
getOperationNameメソッド サービス部品呼び出し時に呼び出すオペレーションの名称を取得します。
getXMLDocumentメソッド XML形式の電文を取得します。

 

●getBytesメソッド
説明
バイナリ形式の電文を取得します。
形式
 
public byte[] getBytes() 
  throws CSCMsgIllegalMessageTypeException,
         CSCMsgInvalidMessageException;
 
パラメタ
なし。
例外
  • jp.co.Hitachi.soft.csc.msg.adapter.custom.CSCMsgIllegalMessageTypeException:
    電文の形式がバイナリではありません。または,電文が格納されている状態です。電文の種別がXML形式の場合は,このメソッドを使用して電文を取得することはできません。
  • jp.co.Hitachi.soft.csc.msg.adapter.custom.CSCMsgInvalidMessageException:
    格納されている電文が不正です。
戻り値
設定されている電文の種別がバイナリ形式(MESSAGE_TYPE_BINARY)の場合,バイト配列で応答を返します。
電文が格納されていない(MESSAGE_TYPE_NONE)場合,0バイトのバイト配列(長さ0の配列)を返します。
注意事項
  • このメソッドで取得したバイナリ電文(バイト配列)については,変更しても問題ありません。
  • このメソッドを実行したときに,オブジェクトのコピーを作成します。そのため,再度このメソッドを発行すると,変更前のオブジェクトを再取得することになるので注意してください。

 

●getMessageContextメソッド
説明
未サポートのメソッドです。
呼び出すと必ずnullを返却します。
形式
 
public Map getMessageContext();
 
パラメタ
なし。
例外
なし。
戻り値
常にnullを返します。

 

●getMessageTypeメソッド
説明
要求メッセージに格納されている電文の種別を取得します。
形式
 
public int getMessageType();
 
パラメタ
なし。
例外
なし。
戻り値
要求メッセージに格納されている電文の種別を返却します。返却される値については,「付録F.1(3)(a) CSCMsgMessageConstantインターフェース」を参照してください。ただし,任意形式のカスタムアダプタを作成した場合は,電文の種別に関係なく,「MESSAGE_TYPE_ANY」を返却します。

 

●getOperationNameメソッド
説明
サービス部品呼び出し時に呼び出すオペレーションの名称を取得します。
形式
 
public String getOperationName();
 
パラメタ
なし。
例外
なし。
戻り値
呼び出すオペレーションの名称を返却します。

 

●getXMLDocumentメソッド
説明
XML形式の電文を取得します。
形式
 
public org.w3c.dom.Document getXMLDocument() 
  throws CSCMsgIllegalMessageTypeException,
         CSCMsgInvalidMessageException;
 
パラメタ
なし。
例外
  • jp.co.Hitachi.soft.csc.msg.adapter.custom.CSCMsgIllegalMessageTypeException:
    電文の形式がXML形式ではありません。または,電文が格納されている状態です。電文の種別がバイナリ形式の場合は,このメソッドを使用して電文を取得することはできません。
  • jp.co.Hitachi.soft.csc.msg.adapter.custom.CSCMsgInvalidMessageException:
    格納されている電文が不正です。
戻り値
設定されている電文の種別がXML形式(MESSAGE_TYPE_XML)の場合,DOM形式のオブジェクトで応答を返します。
電文が格納されていない(MESSAGE_TYPE_NONE)場合,nullを返します。
注意事項
  • このメソッドで取得したXML電文(DOM)については,変更しても問題ありません。
  • このメソッドを実行したときに,オブジェクトのコピーを作成します。そのため,再度このメソッドを発行すると,変更前のオブジェクトを再取得することになるので注意してください。
  • 任意形式のカスタムアダプタを作成した場合,このメソッドを実行するとエラー(KDEC03016-E)になり,電文を取得できません。この場合は,getBytesメソッドを使用してください。
(c) CSCMsgResponseMessageインターフェース

説明
サービス部品呼び出し結果(電文またはフォルト情報)を格納するためのメソッドを提供するインターフェースです。
CSCMsgResponseMessageのパッケージ名は,jp.co.Hitachi.soft.csc.msg.adapter.customです。

形式
 
public interface CSCMsgResponseMessage
{
  public int getMessageType();
  public void setBytes(byte[] message)
          throws CSCMsgIllegalMessageTypeException,
                 CSCMsgMultipleMessageInsertionException,
                 CSCMsgInvalidMessageException;
  public void setFault(String faultCode, 
                       String faultString,
                       String faultActor, 
                       byte[] faultDetail)
          throws CSCMsgMultipleMessageInsertionException;
  public void setFault(String faultCode, 
                       String faultString,
                       String faultActor, 
                       org.w3c.dom.Document faultDetail)
          throws CSCMsgMultipleMessageInsertionException,
                 CSCMsgInvalidMessageException;
  public void setXMLDocument(org.w3c.dom.Document dom)
          throws CSCMsgIllegalMessageTypeException,
                 CSCMsgMultipleMessageInsertionException,
                 CSCMsgInvalidMessageException;
}
 

メソッド
CSCMsgResponseMessageインターフェースのメソッドを次の表に示します。
メソッド名 説明
getMessageTypeメソッド 応答メッセージに格納する電文の種別を取得します。
setBytesメソッド 応答メッセージにバイナリ形式の電文を格納します。
setFaultメソッド(形式1) サービス部品を呼び出すときに発生したフォルト情報を格納します。
setFaultメソッド(形式2) サービス部品を呼び出すときに発生したフォルト情報を格納します。
setXMLDocumentメソッド 応答メッセージにXML形式の電文を格納します。

 

●getMessageTypeメソッド
説明
応答メッセージに格納する電文の種別を取得します。
形式
 
public int getMessageType();
 
パラメタ
なし。
例外
なし。
戻り値
応答メッセージに格納する電文の種別を返却します。ただし,任意形式のカスタムアダプタを作成した場合は,電文の種別に関係なく,「MESSAGE_TYPE_ANY」を返却します。
  • MESSAGE_TYPE_NONE:
    電文を格納しません。
  • MESSAGE_TYPE_XML:
    電文の種別がXML形式の電文を格納します。
  • MESSAGE_TYPE_BINARY:
    電文の種別がバイナリ形式の電文を格納します。

 

●setBytes メソッド
説明
応答メッセージにバイナリ形式の電文を格納します。
形式
 
public void setBytes(byte[] message)
        throws CSCMsgIllegalMessageTypeException,
               CSCMsgMultipleMessageInsertionException,
               CSCMsgInvalidMessageException;
 
パラメタ
message:
バイナリ形式の電文を指定します。
なお,バイナリ形式の電文を格納した場合は,電文の種別をバイナリ形式(MESSAGE_TYPE_BINARY)に設定し,長さ0のバイト列やnullを格納した場合は,電文を格納しない種別(MESSAGE_TYPE_NONE)に設定します。
例外
  • jp.co.Hitachi.soft.csc.msg.adapter.custom.CSCMsgIllegalMessageTypeException:
    設定されている電文の種別がバイナリではありません。または電文が格納されていない状態ではありません。要求時の電文の形式がXMLの場合に,応答時の電文の形式をバイナリに変えることはできません。
  • jp.co.Hitachi.soft.csc.msg.adapter.custom.CSCMsgMultipleMessageInsertionException:
    すでに電文またはフォルト情報が設定されています。
  • jp.co.Hitachi.soft.csc.msg.adapter.custom.CSCMsgInvalidMessageException:
    指定したバイナリ形式に誤りがあります。
戻り値
なし。
注意事項
任意形式のカスタムアダプタを作成した場合は,電文の形式に関係なく,このメソッドを使用してください。格納した電文の種別を任意形式(MESSAGE_TYPE_ANY)に設定します。長さ0のバイト列やnullを格納した場合でも,任意形式(MESSAGE_TYPE_ANY)に設定します。

 

●setFaultメソッド(形式1)
説明
サービス部品を呼び出したときに発生したフォルト情報を格納します。
faultDetailの内容をバイナリ形式で格納する場合に使用します。
なお,応答時の電文は存在しないため,電文を格納しない種別(MESSAGE_TYPE_NONE)を設定します。
形式
 
public void setFault(String faultCode, 
                     String faultString,
                     String faultActor, 
                     byte[] faultDetail)
        throws CSCMsgMultipleMessageInsertionException;
 
パラメタ
  • faultCode:
    FaultCode情報を指定します。
    nullを指定した場合,"Server.ServiceExecutionError"が格納されます。
  • faultString:
    FaultString情報を指定します。
    nullを指定した場合,"Service Excution Error at CustomAdapter"が格納されます。
  • faultActor:
    FaultActor情報を指定します。
    nullを指定した場合,HCSC-Definerで設定したサービスIDが格納されます。
  • faultDetail:
    XML形式のDetail情報をバイト配列で指定します。
    長さ0のバイト列を指定した場合,そのまま長さ0のバイト列が格納されます。nullを指定した場合,そのままnullが格納されます。
例外
jp.co.Hitachi.soft.csc.msg.adapter.custom.CSCMsgMultipleMessageInsertionException:
すでに応答電文またはフォルト情報が設定されています。
戻り値
なし。
注意事項
  • faultDetailは,XML文書をバイナリ化したものです。必ず,先頭にXML宣言をしてください。宣言をしなかった場合は,エラーにはなりませんが,正常に動作しないおそれがあります。
  • XML文書をバイト配列に変換する場合は,文字コードとしてUTF-8を使用してください。指定した文字コード以外では,正常に動作しないおそれがあります。

 

●setFaultメソッド(形式2)
説明
サービス部品を呼び出したときに発生したフォルト情報を格納します。
faultDetailの内容をXML形式(DOM形式)で格納する場合に使用します。
なお,応答時の電文は存在しないため,電文を格納しない種別(MESSAGE_TYPE_NONE)を設定します。
形式
 
public void setFault(String faultCode, 
                     String faultString,
                     String faultActor, 
                     org.w3c.dom.Document faultDetail)
        throws CSCMsgMultipleMessageInsertionException,
               CSCMsgInvalidMessageException;
 
パラメタ
  • faultCode:
    FaultCode情報を指定します。
    nullを指定した場合,"Server.ServiceExecutionError"が格納されます。
  • faultString:
    FaultString情報を指定します。
    nullを指定した場合,"Service Excution Error at CustomAdapter"が格納されます。
  • faultActor:
    FaultActor情報を指定します。
    nullを指定した場合,HCSC-Definerで設定したサービスIDが格納されます。
  • faultDetail:
    Detail情報をDOM形式で指定します。
    nullを指定した場合,そのままnullが格納されます。
例外
  • jp.co.Hitachi.soft.csc.msg.adapter.custom.CSCMsgMultipleMessageInsertionException:
    すでに応答電文またはフォルト情報が設定されています。
  • jp.co.Hitachi.soft.csc.msg.adapter.custom.CSCMsgInvalidMessageException:
    指定したDOM形式に誤りがあります。
戻り値
なし。

 

●setXMLDocument メソッド
説明
応答メッセージにXML形式(DOM形式)の電文を格納します。
形式
 
public void setXMLDocument(org.w3c.dom.Document dom)
        throws CSCMsgIllegalMessageTypeException,
               CSCMsgMultipleMessageInsertionException,
               CSCMsgInvalidMessageException;
 
パラメタ
dom:
DOM形式の電文を指定します。
なお,XML形式の電文を格納した場合は,電文の種別をXML(MESSAGE_TYPE_XML)に設定し,nullを格納した場合は,電文を格納しない種別(MESSAGE_TYPE_NONE)に設定します。
例外
  • jp.co.Hitachi.soft.csc.msg.adapter.custom.CSCMsgIllegalMessageTypeException:
    設定されている電文の種別がXMLではありません。または電文が格納されていない状態ではありません。要求時の電文の形式がXMLの場合に,応答時の電文の形式をバイナリに変えることはできません。
  • jp.co.Hitachi.soft.csc.msg.adapter.custom.CSCMsgMultipleMessageInsertionException:
    すでに電文またはフォルト情報が設定されています。
  • jp.co.Hitachi.soft.csc.msg.adapter.custom.CSCMsgInvalidMessageException:
    指定したDOM形式に誤りがあります。
戻り値
なし。
注意事項
任意形式のカスタムアダプタを作成した場合,このメソッドを実行するとエラー(KDEC03016-E)になり,電文を格納できません。この場合は,setBytesメソッドを使用してください。

(4) 例外クラス

プロトコルコンバータの開発時に発生する例外クラスの一覧を次の表に示します。

表F-2 プロトコルコンバータの例外クラス一覧

クラス名 説明
CSCMsgCustomAdapterExceptionクラス カスタムアダプタの初期化処理やサービス部品を呼び出す処理で例外が発生した場合に送出する例外です。
CSCMsgIllegalMessageTypeExceptionクラス 電文の取得または格納時に,電文タイプと異なるタイプの電文形式のメソッドが呼ばれた場合に送出する例外です。
CSCMsgMultipleMessageInsertionExceptionクラス すでに電文またはフォルト情報が格納されれた場合に送出する例外です。
電文またはフォルト情報を格納したあとに,再び電文またはフォルト情報を設定することはできません。
CSCMsgInvalidMessageException クラス 要求電文の場合,格納さてている電文の種別(形式)が不正なときに送出する例外です。
応答電文の場合,不正な形式の電文種別を指定しているときに送出する例外です。
CSCMsgResourceAccessException クラス リソースアクセス処理中にエラーが発生した場合に送出する例外です。
次のどちらかの場合に発生します。
  • 取得しようとしたリソースがない場合
  • 入出力例外(java.io.IOException)が発生した場合