Hitachi

OpenTP1 Version 7 メッセージキューイングアクセス機能 TP1/Message Queue Access 使用の手引


MQCクライアント機能のJMSインタフェース一覧

MQCクライアント機能が提供するJMSインタフェースの概要について説明します。

Java言語のJMSインタフェースの一覧を次の表に示します。なお,Oracle Corporationが提供するJMS 1.0とMQCクライアント機能のJMSインタフェースとの機能差については,「付録B JMS仕様とMQCクライアント機能のJMSインタフェースとの差異」を参照してください。

表7‒1 JMSインタフェースの一覧

クラス名

機能

BytesMessage

解釈されないバイトのストリームを含むメッセージです。

ConnectionMetaData

Connectionを示すインフォメーションを提供します。

DeliveryMode

JMSによってサポートされる配送モードです。

Destination

Queue

プロバイダ特有のキュー名をカプセル化します。

Message

すべてのJMSメッセージのルートインタフェースです。

MessageConsumer

QueueReceiver

クライアントはキューに届けられたメッセージを受け取ります。

MessageProducer

QueueSender

クライアントはキューにメッセージを送ります。

QueueBrowser

クライアントがキューのメッセージを取り去らないで参照します。

QueueConnection

Connection

JMS PTPプロバイダへのアクティブな接続です。

QueueConnectionFactory

ConnectionFactory

クライアントがJMS PTPプロバイダでQueueConnectionを生成するためにQueueConnectionFactoryを使用します。

QueueSession

Session

QueueReceiver,QueueSender,QueueBrowser,およびTemporaryQueueを作るためのメソッドを提供します。

TemporaryQueue

QueueConnectionがアクティブ状態のときに生成されるユニークなQueueオブジェクトです。

インタフェースの一覧を次の表に示します。

表7‒2 インタフェースの一覧(JMSインタフェース)

インタフェース名

機能

MQC

TP1/Message Queueの定義値です。

JMSインタフェース使用時のJava例外クラスの一覧を次の表に示します。

表7‒3 例外クラスの一覧(JMSインタフェース)

クラス名

例外をスローするタイミング

IllegalStateException

メソッドが不正な場合,不適当なタイミングで起動された場合,またはプロバイダが要求されたオペレーションを実行するための適切な状態でない場合

InvalidClientIDException

クライアントが接続のクライアントIDをプロバイダによって拒否される値にセットしようとした場合

InvalidDestinationException

宛先がプロバイダによって理解されない,つまり宛先が有効でない場合

InvalidSelectorException

JMSクライアントが不正な構文のメッセージセレクタをプロバイダに指定しようとした場合

JMSException

すべてのJMS例外のルートクラスであるため,特定のタイミングに該当しません。

JMSSecurityException

クライアントによって送られたユーザ名またはパスワードが,プロバイダによって拒否された場合

MessageEOFException

StreamMessageかBytesMessageが読みこまれている最中に,ストリームが予期しないで終了に達した場合

MessageFormatException

JMSクライアントがメッセージによってサポートされていないデータタイプを使おうとした場合,またはメッセージデータを間違ったタイプで読み込もうとした場合

MessageNotReadableException

JMSクライアントが書き込み専用のメッセージを読み込もうとした場合

MessageNotWriteableException

JMSクライアントが読み込み専用のメッセージに書き込もうとした場合

ResourceAllocationException

プロバイダがメソッドによって要求されたリソースを割り当てられない場合

TransactionInProgressException

トランザクションが進行中であるために,オペレーションが無効の場合

TransactionRolledBackException

Session.commitの呼び出しの結果が現在のトランザクションのロールバックに帰着する場合