Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

nl :: Tejido:: Perfiles: DataManagement_Current :: SuscripciónCliente

Resumen

Tipos públicos

@130 enumeración
EventCallback )(void *const aAppState, EventID aEvent, const InEventParam &aInParam, OutEventParam &aOutParam) typedef
void(*
Devolución de llamada para pasar eventos de suscripción a la aplicación.
EventID {
kEvent_OnSubscriptionTerminated = 1,
kEvent_OnExchangeStart = 2,
kEvent_OnSubscribeRequestPrepareNeeded = 3,
kEvent_OnSubscriptionEstablished = 4,
kEvent_OnNotificationRequest = 5,
kEvent_OnNotificationProcessed = 6,
kEvent_OnEventStreamReceived = 7,
kEvent_OnSubscriptionActivity = 8,
kEvent_OnUpdateComplete = 9,
kEvent_OnNoMorePendingUpdates = 10
}
enumeración
ResubscribePolicyCallback )(void *const aAppState, ResubscribeParam &aInParam, uint32_t &aOutIntervalMsec) typedef
void(*
Devolución de llamada para obtener el intervalo de tiempo de espera antes de la próxima nueva suscripción.

Funciones estáticas públicas

DefaultEventHandler ( EventID aEvent, const InEventParam & aInParam, OutEventParam & aOutParam)
void
DefaultResubscribePolicyCallback (void *const aAppState, ResubscribeParam & aInParam, uint32_t & aOutIntervalMsec)
void
La implementación de la política predeterminada elegirá un intervalo de tiempo aleatorio con una resolución de milisegundos en una ventana cada vez mayor, siguiendo una secuencia de fibonacci hasta WDM_RESUBSCRIBE_MAX_FIBONACCI_STEP_INDEX.

Funciones publicas

AbortSubscription (void)
void
Cancelar la suscripción.
ClearUpdated ( TraitUpdatableDataSink *aDataSink, PropertyPathHandle aPropertyHandle)
DisableResubscribe (void)
void
Desactive el mecanismo de resuscripción.
DiscardUpdates ()
void
Le dice a SubscriptionClient que vacíe el conjunto de TraitPaths pendiente de actualización y anule la solicitud de actualización que está en progreso, si la hubiera.
EnableResubscribe ( ResubscribePolicyCallback aCallback)
void
Habilite las resuscripciones automáticas.
EndSubscription (void)
Finalice la suscripción.
FlushUpdate ()
Señala que la aplicación ha terminado de mutar todos los TraitUpdatableDataSinks.
FlushUpdate (bool aForce)
Free (void)
void
Libere este objeto SubscriptionClient .
GetBinding (void) const
GetLivenessTimeoutMsec (void) const
uint32_t
GetPeerNodeId (void) const
uint64_t
GetSubscriptionId (uint64_t *const apSubscriptionId)
IndicateActivity (void)
void
InitiateCounterSubscription (const uint32_t aLivenessTimeoutSec)
void
InitiateSubscription (void)
void
Configure SubscriptionClient como iniciador (en lugar de contra-suscriptor) y active la suscripción si no lo es.
IsCanceling () const
bool
IsEstablished ()
bool
IsEstablishedIdle ()
bool
IsFree ()
bool
IsInProgressOrEstablished ()
bool
IsInResubscribeHoldoff ()
bool
IsRetryEnabled ()
bool
IsTerminated ()
bool
IsUpdatePendingOrInProgress ()
bool
LockUpdateMutex (void)
void
OnCatalogChanged ()
void
Se debe llamar a este método cuando se haya modificado el catálogo TraitDataSink .
ResetResubscribe (void)
void
Activa el mecanismo de resuscripción.
SetLivenessTimeoutMsec (uint32_t val)
void
SetUpdated ( TraitUpdatableDataSink *aDataSink, PropertyPathHandle aPropertyHandle, bool aIsConditional)
SuspendUpdateRetries ()
void
Le dice al SubscriptionClient que deje de reintentar las solicitudes de actualización.
UnlockUpdateMutex (void)
void

Estructuras

nl :: Weave :: Profiles :: DataManagement_Current :: SubscriptionClient :: LastObservedEvent
nl :: Weave :: Perfiles :: DataManagement_Current :: SubscriptionClient :: ResubscribeParam

Sindicatos

nl :: Weave :: Perfiles :: DataManagement_Current :: SubscriptionClient :: InEventParam
nl :: Weave :: Profiles :: DataManagement_Current :: SubscriptionClient :: OutEventParam

Tipos públicos

@ 130

 @130

EventCallback

void(* EventCallback)(void *const aAppState, EventID aEvent, const InEventParam &aInParam, OutEventParam &aOutParam)

Devolución de llamada para pasar eventos de suscripción a la aplicación.

Detalles
Parámetros
[in] aAppState
Puntero de estado de la aplicación establecido durante la inicialización de SubscriptionClient .
[in] aEvent
Indica qué evento está sucediendo
[in] aInParam
Estructura con detalles adicionales sobre el evento
[out] aOutParam
Información transmitida por la aplicación

EventID

 EventID
Propiedades
kEvent_OnEventStreamReceived

Se genera cuando SubscriptionEngine encuentra un flujo de eventos dentro del mensaje NotificationRequest.

La aplicación puede llamar a EndSubscription () , AbortSubscription () o Free () en este momento.

kEvent_OnExchangeStart

Se genera después de que se ha preparado el enlace y se ha configurado ExchangeContext , pero antes de que se envíen los mensajes.

Esta es la última oportunidad para que una aplicación ajuste la configuración de ExchangeContext , mEC es válido y se puede ajustar para la configuración de tiempo de espera. La aplicación no debe tocar otros campos en el cliente y no debe cerrar ExchangeContext .

kEvent_OnNoMorePendingUpdates

Un evento que indica que todas las rutas del conjunto de actualización han sido procesadas por el par y que no es necesario actualizar más rutas.

kEvent_OnNotificationProcessed

Se genera cuando SubscriptionEngine termina de enviar un mensaje NotificationRequest.

La aplicación puede llamar a EndSubscription () , AbortSubscription () o Free () en este momento.

kEvent_OnNotificationRequest

Generado al recibir una NotificationRequest.

La aplicación puede llamar a EndSubscription () , AbortSubscription () o Free () en este punto.

kEvent_OnSubscribeRequestPrepareNeeded

Se envía cuando el motor está listo para enviar SubscribeRequest.

Se espera que la aplicación complete las rutas a las que desea suscribirse.

kEvent_OnSubscriptionActivity

Un evento que indica actividad de suscripción.

Se genera siempre que el cliente recibe una indicación sobre la actividad de suscripción; esto incluye el establecimiento satisfactorio de la suscripción, la recepción de una NotificationRequest o la recepción de un informe de estado en respuesta al mensaje SubscribeConfirm.

kEvent_OnSubscriptionEstablished

Generado tras el establecimiento exitoso de la suscripción.

La aplicación puede llamar a EndSubscription () , AbortSubscription () o Free () en este momento.

kEvent_OnSubscriptionTerminated

Marca el final de esta suscripción.

Los parámetros enviados a nl :: Weave :: Profiles :: DataManagement_Current :: SubscriptionClient :: EventCallback indicarán si se intentará una nueva suscripción automáticamente.

Durante la llamada controlador de eventos, será el estado del cliente Terminated . Si no se intentará ningún reintento, el estado del cliente pasará a Initialized cuando regrese el controlador de eventos. De lo contrario, el estado pasará a ResubscribeHoldoff y se intentará restablecer la suscripción después del tiempo de espera.

La aplicación puede llamar a AbortSubscription () o Free () en este estado.

Los parámetros enviados también incluirán un código de error que indicará el motivo de la finalización de la suscripción.

La suscripción podría haber sido cancelada por varias razones (falta WRM ACK, falla de asignación de ExchangeContext , tiempo de espera de respuesta, ...) Algunos posibles códigos de error generados por el cliente:

Código de error Significado
WEAVE_ERROR_INVALID_MESSAGE_TYPE Se recibe un mensaje no reconocido.
WEAVE_ERROR_TIMEOUT No se recibe un acuse de recibo o falla una verificación de actividad.
WEAVE_ERROR_INCORRECT_STATE Los mensajes se reciben en un estado inesperado.
WEAVE_ERROR_STATUS_REPORT_RECEIVED Se recibe un informe de estado.
WEAVE_ERROR_INVALID_ARGUMENT Los campos de solicitud de suscripción no son válidos.

kEvent_OnUpdateComplete

Un evento que denota la finalización de la actualización.

Los parámetros del evento indicarán si la actualización de una ruta de rasgo específica se ha realizado correctamente o no.

Volver a suscribirse Política de devolución de llamada

void(* ResubscribePolicyCallback)(void *const aAppState, ResubscribeParam &aInParam, uint32_t &aOutIntervalMsec)

Devolución de llamada para obtener el intervalo de tiempo de espera antes de la próxima nueva suscripción.

Las aplicaciones pueden abortar / liberarse en esta función si han decidido renunciar a volver a suscribirse.

Detalles
Parámetros
[in] aAppState
Puntero de estado de la aplicación establecido durante la inicialización de SubscriptionClient .
[in] aInParam
Estructura con detalles adicionales sobre el reintento
[out] aOutIntervalMsec
Tiempo en milisegundos para esperar antes del próximo reintento

Funciones estáticas públicas

DefaultEventHandler

void DefaultEventHandler(
  EventID aEvent,
  const InEventParam & aInParam,
  OutEventParam & aOutParam
)

DefaultResubscribePolicyCallback

void DefaultResubscribePolicyCallback(
  void *const aAppState,
  ResubscribeParam & aInParam,
  uint32_t & aOutIntervalMsec
)

La implementación de la política predeterminada elegirá un intervalo de tiempo aleatorio con una resolución de milisegundos en una ventana cada vez mayor, siguiendo una secuencia de fibonacci hasta WDM_RESUBSCRIBE_MAX_FIBONACCI_STEP_INDEX.

El promedio del tiempo de espera aleatorio después de WDM_RESUBSCRIBE_MAX_FIBONACCI_STEP_INDEX será de alrededor de una hora. Cuando el recuento de reintentos se restablece a 0, la secuencia comienza de nuevo desde el principio.

Funciones publicas

AbortSubscription

void AbortSubscription(
  void
)

Cancelar la suscripción.

Cancelar una suscripción de cliente.

Deje de aceptar inmediatamente todo el tráfico asociado con la suscripción y libere todos los recursos de comunicación subyacentes. El objeto SubscriptionClient sigue siendo válido y puede volver a utilizarse.

Termina el final del cliente de una suscripción, sin notificar al editor de la suscripción y sin entregar un evento OnSubscriptionTerminated al OnSubscriptionTerminated eventos de la aplicación. Si existe una suscripción mutua, la suscripción de contador también se cancela.

Al llamar a AbortSubscription () , el objeto SubscriptionClient entra en el estado Terminated . Una vez que se completa el proceso de terminación, el objeto entra en el estado Initialized . Ambas transiciones ocurren sincrónicamente dentro de la llamada a AbortSubscription () .

Después de que regrese AbortSubscription () , el objeto SubscriptionClient puede usarse para iniciar otra suscripción, o puede liberarse llamando al método Free () .

ClearUpdated

WEAVE_ERROR ClearUpdated(
  TraitUpdatableDataSink *aDataSink,
  PropertyPathHandle aPropertyHandle
)

DisableResubscribe

void DisableResubscribe(
  void
)

Desactive el mecanismo de resuscripción.

Esto se cancelará si hay una nueva suscripción pendiente.

DescartarActualizaciones

void DiscardUpdates()

Le dice a SubscriptionClient que vacíe el conjunto de TraitPaths pendiente de actualización y anule la solicitud de actualización que está en progreso, si la hubiera.

Este método se puede invocar desde cualquier devolución de llamada.

EnableResubscribe

void EnableResubscribe(
  ResubscribePolicyCallback aCallback
)

Habilite las resuscripciones automáticas.

Adjunte una devolución de llamada para especificar la próxima hora de reintento en caso de error.

Detalles
Parámetros
[in] aCallback
Devolución de llamada opcional para obtener la cantidad de tiempo de espera antes de volver a intentarlo después de una falla. Si es NULL, use una política predeterminada.

EndSubscription

WEAVE_ERROR EndSubscription(
  void
)

Finalice la suscripción.

Finalice correctamente una suscripción de cliente.

Cuando la opción de tiempo de compilación WDM_ENABLE_SUBSCRIPTION_CANCEL está habilitada, finalice correctamente la suscripción enviando una CancelRequest al par. Los recursos asociados con la suscripción se liberan con la respuesta del par o en el tiempo de espera. Cuando la opción está deshabilitada, la llamada es equivalente a AbortSubscription () .

Termina de forma ordenada la finalización del cliente de una suscripción. Si el soporte para cancelar la suscripción está habilitado, se envía un mensaje SubscribeCancelRequest al editor de la suscripción y el sistema espera una respuesta antes de finalizar la suscripción; de lo contrario, la suscripción se cancela inmediatamente de manera similar a AbortSubscription () . Si existe una suscripción mutua, la suscripción de contador también se cancela.

Mientras espera una respuesta a una SubscribeCancelRequest, SubscriptionClient entra en el estado de Canceling .

Una vez que comienza el proceso de terminación, el objeto SubscriptionClient entra en el estado Terminated y se entrega un evento OnSubscriptionTerminated al controlador de eventos de la aplicación. Tenga en cuenta que, si el soporte para cancelar no está habilitado, el controlador de eventos se puede llamar sincrónicamente dentro de la llamada a EndSubscription () .

Una vez que regresa el controlador de eventos de la aplicación, el objeto SubscriptionClient entra en el estado Initialized . En este punto, el objeto SubscriptionClient puede usarse para iniciar otra suscripción, o puede liberarse llamando al método Free () .

FlushUpdate

WEAVE_ERROR FlushUpdate()

Señala que la aplicación ha terminado de mutar todos los TraitUpdatableDataSinks.

A menos que haya un intercambio de actualización anterior en curso, el cliente tomará todos los datos marcados como actualizados y los enviará al respondedor en una solicitud de actualización. Este método se puede llamar desde cualquier hilo.

Detalles
Parámetros
[in] aForce
Si es verdadero, hace que la actualización se envíe inmediatamente incluso si se ha programado un reintento en el futuro. Este parámetro se considera falso de forma predeterminada.
Devoluciones
WEAVE_NO_ERROR en caso de éxito; otros códigos WEAVE_ERROR en caso de falla.

FlushUpdate

WEAVE_ERROR FlushUpdate(
  bool aForce
)

Libre

void Free(
  void
)

Libere este objeto SubscriptionClient .

Libera un objeto SubscriptionClient .

Llama a AbortSubscription () si es necesario y libera el refcount en este objeto SubscriptionClient . Con un uso correcto, esto debería permitir que el objeto se devuelva al grupo de objetos

Libera el objeto SubscriptionClient . Si una suscripción está activa o en curso, la suscripción se cancela inmediatamente de manera similar a llamar a AbortSubscription () . Si hay solicitudes de actualización en curso, se anulan de forma similar.

La aplicación es responsable de llamar a Free () exactamente una vez durante la vida útil de un objeto SubscriptionClient . Después de llamar a Free () , no se deben hacer más referencias al objeto.

GetBinding

Binding * GetBinding(
  void
) const 

GetLivenessTimeoutMsec

uint32_t GetLivenessTimeoutMsec(
  void
) const 

GetPeerNodeId

uint64_t GetPeerNodeId(
  void
) const 

GetSubscriptionId

WEAVE_ERROR GetSubscriptionId(
  uint64_t *const apSubscriptionId
)

Indicar Actividad

void IndicateActivity(
  void
)

InitiateCounterSubscription

void InitiateCounterSubscription(
  const uint32_t aLivenessTimeoutSec
)

Iniciar suscripción

void InitiateSubscription(
  void
)

Configure SubscriptionClient como iniciador (en lugar de contra-suscriptor) y active la suscripción si no lo es.

Está cancelando

bool IsCanceling() const 

Está establecido

bool IsEstablished()

Está Establecido Inactivo

bool IsEstablishedIdle()

Está libre

bool IsFree()

IsInProgressOrEstablished

bool IsInProgressOrEstablished()

IsInResubscribeHoldoff

bool IsInResubscribeHoldoff()

IsRetryEnabled

bool IsRetryEnabled()

Esta terminado

bool IsTerminated()

IsUpdatePendingOrInProgress

bool IsUpdatePendingOrInProgress()

LockUpdateMutex

void LockUpdateMutex(
  void
)

OnCatalogChanged

void OnCatalogChanged()

Se debe llamar a este método cuando se haya modificado el catálogo TraitDataSink .

Restablecer

void ResetResubscribe(
  void
)

Activa el mecanismo de resuscripción.

Esto iniciará un reintento inmediato.

SetLivenessTimeoutMsec

void SetLivenessTimeoutMsec(
  uint32_t val
)

SetUpdated

WEAVE_ERROR SetUpdated(
  TraitUpdatableDataSink *aDataSink,
  PropertyPathHandle aPropertyHandle,
  bool aIsConditional
)

SuspendUpdateRetries

void SuspendUpdateRetries()

Le dice al SubscriptionClient que deje de reintentar las solicitudes de actualización.

Permite que la aplicación suspenda las actualizaciones durante un período de tiempo sin descartar todos los metadatos. Las actualizaciones y reintentos se reanudarán cuando se llame a FlushUpdate. Cuando se llama para suspender actualizaciones mientras hay una actualización en curso, la actualización no se cancela, pero en caso de que falle, no se volverá a intentar hasta que se vuelva a llamar a FlushUpdate.

DesbloquearActualizarMutex

void UnlockUpdateMutex(
  void
)