Message class

Pacote:

azure-iot-device

O objeto Message é usado para telemetria (dispositivo para nuvem) e comandos (nuvem para dispositivo) mensagens assíncronas entre o dispositivo e o serviço do Hub IoT. Ele é independente de transporte, o que significa que funciona da mesma maneira em AMQP, MQTT e HTTP.

Construtores

Message(BufferConvertible)

Cria um novo Message objeto

Propriedades

ack	Tipo de feedback solicitado (no caso de comando da nuvem para o dispositivo)
contentEncoding	Codificação de conteúdo do corpo da mensagem. Pode ser 'UTF-8', 'UTF-16' ou 'UTF-32'.
contentType	Propriedade de tipo de conteúdo usada para rotas com o corpo da mensagem. Deve ser 'application/json'.
correlationId	Usado em respostas e comentários de mensagens
data
expiryTimeUtc	Tempo de expiração em UTC interpretado pelo hub em mensagens C2D. Ignorado em outros casos.
interfaceId	Esta mensagem é uma mensagem de segurança
lockToken	Usado para abandonar, rejeitar ou aceitar a mensagem
messageId	Usado para correlacionar a comunicação bidirecional. Formato: uma cadeia de caracteres que diferencia maiúsculas de minúsculas (até 128 caracteres) de caracteres alfanuméricos ASCII de 7 bits e os seguintes símbolos especiais: - : . + % _ # * ? ! ( ) , = @ ; $ '.
properties	Um mapa contendo chaves de cadeia de caracteres e valores para armazenar propriedades de mensagens personalizadas.
to	Destino da mensagem.
userId	Usado para especificar a entidade que está criando a mensagem

Métodos

getBytes()	Obtém os dados passados para o construtor como um Buffer
getData()	Obtém o conteúdo (corpo) do Message.
isBufferConvertible(any)	Retorna true se o objeto fornecido for do tipo BufferConvertible. Objetos do tipo BufferConvertible podem ser passados para o construtor Message .
setAsSecurityMessage()	Define esta mensagem como uma mensagem de segurança

Detalhes do construtor

Message(BufferConvertible)

Cria um novo Message objeto

new Message(data: BufferConvertible)

Parâmetros

data

BufferConvertible

um objeto Node Buffer ou qualquer coisa que possa ser passada para o construtor Buffer para construir um Buffer .

Detalhes da propriedade

ack

Tipo de feedback solicitado (no caso de comando da nuvem para o dispositivo)

ack: string

Valor da propriedade

string

contentEncoding

Codificação de conteúdo do corpo da mensagem. Pode ser 'UTF-8', 'UTF-16' ou 'UTF-32'.

contentEncoding: undefined | "utf-8" | "utf-16" | "utf-32"

Valor da propriedade

undefined | "utf-8" | "utf-16" | "utf-32"

contentType

Propriedade de tipo de conteúdo usada para rotas com o corpo da mensagem. Deve ser 'application/json'.

contentType: undefined | "application/json"

Valor da propriedade

undefined | "application/json"

correlationId

Usado em respostas e comentários de mensagens

correlationId: string

Valor da propriedade

string

data

data: any

Valor da propriedade

any

expiryTimeUtc

Tempo de expiração em UTC interpretado pelo hub em mensagens C2D. Ignorado em outros casos.

expiryTimeUtc: any

Valor da propriedade

any

interfaceId

Esta mensagem é uma mensagem de segurança

interfaceId: string

Valor da propriedade

string

lockToken

Usado para abandonar, rejeitar ou aceitar a mensagem

lockToken: string

Valor da propriedade

string

messageId

Usado para correlacionar a comunicação bidirecional. Formato: uma cadeia de caracteres que diferencia maiúsculas de minúsculas (até 128 caracteres) de caracteres alfanuméricos ASCII de 7 bits e os seguintes símbolos especiais:
- : . + % _ # * ? ! ( ) , = @ ; $ '.

messageId: string

Valor da propriedade

string

properties

Um mapa contendo chaves de cadeia de caracteres e valores para armazenar propriedades de mensagens personalizadas.

properties: Properties

Valor da propriedade

Properties

to

Destino da mensagem.

to: string

Valor da propriedade

string

userId

Usado para especificar a entidade que está criando a mensagem

userId: string

Valor da propriedade

string

Detalhes do método

getBytes()

Obtém os dados passados para o construtor como um Buffer

function getBytes(): Buffer

Retornos

Buffer

getData()

Obtém o conteúdo (corpo) do Message.

function getData(): BufferConvertible

Retornos

BufferConvertible

O conteúdo do Messagearquivo .

isBufferConvertible(any)

Retorna true se o objeto fornecido for do tipo BufferConvertible. Objetos do tipo BufferConvertible podem ser passados para o construtor Message .

static function isBufferConvertible(obj: any): boolean

Parâmetros

obj

any

instância do objeto a ser verificada

Retornos

boolean

True se o objeto for do tipo BufferConvertible

setAsSecurityMessage()

Define esta mensagem como uma mensagem de segurança

function setAsSecurityMessage()