メッセージキューイングアクセス機能 TP1/Message Queue - Access 使用の手引
QueueSessionインタフェース(JMS)
QueueSessionインタフェースはアプリケーションからの論理的なコネクションハンドルです。
QueueConnection.createQueueSessionでtransactedパラメタにtrueが指定されると,そのQueueSessionからの操作はトランザクションモードとなります。なお,QueueConnection.createQueueSessionでのacknowledgeパラメタは無視されます。
QueueSessionの機能を次に示します。
形式
public interface Session extends java.lang.Runnable { public static final int AUTO_ACKNOWLEDGE; public static final int CLIENT_ACKNOWLEDGE; public static final int DUPS_OK_ACKNOWLEDGE; public void close() throws JMSException; public void commit() throws JMSException; public BytesMessage createBytesMessage() throws JMSException; public MapMessage createMapMessage() throws JMSException; public Message createMessage() throws JMSException; public ObjectMessage createObjectMessage() throws JMSException; public ObjectMessage createObjectMessage (java.io.Serializable object) throws JMSException; public StreamMessage createStreamMessage() throws JMSException; public TextMessage createTextMessage() throws JMSException; public TextMessage createTextMessage(java.lang.String text) throws JMSException; public MessageListener getMessageListener() throws JMSException; public boolean getTransacted() throws JMSException; public void recover() throws JMSException; public void rollback() throws JMSException; public void run(); public void setMessageListener(MessageListener listener) throws JMSException; } public interface QueueSession extends Session { public QueueBrowser createBrowser(Queue queue) throws JMSException; public QueueBrowser createBrowser(Queue queue, java.lang.String messageSelector) throws JMSException; public Queue createQueue(java.lang.String queueName) throws JMSException; public QueueReceiver createReceiver(Queue queue) throws JMSException; public QueueReceiver createReceiver(Queue queue, java.lang.String messageSelector) throws JMSException; public QueueSender createSender(Queue queue) throws JMSException; public TemporaryQueue createTemporaryQueue() throws JMSException; }
フィールド
● public static final int AUTO_ACKNOWLEDGE
このフィールドは未サポートです。
● public static final int CLIENT_ACKNOWLEDGE
このフィールドは未サポートです。
● public static final int DUPS_OK_ACKNOWLEDGE
このフィールドは未サポートです。
メソッド
● public void close() throws JMSException
QueueSessionをクローズします。
● public void commit() throws JMSException
ローカルトランザクションをコミットします。
● public BytesMessage createBytesMessage() throws JMSException
BytesMessageオブジェクトを生成します。
● public MapMessage createMapMessage() throws JMSException
このメソッドは未サポートです。
● public Message createMessage() throws JMSException
Messageオブジェクトを生成します。
● public ObjectMessage createObjectMessage() throws JMSException
このメソッドは未サポートです。
● public ObjectMessage createObjectMessage(java.io.Serializable object) throws JMSException
このメソッドは未サポートです。
● public StreamMessage createStreamMessage() throws JMSException
このメソッドは未サポートです。
● public TextMessage createTextMessage() throws JMSException
このメソッドは未サポートです。
● public TextMessage createTextMessage(java.lang.String text) throws JMSException
このメソッドは未サポートです。
● public MessageListener getMessageListener() throws JMSException
このメソッドは未サポートです。
● public boolean getTransacted() throws JMSException
QueueSessionがトランザクションモードかどうかを取得します。
● public void recover() throws JMSException
このメソッドは未サポートです。
● public void rollback() throws JMSException
ローカルトランザクションをロールバックします。
● public void run()
このメソッドは未サポートです。
● public void setMessageListener(MessageListener listener) throws JMSException
このメソッドは未サポートです。
● public QueueBrowser createBrowser(Queue queue) throws JMSException
キューブラウザを生成します。
● public QueueBrowser createBrowser(Queue queue, java.lang.String messageSelector) throws JMSException
キューブラウザを生成します。
● public Queue createQueue(java.lang.String queueName) throws JMSException
このメソッドは未サポートです。Queueオブジェクトは上位クラスで作成されて,JNDIにあらかじめ登録されているためです。
● public QueueReceiver createReceiver(Queue queue) throws JMSException
キューレシーバを生成します。
● public QueueReceiver createReceiver(Queue queue, java.lang.String messageSelector) throws JMSException
キューレシーバを生成します。
● public QueueSender createSender(Queue queue) throws JMSException
キューセンダを生成します。
● public TemporaryQueue createTemporaryQueue() throws JMSException
動的キューを生成します。生成された動的キューは,TemporaryQueue内のdeleteメソッドが発行されると削除されます。
createTemporaryQueueメソッドによって作成される動的キューは,QueueSessionオブジェクトごとに異なります。
TemporaryQueueを使用するためには,TP1/Message Queue - AccessリソースアダプタのProperties設定の環境変数ModelQueueNameに,モデルキュー名を指定します。詳細については,「2.2 MQCクライアント機能の環境設定」を参照してください。また,サーバ側のTP1/Message Queueでモデルキューを定義する必要があります。このモデルキューのDefinitionType属性によって,一時的動的キューか永続的動的キューのどちらかが作成されます。作成されるキューの種類ごとに,次に示す点に注意が必要です。
createTemporaryQueueメソッドによって作成される動的キュー名は「JMS*」です(*:ユニークな文字列)。
All Rights Reserved. Copyright (C) 2006, 2007, Hitachi, Ltd.
(C) Copyright International Business Machines Corporation 1994, 1999. All rights reserved.