Message class
Obiekt Message jest używany do telemetrii (urządzenie-chmura) i poleceń (chmura-urządzenie) asynchronicznych komunikatów między urządzeniem a usługą IoT Hub. Jest ona niezależna od transportu, co oznacza, że działa tak samo w przypadku protokołu AMQP, MQTT i HTTP.
Konstruktory
Message(Buffer |
Tworzy nowy Message obiekt |
Właściwości
ack | Typ żądanej opinii (w przypadku polecenia z chmury do urządzenia) |
content |
Kodowanie zawartości treści wiadomości. może mieć wartość "utf-8", "utf-16" lub "utf-32". |
content |
Właściwość typu zawartości używana do kierowania z treścią komunikatu. Powinna mieć wartość "application/json". |
correlation |
Używane w odpowiedziach komunikatów i opiniach |
data | |
expiry |
Czas wygaśnięcia w formacie UTC interpretowany przez centrum w komunikatach C2D. Ignorowane w innych przypadkach. |
interface |
Czy ten komunikat jest komunikatem zabezpieczającym |
lock |
Służy do porzucania, odrzucania lub akceptowania wiadomości |
message |
Służy do korelowania komunikacji dwukierunkowej. Format: ciąg uwzględniający wielkość liter (do 128 znaków długości) znaków alfanumerycznych ASCII 7-bitowych i następujące symbole specjalne: |
properties | Mapa zawierająca klucze ciągów i wartości do przechowywania niestandardowych właściwości komunikatów. |
to | Miejsce docelowe komunikatu. |
user |
Służy do określania jednostki tworzącej komunikat |
Metody
get |
Pobiera dane przekazane do konstruktora jako bufor |
get |
Pobiera zawartość (treść) obiektu Message. |
is |
Zwraca wartość true, jeśli dany obiekt ma typ BufferConvertible. Obiekty typu BufferConvertible można przekazać do konstruktora Komunikat . |
set |
Ustawia ten komunikat jako komunikat zabezpieczeń |
Szczegóły konstruktora
Message(BufferConvertible)
Tworzy nowy Message obiekt
new Message(data: BufferConvertible)
Parametry
- data
- BufferConvertible
obiekt buforu węzła lub dowolny element, który można przekazać do konstruktora buforu w celu skonstruowania buforu z.
Szczegóły właściwości
ack
Typ żądanej opinii (w przypadku polecenia z chmury do urządzenia)
ack: string
Wartość właściwości
string
contentEncoding
Kodowanie zawartości treści wiadomości. może mieć wartość "utf-8", "utf-16" lub "utf-32".
contentEncoding: undefined | "utf-8" | "utf-16" | "utf-32"
Wartość właściwości
undefined | "utf-8" | "utf-16" | "utf-32"
contentType
Właściwość typu zawartości używana do kierowania z treścią komunikatu. Powinna mieć wartość "application/json".
contentType: undefined | "application/json"
Wartość właściwości
undefined | "application/json"
correlationId
Używane w odpowiedziach komunikatów i opiniach
correlationId: string
Wartość właściwości
string
data
data: any
Wartość właściwości
any
expiryTimeUtc
Czas wygaśnięcia w formacie UTC interpretowany przez centrum w komunikatach C2D. Ignorowane w innych przypadkach.
expiryTimeUtc: any
Wartość właściwości
any
interfaceId
Czy ten komunikat jest komunikatem zabezpieczającym
interfaceId: string
Wartość właściwości
string
lockToken
Służy do porzucania, odrzucania lub akceptowania wiadomości
lockToken: string
Wartość właściwości
string
messageId
Służy do korelowania komunikacji dwukierunkowej. Format: ciąg uwzględniający wielkość liter (do 128 znaków długości) znaków alfanumerycznych ASCII 7-bitowych i następujące symbole specjalne:- : . + % _ # * ? ! ( ) , = @ ; $ '
.
messageId: string
Wartość właściwości
string
properties
Mapa zawierająca klucze ciągów i wartości do przechowywania niestandardowych właściwości komunikatów.
properties: Properties
Wartość właściwości
Properties
to
Miejsce docelowe komunikatu.
to: string
Wartość właściwości
string
userId
Służy do określania jednostki tworzącej komunikat
userId: string
Wartość właściwości
string
Szczegóły metody
getBytes()
getData()
Pobiera zawartość (treść) obiektu Message.
function getData(): BufferConvertible
Zwraca
Zawartość elementu Message.
isBufferConvertible(any)
Zwraca wartość true, jeśli dany obiekt ma typ BufferConvertible. Obiekty typu BufferConvertible można przekazać do konstruktora Komunikat .
static function isBufferConvertible(obj: any): boolean
Parametry
- obj
-
any
wystąpienie obiektu do sprawdzenia
Zwraca
boolean
Prawda, jeśli obiekt jest typu BufferConvertible
setAsSecurityMessage()
Ustawia ten komunikat jako komunikat zabezpieczeń
function setAsSecurityMessage()