QABinaryMessage 类

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

语法

public class QABinaryMessage : QAMessage

基类

成员

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

名称	说明
QABinaryMessage 析构函数	虚析构函数。
beginEnumPropertyNames 方法	开始枚举消息属性名称。
castToBinaryMessage 方法	将此 QAMessage 转换为 QABinaryMessage。
castToTextMessage 方法	将此 QAMessage 转换为 QATextMessage。
clearProperties 方法	清除消息的属性。
endEnumPropertyNames 方法	释放与消息属性名称枚举关联的资源。
getAddress 方法	获取 QAMessage 实例的目标地址。
getBodyLength 方法	返回消息主体的大小（以字节为单位）。
getBooleanProperty 方法	获取具有指定名称的 qa_bool 属性的值。
getByteProperty 方法	获取具有指定名称的 qa_byte 属性的值。
getDoubleProperty 方法	获取具有指定名称的 qa_double 属性的值。
getExpiration 方法	获取消息的到期时间。
getFloatProperty 方法	获取具有指定名称的 qa_float 属性的值。
getInReplyToID 方法	获取此消息将回复的消息的 ID。
getIntProperty 方法	获取具有指定名称的 qa_int 属性的值。
getLongProperty 方法	获取具有指定名称的 qa_long 属性的值。
getMessageID 方法	获取消息 ID。
getPriority 方法	获取消息的优先级。
getPropertyType 方法	返回具有给定名称的属性的类型。
getRedelivered 方法	指示消息是否以前已接收但尚未确认。
getReplyToAddress 方法	获取对此消息的回复应发送到的地址。
getShortProperty 方法	获取具有指定名称的 qa_short 属性的值。
getStringProperty 方法	获取具有指定名称的 qa_string 属性的值。
getTimestamp 方法	获取消息时间戳。
getTimestampAsString 方法	按已设置格式的字符串形式获取消息时间戳。
nextPropertyName 方法	返回给定枚举的消息属性名称；如果没有其它属性名称，则返回 -1。
propertyExists 方法	指示是否存在属性值。
readBinary 方法	从 QABinaryMessage 实例消息主体的未读部分开始读取指定字节数。
readBoolean 方法	从 QABinaryMessage 实例的消息主体的未读部分开始读取布尔值。
readByte 方法	从 QABinaryMessage 实例的消息主体的未读部分开始读取有符号的 8 位值。
readChar 方法	从 QABinaryMessage 实例的消息主体的未读部分开始读取字符值。
readDouble 方法	从 QABinaryMessage 实例的消息主体的未读部分开始读取双精度值。
readFloat 方法	从 QABinaryMessage 实例的消息主体的未读部分开始读取浮点值。
readInt 方法	从 QABinaryMessage 实例的消息主体的未读部分开始读取有符号的 32 位整数值。
readLong 方法	从 QABinaryMessage 实例的消息主体的未读部分开始读取有符号的 64 位整数值。
readShort 方法	从 QABinaryMessage 实例的消息主体的未读部分开始读取有符号的 16 位值。
readString 方法	从 QABinaryMessage 实例的消息主体的未读部分开始读取字符串值。
reset 方法	重置消息以便从消息主体的开头开始读取值。
setAddress 方法	设置此消息的目标地址。
setBooleanProperty 方法	将具有指定名称的 qa_bool 属性设置为指定值。
setByteProperty 方法	将具有指定名称的 qa_byte 属性设置为指定值。
setDoubleProperty 方法	将具有指定名称的 qa_double 属性设置为指定值。
setFloatProperty 方法	将具有指定名称的 qa_float 属性设置为指定值。
setInReplyToID 方法	设置消息的回复 ID。
setIntProperty 方法	将具有指定名称的 qa_int 属性设置为指定值。
setLongProperty 方法	将具有指定名称的 qa_long 属性设置为指定值。
setMessageID 方法	设置消息 ID。
setPriority 方法	设置此消息的优先级级别。
setRedelivered 方法	设置此消息是否重新发送的指示。
setReplyToAddress 方法	设置对此消息的回复应发送到的地址。
setShortProperty 方法	将具有指定名称的 qa_short 属性设置为指定值。
setStringProperty 方法	将具有指定名称的 qa_string 属性设置为指定值。
setTimestamp 方法	设置消息时间戳。
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 变量	缺省消息生存期值。

注释

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

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

接收到消息时，提供程序已调用 QABinaryMessage::reset 方法，因此消息主体处于只读模式并且从消息主体的开头开始读取值。如果客户端尝试在只读模式下写入消息，则设置 COMMON_MSG_NOT_WRITEABLE_ERROR。

示例

以下示例使用 QABinaryMessage::writeString 方法将其后是字符串 "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.

if( !qa_manager->putMessage( "store-id\\queue-name", msg ) ) {
    handleError();
}

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

由 QAnywhere 代理发送消息。

有关详细信息，请参见确定在客户端进行消息传输的时间和编写 QAnywhere 客户端应用程序。

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

使用DocCommentXchange 讨论此页。