InterSystemMessage (NablarchApi)

java.lang.Object
- nablarch.fw.messaging.InterSystemMessage<TSelf>

型パラメータ:

TSelf - 各具象クラスの型

直系の既知のサブクラス:

ReceivedMessage, SendingMessage
```
public abstract class InterSystemMessage<TSelf extends InterSystemMessage<?>>
extends Object
```
外部システムに対する送受信電文の内容を格納するデータオブジェクト。このオブジェクトは以下のデータを保持する。
- プロトコルヘッダー
- メッセージボディ
プロトコルヘッダー

プロトコルヘッダーはMOM間のメッセージ転送制御に関連する制御情報であり、 MOM側で自動的に解析される。これらの情報の多くは、MOM製品に依存した仕様であるため、本フレームワークはプロトコルヘッダーに極力依存しない設計となっている。
本フレームワークが直接使用するプロトコルヘッダーは以下の5つのみである。
- メッセージIDヘッダ
- 関連メッセージIDヘッダ
- 送信宛先ヘッダ
- 応答宛先ヘッダ
- メッセージ有効期間ヘッダ (送信電文のみ)
メッセージボディ

プロトコルヘッダーを除いた電文のデータ部をメッセージボディと呼ぶ。メッセージボディ部は、MOM側では単にバイナリデータとして扱うものとし、解析は全てフレームワーク側で行う。

メッセージボディのフォーマットは nablarch.core.dataformat パッケージが提供する機能を用いて定義する。解析後の電文はList-Map形式でアクセスすることが可能である。
メッセージボディ内は通常、以下に示すような階層構造をもち、その解析は各階層に対応したデータリーダもしくはハンドラによって段階的に行われる。
- フレームワーク制御ヘッダ
- 業務共通ヘッダ
- 業務データ
なお、メッセージボディの階層化はデータリーダやハンドラの構成を含め、フレームワークの全体構造に関わる重要な要素なので、可能な限り早い段階で確定させておく必要がある。
クラス構成

このクラスは各電文クラスに共通する機能やデータ構造を実装するものの、直接インスタンスを作成することはできない。これは、JMSのjavax.jms.Messageのような汎用メッセージオブジェクトを使いまわすのではなく、その用途に応じて以下の4つの具象クラスを使いわける設計となっているためである。
1. ReceivedMessage (受信メッセージ)
2. SendingMessage (送信メッセージ)
3. RequestMessage (被仕向け要求受信メッセージ) : ReceivedMessageのサブクラス
4. ResponseMessage (応答送信メッセージ) : SendingMessageのサブクラス
作成者:

Iwauo Tajima

メソッドのサマリー

すべてのメソッドインスタンス・メソッド concreteメソッド
修飾子とタイプ	メソッドと説明
`String`	`getCorrelationId()` この電文に関連付けられているメッセージのメッセージIDを返す。
`String`	`getDestination()` この電文の宛先キューの論理名を取得する。
`Map`	`getHeaderMap()` ヘッダーの一覧をMap形式で返す。
`String`	`getMessageId()` この電文に割り当てられた識別子(メッセージID)を返す。
`Object`	`getParam(String name)` 電文のデータ部の末尾レコードの中から指定されたフィールドの値を取得して返す。
`Map`	`getParamMap()` 電文のデータ部の末尾レコードを返す。
`DataRecord`	`getRecordOf(String recordType)` 指定された種別のレコードを返す。
`List<DataRecord>`	`getRecords()` メッセージボディに含まれる全レコードを返す。
`List<DataRecord>`	`getRecordsOf(String recordType)` メッセージボディに含まれる指定された種別の全レコードを返す。
`String`	`getReplyTo()` 応答宛先キューの論理名を返す。
`TSelf`	`setCorrelationId(String messageId)` この電文に既存のメッセージのIDを関連付ける。
`TSelf`	`setDestination(String destination)` 送信宛先キューの論理名を設定する。
`TSelf`	`setFormatter(DataRecordFormatter formatter)` メッセージボディのフォーマット定義を設定する。
`TSelf`	`setMessageId(String messageId)` メッセージIDを設定する。
`TSelf`	`setReplyTo(String replyTo)` この電文に対する応答宛先となるキューの論理名を設定する。

- メソッドの詳細
  - setFormatter
```
@Published(tag="architect")
public TSelf setFormatter(DataRecordFormatter formatter)
```
    メッセージボディのフォーマット定義を設定する。
    
    パラメータ:
    
    formatter - フォーマット定義オブジェクト
    
    戻り値:
    
    このオブジェクト自体
  - getRecordOf
