Cosminexus V9 アプリケーションサーバ Cosminexus Reliable Messaging
ObjectMessageインタフェースはシリアライズできるJavaオブジェクトを含むメッセージを送受信するために使用します。ObjectMessageインタフェースはMessageインタフェースを継承しているため,Messageインタフェースの機能を持っています。
ObjectMessageインタフェースを使用することでペイロードを設定および取得できます。このペイロードはシリアライズできるJavaオブジェクトです。JMSメッセージの各要素については,「2.5.1 JMSメッセージの構成」を参照してください。
public interface ObjectMessage extends Message { public java.io.Serializable getObject() throws JMSException; public void setObject(java.io.Serializable object) throws JMSException; }
ありません。
「(2) 形式」に記載した順序で各メソッドを説明します。
public java.io.Serializable getObject() throws JMSException
直列化できるメッセージ本体データを返します。メッセージ本体が設定されていない場合はデフォルト値であるnullを返します。
例外クラス | 説明 |
---|---|
JMSException | 内部エラーのためにJMSプロバイダがオブジェクトの取得に失敗しました。 |
MessageFormatException | ペイロードの型が無効なため直列化されたオブジェクトの復元が失敗しました。 |
public void setObject(java.io.Serializable object) throws JMSException
メッセージのデータを含む直列化できるオブジェクトを設定します。
setObjectメソッドの内部では引数オブジェクトのコピーを生成し,そのコピーをObjectMessageオブジェクトのペイロードに設定します。そのため,そのあと引数オブジェクトを変更してもObjectMessageオブジェクトのペイロードに影響しなくなります。
引数名 | 説明 |
---|---|
object | メッセージのデータ |
例外クラス | 説明 |
---|---|
JMSException | object引数にnullが指定されました。 |
内部エラーのためにJMSプロバイダがオブジェクトの設定に失敗しました。 | |
MessageFormatException | 引数の型が無効なためオブジェクトの直列化が失敗しました。 |
MessageNotWriteableException | 読み取り専用モードのプロパティに情報を書き込もうとしました。 |
All Rights Reserved. Copyright (C) 2012, 2015, Hitachi, Ltd.