InterSystemMessage (NablarchApi)

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

Type Parameters:

TSelf - 各具象クラスの型

Direct Known Subclasses:

ReceivedMessage, SendingMessage
```
public abstract class InterSystemMessage<TSelf extends InterSystemMessage<?>>
extends java.lang.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のサブクラス
Author:

Iwauo Tajima

Method Summary

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

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

Class InterSystemMessage<TSelf extends InterSystemMessage<?>>

プロトコルヘッダー

メッセージボディ

クラス構成

Method Summary

Method Detail

setFormatter

getRecordOf

getRecords

getRecordsOf

getParamMap

getParam

getHeaderMap

getMessageId

setMessageId

getDestination

setDestination

getCorrelationId

setCorrelationId

getReplyTo

setReplyTo