付録A.3 メソッドの機能差

メソッドの機能差について説明します。機能種別ごとの表でインタフェース名およびメソッド名のアルファベット順に説明します。

<この項の構成>
(1) メッセージング共通機能のメソッドの機能差
(2) PTPメッセージング機能のメソッドの機能差
(3) メッセージ機能のメソッドの機能差

(1) メッセージング共通機能のメソッドの機能差

メッセージング共通機能のメソッドの機能差について,次の表に示します。

表A-3 メッセージング共通機能のメソッドの機能差

項番インタフェース名メソッド名機能差
1Connectionvoid close()
2java.lang.String getClientID()このメソッドは未サポートです。このメソッドを発行した場合,必ずnullが返されます。
3ExceptionListener
getExceptionListener()
このメソッドは未サポートです。このメソッドを発行した場合,必ずnullが返されます。
4ConnectionMetaData
getMetaData()
5void setClientID(
java.lang.String clientID)
このメソッドは未サポートです。このメソッドで設定した値は実際には使用されません。
6void setExceptionListener(
ExceptionListener listener)
このメソッドは未サポートです。このメソッドで設定した値は実際には使用されません。
7void start()
8void stop()
9ConnectionFactory
10ConnectionMetaDataint getJMSMajorVersion()1が返されます。
11int getJMSMinorVersion()0が返されます。
12java.lang.String
getJMSProviderName()
"Cosminexus Reliable Messaging"が返されます。
13java.lang.String getJMSVersion()"1.0"が返されます。
14java.util.Enumeration
getJMSXPropertyNames()
"JMSXRcvTimestamp","JMSXDeliveryCount","JMSXGroupID"および"JMSXGroupSeq"が格納されたEnumerationが返されます。
15int getProviderMajorVersion()JMSプロバイダのメジャーバージョン番号を返します。この値は,Cosminexus RMのバージョンに対応します。
16int getProviderMinorVersion()JMSプロバイダのマイナーバージョン番号を返します。この値は,Cosminexus RMのリビジョンに対応します。
17java.lang.String
getProviderVersion()
JMSプロバイダのバージョンを示す文字列を返します。この文字列は,Cosminexus RMのバージョンおよびリビジョンに対応します。
18Destination
19MessageConsumervoid close()
20MessageListener
getMessageListener()
このメソッドは未サポートです。このメソッドを発行した場合,必ずnullが返されます。
21java.lang.String
getMessageSelector()
22Message receive()
23Message receive(long timeout)
24Message receiveNoWait()
25void setMessageListener(
MessageListener listener)
このメソッドは未サポートです。このメソッドで設定した値は実際には使用されません。
26MessageProducervoid close()
27int getDeliveryMode()このメソッドは未サポートです。このメソッドを発行した場合,必ず0が返されます。
28boolean getDisableMessageID()このメソッドは未サポートです。このメソッドを発行した場合,必ずfalseが返されます。
29boolean
getDisableMessageTimestamp()
このメソッドは未サポートです。このメソッドを発行した場合,必ずfalseが返されます。
30int getPriority()
31long getTimeToLive()このメソッドは未サポートです。このメソッドを発行した場合,必ず0が返されます。
32void setDeliveryMode(
int deliveryMode)
このメソッドは未サポートです。このメソッドで設定した値は実際には使用されません。
33void setDisableMessageID(
boolean value)
このメソッドは未サポートです。このメソッドで設定した値は実際には使用されません。
34void setDisableMessageTimestamp(
boolean value)
このメソッドは未サポートです。このメソッドで設定した値は実際には使用されません。
35void setPriority(int defaultPriority)
36void setTimeToLive(
long timeToLive)
このメソッドは未サポートです。このメソッドで設定した値は実際には使用されません。
37Sessionvoid close()
38void commit()
39BytesMessage
createBytesMessage()
40MapMessage createMapMessage()このメソッドは未サポートです。このメソッドを発行した場合,JMSExceptionが発生します。
41Message createMessage()
42ObjectMessage
createObjectMessage()
43ObjectMessage
createObjectMessage(
java.io.Serializable object)
44StreamMessage
createStreamMessage()
このメソッドは未サポートです。このメソッドを発行した場合,JMSExceptionが発生します。
45TextMessage createTextMessage()
46TextMessage createTextMessage(
java.lang.String text)
47MessageListener
getMessageListener()
このメソッドは未サポートです。このメソッドを発行した場合,必ずnullが返されます。
48boolean getTransacted()
49void recover()
50void rollback()
51void run()このメソッドは未サポートです。このメソッドを発行した場合,JMSExceptionが発生します。
52void setMessageListener(
MessageListener listener)
このメソッドは未サポートです。このメソッドで設定した値は実際には使用されません。
(凡例)
-:機能差はありません。