```
@Published(tag="architect")
public DataRecord getRecordOf(String recordType)
```
    指定された種別のレコードを返す。複数存在する場合は、その先頭のレコードを返す。存在しない場合はnullを返す。
    
    パラメータ:
    
    recordType - レコード名
    
    戻り値:
    
    指定した種別のデータレコード (存在しない場合はnull)
  - getRecords
```
@Published(tag="architect")
public List<DataRecord> getRecords()
```
    メッセージボディに含まれる全レコードを返す。
    
    戻り値:
    
    メッセージボディに含まれる全てのレコード
  - getRecordsOf
```
@Published(tag="architect")
public List<DataRecord> getRecordsOf(String recordType)
```
    メッセージボディに含まれる指定された種別の全レコードを返す。該当するレコードが存在しない場合は空のリストを返す。
    
    パラメータ:
    
    recordType - レコード種別
    
    戻り値:
    
    メッセージボディに含まれる指定された種別の全レコード
  - getParamMap
```
@Published(tag="architect")
public Map getParamMap()
```
    電文のデータ部の末尾レコードを返す。
    主にシングルレコード形式の電文で使用することを想定している。レコードが存在しない場合はnullを返す。
    
    戻り値:
    
    受信電文内の各フィールドの値を格納したMap
  - getParam
```
@Published(tag="architect")
public Object getParam(String name)
```
    電文のデータ部の末尾レコードの中から指定されたフィールドの値を取得して返す。
    主にシングルレコード形式の電文で使用することを想定している。レコードが存在しない場合、もしくは、レコードに指定された項目が存在しない場合はnullを返す。。
    
    パラメータ:
    
    name - 取得するフィールドの名称
    
    戻り値:
    
    フィールドの値
  - getHeaderMap
```
@Published(tag="architect")
public Map getHeaderMap()
```
    ヘッダーの一覧をMap形式で返す。
    
    戻り値:
    
    ヘッダーの一覧
  - getMessageId
```
@Published(tag="architect")
public String getMessageId()
```
    この電文に割り当てられた識別子(メッセージID)を返す。メッセージIDは電文送信時にMOMによって自動的に割り振られるため、書式や一意性の範囲は製品依存となる。また、送信前の電文にはnullが設定されている。
    
    戻り値:
    
    この電文のID文字列 (送信前はnull)
  - setMessageId
```
@Published(tag="architect")
public TSelf setMessageId(String messageId)
```
    メッセージIDを設定する。メッセージIDはMOM側で採番される値であり、このメソッドは単体テスト用に便宜的に容易されているものである。
    
    パラメータ:
    
    messageId - メッセージIDとして指定する文字列
    
    戻り値:
    
    このオブジェクト自体
  - getDestination
```
@Published(tag="architect")
public String getDestination()
```
    この電文の宛先キューの論理名を取得する。 MessagingContext.send(SendingMessage) メソッドでは、この戻り値に対応する宛先に送信される。
    
    戻り値:
    
    宛先キューの論理名
  - setDestination
```
@Published(tag="architect")
public TSelf setDestination(String destination)
```
    送信宛先キューの論理名を設定する。
    
    パラメータ:
    
    destination - 応答宛先キューの論理名
    
    戻り値:
    
    このオブジェクト自体
  - getCorrelationId
```
@Published(tag="architect")
public String getCorrelationId()
```
    この電文に関連付けられているメッセージのメッセージIDを返す。
    
    戻り値:
    
    この電文のID文字列
  - setCorrelationId
```
@Published(tag="architect")
public TSelf setCorrelationId(String messageId)
```
    この電文に既存のメッセージのIDを関連付ける。
    
    パラメータ:
    
    messageId - 関連付けるメッセージのID
    
    戻り値:
    
    この電文のID文字列
  - getReplyTo
```
@Published(tag="architect")
public String getReplyTo()
```
    応答宛先キューの論理名を返す。
    
    戻り値:
    
    この電文のID文字列
  - setReplyTo
```
@Published(tag="architect")
public TSelf setReplyTo(String replyTo)
```
    この電文に対する応答宛先となるキューの論理名を設定する。
    
    パラメータ:
    
    replyTo - 応答宛先キューの論理名
    
    戻り値:
    
    このオブジェクト自体

クラス InterSystemMessage<TSelf extends InterSystemMessage<?>>

プロトコルヘッダー

メッセージボディ

クラス構成

メソッドのサマリー

メソッドの詳細

setFormatter

getRecordOf

getRecords

getRecordsOf

getParamMap

getParam

getHeaderMap

getMessageId

setMessageId

getDestination

setDestination

getCorrelationId

setCorrelationId

getReplyTo

setReplyTo