nl::Weave::Profiles::DataManagement_Current::Command

Riepilogo

Nota: questa classe è progettata per nascondere un determinato dettaglio nella gestione dei comandi. È stata presa la decisione di nascondere i dettagli di ExchangeContext e della convalida dell'autenticatore, lasciando la gestione di PacketBuffers al livello dell'applicazione. L’utilità di questo wrapper per la gestione dei comandi è effettivamente limitata, principalmente a causa della complessità/flessibilità coinvolti nella convalida della sicurezza e nella serializzazione/deserializzazione dei dati.

I dettagli per la convalida dei comandi sono ancora da definire

Per regolare i tempi della ritrasmissione per il messaggio In corso, il report sullo stato e anche il messaggio di risposta, il livello di applicazione deve in qualche modo gestire l'oggetto ExchangeContext. La best practice è ancora da definire, ma il livello di applicazione prevede tre opzioni:

1) Acquisisci contesto di scambio tramite GetExchangeContext e valutalo/modificalo direttamente. 2) Pre-alloca e configura un Binding durante l'avvio, prima che arrivi qualsiasi comando, e configuralo correttamente 3) Crea un Binding temporaneo utilizzando questa funzione BindingPool::NewResponderBindingFromExchangeContext

In entrambi i casi (2) e (3), il livello dell'applicazione può applicare l'impostazione di sicurezza/temporanea tramite Binding::ConfiguraExampleExchangeContext. L'elemento Binding non viene mai utilizzato per generare nuovi contesti di scambio per i comandi personalizzati, quindi non deve essere archiviato all'interno di questo handle.

Anche il buffer dei pacchetti della richiesta non è archiviato all'interno di questo handle, poiché non è evidente che non è utilizzato. Ciò è particolarmente vero se il livello dell'applicazione può gestire questo comando e inviare direttamente la risposta.

Il livello dell'applicazione riceverebbe il buffer dei pacchetti dallo stesso callback a cui riceve questo handle. Se decidesse di gestire questo comando in modo asincrono, dovrà archiviare sia l'handle di comando sia il buffer dei pacchetti.

Tipi pubblici

 CommandFlags

enum nl::Weave::Profiles::DataManagement_Current::Command::CommandFlags CommandFlags

Attributi pubblici

int64_t actionTimeMicroSecond

uint64_t commandType

int64_t expiryTimeMicroSecond

int64_t initiationTimeMicroSecond

uint64_t mustBeVersion

void Close(
  void
)

nl::Weave::ExchangeContext * GetExchangeContext(
  void
) const 

bool IsActionTimeValid(
  void
) const 

bool IsExpiryTimeValid(
  void
) const 

bool IsInitiationTimeValid(
  void
) const 

bool IsMustBeVersionValid(
  void
) const 

bool IsOneWay(
  void
) const 

WEAVE_ERROR SendError(
  uint32_t aProfileId,
  uint16_t aStatusCode,
  WEAVE_ERROR aWeaveError
)

WEAVE_ERROR SendInProgress(
  void
)

WEAVE_ERROR SendResponse(
  uint32_t traitInstanceVersion,
  nl::Weave::System::PacketBuffer *apPayload
)

WEAVE_ERROR ValidateAuthenticator(
  nl::Weave::System::PacketBuffer *aRequestBuffer
)