Message class
Objekt se Message používá pro telemetrii (zařízení-cloud) a příkazy (cloud-zařízení) a asynchronní zasílání zpráv mezi zařízením a službou IoT Hub. Je nezávislá na přenosu, což znamená, že funguje stejným způsobem jako AMQP, MQTT a HTTP.
Konstruktory
Message(Buffer |
Vytvoří nový Message objekt. |
Vlastnosti
ack | Typ požadované zpětné vazby (v případě příkazu typu cloud-zařízení) |
content |
Kódování obsahu textu zprávy. může být utf-8, utf-16 nebo utf-32. |
content |
Vlastnost typu obsahu používaná ke směrování s textem zprávy. Měla by být application/json. |
correlation |
Používá se v odpovědích na zprávy a zpětné vazbě |
data | |
expiry |
Čas vypršení platnosti ve standardu UTC interpretovaný centrem u zpráv C2D. V jiných případech se ignoruje. |
interface |
Je tato zpráva zprávou zabezpečení? |
lock |
Používá se k opuštění, odmítnutí nebo přijetí zprávy. |
message |
Používá se ke korelaci obousměrné komunikace. Formát: Řetězec 7bitových alfanumerických znaků ASCII rozlišující velká a malá písmena (až 128 znaků) a následující speciální symboly: |
properties | Mapování obsahující klíče řetězců a hodnoty pro ukládání vlastních vlastností zprávy. |
to | Cíl zprávy. |
user |
Slouží k určení entity vytvářející zprávu. |
Metody
get |
Získá data předaná konstruktoru jako vyrovnávací paměť. |
get |
Získá obsah (tělo) objektu Message. |
is |
Vrátí hodnotu true, pokud je daný objekt typu BufferConvertible. Objekty typu BufferConvertible lze předat do konstruktoru Message . |
set |
Nastaví tuto zprávu jako zprávu zabezpečení. |
Podrobnosti konstruktoru
Message(BufferConvertible)
Vytvoří nový Message objekt.
new Message(data: BufferConvertible)
Parametry
- data
- BufferConvertible
Objekt vyrovnávací paměti uzlu nebo cokoli jiného, co lze předat do konstruktoru vyrovnávací paměti pro vytvoření vyrovnávací paměti z.
Podrobnosti vlastnosti
ack
Typ požadované zpětné vazby (v případě příkazu typu cloud-zařízení)
ack: string
Hodnota vlastnosti
string
contentEncoding
Kódování obsahu textu zprávy. může být utf-8, utf-16 nebo utf-32.
contentEncoding: undefined | "utf-8" | "utf-16" | "utf-32"
Hodnota vlastnosti
undefined | "utf-8" | "utf-16" | "utf-32"
contentType
Vlastnost typu obsahu používaná ke směrování s textem zprávy. Měla by být application/json.
contentType: undefined | "application/json"
Hodnota vlastnosti
undefined | "application/json"
correlationId
Používá se v odpovědích na zprávy a zpětné vazbě
correlationId: string
Hodnota vlastnosti
string
data
data: any
Hodnota vlastnosti
any
expiryTimeUtc
Čas vypršení platnosti ve standardu UTC interpretovaný centrem u zpráv C2D. V jiných případech se ignoruje.
expiryTimeUtc: any
Hodnota vlastnosti
any
interfaceId
Je tato zpráva zprávou zabezpečení?
interfaceId: string
Hodnota vlastnosti
string
lockToken
Používá se k opuštění, odmítnutí nebo přijetí zprávy.
lockToken: string
Hodnota vlastnosti
string
messageId
Používá se ke korelaci obousměrné komunikace. Formát: Řetězec 7bitových alfanumerických znaků ASCII rozlišující velká a malá písmena (až 128 znaků) a následující speciální symboly:- : . + % _ # * ? ! ( ) , = @ ; $ '
.
messageId: string
Hodnota vlastnosti
string
properties
Mapování obsahující klíče řetězců a hodnoty pro ukládání vlastních vlastností zprávy.
properties: Properties
Hodnota vlastnosti
Properties
to
Cíl zprávy.
to: string
Hodnota vlastnosti
string
userId
Slouží k určení entity vytvářející zprávu.
userId: string
Hodnota vlastnosti
string
Podrobnosti metody
getBytes()
getData()
Získá obsah (tělo) objektu Message.
function getData(): BufferConvertible
Návraty
Obsah souboru Message.
isBufferConvertible(any)
Vrátí hodnotu true, pokud je daný objekt typu BufferConvertible. Objekty typu BufferConvertible lze předat do konstruktoru Message .
static function isBufferConvertible(obj: any): boolean
Parametry
- obj
-
any
instance objektu ke kontrole
Návraty
boolean
True, pokud je objekt typu BufferConvertible
setAsSecurityMessage()
Nastaví tuto zprávu jako zprávu zabezpečení.
function setAsSecurityMessage()