(2) PTPメッセージング機能のメソッドの機能差

PTPメッセージング機能のメソッドの機能差について,次の表に示します。

表A-4 PTPメッセージング機能のメソッドの機能差

項番インタフェース名メソッド名機能差
1Queuejava.lang.String getQueueName()
2java.lang.String toString()
3QueueBrowservoid close()
4java.util.Enumeration
getEnumeration()
現在のキューにあるメッセージの一覧を取得します。一覧を取得したあとにメッセージを参照する際,すでにメッセージは削除または消失していることがあります。
5java.lang.String
getMessageSelector()
6Queue getQueue()
7QueueConnectionConnectionConsumer
createConnectionConsumer(
Queue queue,
java.lang.String messageSelector,
ServerSessionPool sessionPool,
int maxMessages)
このメソッドは未サポートです。このメソッドを発行した場合,JMSExceptionが発生します。
8QueueSession
createQueueSession(
boolean transacted,
int acknowledgeMode)
9QueueConnectionFactoryQueueConnection
createQueueConnection()
10QueueConnection
createQueueConnection(
java.lang.String userName,
java.lang.String password)
11QueueReceiverQueue getQueue()
12QueueSenderQueue getQueue()
13void send(Message message)
14void send(Message message,
int deliveryMode, int priority,
long timeToLive)
このメソッドを発行した場合,deliveryMode引数とtimeToLive引数を無視して実行されます。
15void send(Queue queue,
Message message)
16void send(Queue queue,
Message message,
int deliveryMode, int priority,
long timeToLive)
このメソッドを発行した場合,deliveryMode引数とtimeToLive引数を無視して実行されます。
17QueueSessionQueueBrowser createBrowser(
Queue queue)
18QueueBrowser createBrowser(
Queue queue,
java.lang.String messageSelector)
19Queue createQueue(
java.lang.String queueName)
20QueueReceiver createReceiver(
Queue queue)
21QueueReceiver createReceiver(
Queue queue,
java.lang.String messageSelector)
22QueueSender createSender(
Queue queue)
23TemporaryQueue
createTemporaryQueue()
このメソッドは未サポートです。このメソッドを発行した場合,JMSExceptionが発生します。
(凡例)
-:機能差はありません。

(3) メッセージ機能のメソッドの機能差

メッセージ機能のメソッドの機能差について,次の表に示します。

表A-5 メッセージ機能のメソッドの機能差

