QABinaryMessage 接口

QABinaryMessage 对象用于发送包含未解释字节流的消息。

语法

public interface QABinaryMessage

基类

成员

QABinaryMessage 接口的所有成员，包括所有继承的成员。

名称	说明
clearProperties 方法	清除消息的所有属性。
getAddress 方法	返回 QAMessage 实例的目标地址。
getBodyLength 方法	返回消息主体的大小（以字节为单位）。
getBooleanProperty 方法	获取布尔型消息属性。
getByteProperty 方法	获取有符号字节型消息属性。
getDoubleProperty 方法	获取双精度型消息属性。
getExpiration 方法	返回消息的有效期值，或在消息没有到期或尚未发送的情况下返回空值。
getFloatProperty 方法	获取浮点型消息属性。
getInReplyToID 方法	返回此消息所回复的消息的消息 ID。
getIntProperty 方法	获取整型消息属性。
getLongProperty 方法	获取长整型消息属性。
getMessageID 方法	返回消息的全局唯一消息 ID。
getPriority 方法	返回消息的优先级（从 0 到 9）。
getProperty 方法	获取消息属性。
getPropertyNames 方法	获取消息属性名称的枚举器。
getPropertyType 方法	返回给定属性的属性类型。
getRedelivered 方法	指示消息是否以前已接收但尚未确认。
getReplyToAddress 方法	返回此消息的回复地址。
getShortProperty 方法	获取短整型消息属性。
getStringProperty 方法	获取字符串型消息属性。
getTimestamp 方法	返回消息时间戳，即创建消息的时间。
propertyExists 方法	指示是否已为此消息设置了给定属性。
readBinary 方法	从 QABinaryMessage 实例主体的未读部分开始读取部分数量的字节并将其存储到数组目标中。
readBoolean 方法	从 QABinaryMessage 实例的消息主体的未读部分开始读取布尔值。
readByte 方法	从 QABinaryMessage 消息主体的未读部分开始读取有符号字节值。
readChar 方法	从 QABinaryMessage 消息主体的未读部分开始读取字符值。
readDouble 方法	从 QABinaryMessage 消息主体的未读部分开始读取双精度值。
readFloat 方法	从 QABinaryMessage 消息主体的未读部分开始读取浮点值。
readInt 方法	从 QABinaryMessage 消息主体的未读部分开始读取整数值。
readLong 方法	从 QABinaryMessage 消息主体的未读部分开始读取长整型值。
readShort 方法	从 QABinaryMessage 消息主体的未读部分开始读取短整型值。
readString 方法	从 QABinaryMessage 消息主体的未读部分开始读取字符串值。
reset 方法	重置消息以便从消息主体的开头开始读取值。
setBooleanProperty 方法	设置布尔型属性。
setByteProperty 方法	设置有符号字节型属性。
setDoubleProperty 方法	设置双精度型属性。
setFloatProperty 方法	设置浮点型属性。
setInReplyToID 方法	设置回复 ID，它用来标识此消息将回复的消息。
setIntProperty 方法	设置整型属性。
setLongProperty 方法	设置长整型属性。
setPriority 方法	设置消息的优先级（从 0 到 9）。
setProperty 方法	设置属性。
setReplyToAddress 方法	设置回复地址。
setShortProperty 方法	设置短整型属性。
setStringProperty 方法	设置字符串型属性。
writeBinary 方法	将字节数组值附加到 QABinaryMessage 实例的消息主体中。
writeBoolean 方法	将布尔值附加到 QABinaryMessage 实例的消息主体中。
writeByte 方法	将有符号字节值附加到 QABinaryMessage 实例的消息主体中。
writeChar 方法	将字符值附加到 QABinaryMessage 实例的消息主体中。
writeDouble 方法	将双精度值附加到 QABinaryMessage 实例的消息主体中。
writeFloat 方法	将浮点值附加到 QABinaryMessage 实例的消息主体中。
writeInt 方法	将整数值附加到 QABinaryMessage 实例的消息主体中。
writeLong 方法	将长整型值附加到 QABinaryMessage 实例的消息主体中。
writeShort 方法	将短整型值附加到 QABinaryMessage 实例的消息主体中。
writeString 方法	将字符串值附加到 QABinaryMessage 实例的消息主体中。
DEFAULT_PRIORITY 变量	缺省消息优先级。
DEFAULT_TIME_TO_LIVE 变量	缺省生存期值。

注释

QABinaryMessage 继承自类 QAMessage，并添加了字节消息主体。QABinaryMessage 提供了读取和写入字节消息主体的各种函数。

首次创建消息时，消息的主体处于只写模式。消息发送后，发送消息的客户端可保留和修改该消息，而不会影响已发送的消息。可以多次发送同一消息对象。

接收到消息时，提供程序已调用 QABinaryMessage.reset()，因此消息主体处于只读模式并且从消息主体的开头开始读取值。

以下示例使用 QABinaryMessage.writeString(String) 将其后是字符串 "Anywhere" 的字符串 "Q" 写入 QABinaryMessage 实例的消息主体。

// Create a binary message instance.
QABinaryMessage binary_message;
binary_message = qa_manager.createBinaryMessage();

// Set optional message properties.
binary_message.setReplyToAddress("my-queue-name");

// Write to the message body.
binary_message.writeString("Q");
binary_message.writeString("Anywhere");

// Put the message in the local database, ready for sending.
try {
    qa_manager.putMessage( "store-id\\queue-name", binary_message );
}
catch ( QAException e ) {
    handleError();
}

注意

在接收端，第一次 QABinaryMessage.readString() 调用返回 "Q"，而下一次 QABinaryMessage.readString() 调用则返回 "Anywhere"。

由 QAnywhere 代理发送消息。

另请参见

getBodyLength 方法
 readBinary 方法
 readBoolean 方法
 readByte 方法
 readChar 方法
 readDouble 方法
 readFloat 方法
 readInt 方法
 readLong 方法
 readShort 方法
 readString 方法
 reset 方法
 writeBinary 方法
 writeBoolean 方法
 writeByte 方法
 writeChar 方法
 writeDouble 方法
 writeFloat 方法
 writeInt 方法
 writeLong 方法
 writeShort 方法
 writeString 方法

使用DocCommentXchange 讨论此页。