項番インタフェース名メソッド名機能差
1BytesMessageboolean readBoolean()
2byte readByte()
3int readBytes(byte[] value)
4int readBytes(
byte[] value, int length)
5char readChar()
6double readDouble()
7float readFloat()
8int readInt()
9long readLong()
10short readShort()
11int readUnsignedByte()
12int readUnsignedShort()
13java.lang.String readUTF()
14void reset()
15void writeBoolean(boolean value)
16void writeByte(byte value)
17void writeBytes(byte[] value)
18void writeBytes(byte[] value,
int offset, int length)
19void writeChar(char value)
20void writeDouble(double value)
21void writeFloat(float value)
22void writeInt(int value)
23void writeLong(long value)
24void writeObject(
java.lang.Object value)
25void writeShort(short value)
26void writeUTF(
java.lang.String value)
27DeliveryMode
28Messagevoid acknowledge()Message-driven Beanで配信されたメッセージには使用できません。
このメソッドをMessage-driven Beanで配信されたメッセージに使用した場合はJMSExceptionが発生します。
また,QueueConnection.createQueueSession()メソッドのtransacted引数がtrueのとき,およびtransacted引数がfalseかつacknowledgeMode引数がAUTO_ACKNOWLEDGEまたは DUPS_OK_ACKNOWLEDGEのときに発行した場合はJMSExceptionが発生します。
29void clearBody()
30void clearProperties()
31boolean getBooleanProperty(
java.lang.String name)
32byte getByteProperty(
java.lang.String name)
33double getDoubleProperty(
java.lang.String name)
34float getFloatProperty(
java.lang.String name)
35int getIntProperty(
java.lang.String name)
36java.lang.String
getJMSCorrelationID()
JMSCorrelationIDヘッダが設定されていないときに発行した場合,nullが返されます。
37byte[]
getJMSCorrelationIDAsBytes()
JMSCorrelationIDヘッダが設定されていないときに発行した場合,nullが返されます。
38int getJMSDeliveryMode()JMSDeliveryModeヘッダが設定されていないときに発行した場合,0が返されます。
39Destination getJMSDestination()JMSDestinationヘッダが設定されていないときに発行した場合,nullが返されます。
40long getJMSExpiration()JMSExpirationヘッダが設定されていないときに発行した場合,0が返されます。
41java.lang.String
getJMSMessageID()
JMSMessageIDヘッダが設定されていないときに発行した場合,nullが返されます。
42int getJMSPriority()JMSPriorityヘッダが設定されていないときに発行した場合,4が返されます。
43boolean getJMSRedelivered()JMSRedeliveredヘッダが設定されていないときに発行した場合,falseが返されます。
44Destination getJMSReplyTo()JMSReplyToヘッダが設定されていないときに発行した場合,nullが返されます。
45long getJMSTimestamp()JMSTimestampヘッダが設定されていないときに発行した場合,0が返されます。
46java.lang.String getJMSType()JMSTypeヘッダが設定されていないときに発行した場合,nullが返されます。
47long getLongProperty(
java.lang.String name)
48java.lang.Object getObjectProperty(
java.lang.String name)
49java.util.Enumeration
getPropertyNames()
プロパティがない場合はnullが返されます。
50short getShortProperty(
java.lang.String name)
51java.lang.String getStringProperty(
java.lang.String name)
52boolean propertyExists(
java.lang.String name)
53void setBooleanProperty(
java.lang.String name,
boolean value)
name引数の文字数が64文字を超える場合,JMSExceptionが発生します。
54void setByteProperty(
java.lang.String name, byte value)
name引数の文字数が64文字を超える場合,JMSExceptionが発生します。
55void setDoubleProperty(
java.lang.String name,
double value)
name引数の文字数が64文字を超える場合,JMSExceptionが発生します。
56void setFloatProperty(
java.lang.String name, float value)
name引数の文字数が64文字を超える場合,JMSExceptionが発生します。
57void setIntProperty(
java.lang.String name, int value)
name引数の文字数が64文字を超える場合,JMSExceptionが発生します。
58void setJMSCorrelationID(
java.lang.String correlationID)
correlationID引数の文字数が512文字を超える場合,JMSExceptionが発生します。
59void setJMSCorrelationIDAsBytes(
byte[] correlationID)
correlationID引数の文字数が512文字を超える場合,JMSExceptionが発生します。
60void setJMSDeliveryMode(
int deliveryMode)
このメソッドで設定した値は実際には使用されません。
61void setJMSDestination(
Destination destination)
このメソッドで設定した値は実際には使用されません。
62void setJMSExpiration(
long expiration)
このメソッドで設定した値は実際には使用されません。
63void setJMSMessageID(
java.lang.String id)
このメソッドで設定した値は実際には使用されません。
64void setJMSPriority(int priority)このメソッドで設定した値は実際には使用されません。
65void setJMSRedelivered(
boolean redelivered)
このメソッドで設定した値は実際には使用されません。
66void setJMSReplyTo(
Destination replyTo)
67void setJMSTimestamp(
long timestamp)
このメソッドで設定した値は実際には使用されません。
68void setJMSType(
java.lang.String type)
type引数の文字数が512文字を超える場合,JMSExceptionが発生します。
69void setLongProperty(
java.lang.String name, long value)
name引数の文字数が64文字を超える場合,JMSExceptionが発生します。
70void setObjectProperty(
java.lang.String name,
java.lang.Object value)
name引数の文字数が64文字を超える場合,JMSExceptionが発生します。
value引数の文字数が512文字を超える場合,JMSExceptionが発生します。
71void setShortProperty(
java.lang.String name, short value)
name引数の文字数が64文字を超える場合,JMSExceptionが発生します。
72void setStringProperty(
java.lang.String name,
java.lang.String value)
name引数の文字数が64文字を超える場合,JMSExceptionが発生します。
value引数の文字数が512文字を超える場合,JMSExceptionが発生します。
73ObjectMessagejava.io.Serializable getObject()
74void setObject(
java.io.Serializable object)
75TextMessagejava.lang.String getText()
76void setText(java.lang.String string)
(凡例)
-:機能差はありません。