nl::Weave::WeaveConnection

[只读] 对等节点的 IP 地址。

[只读] 对等方的节点标识符。

[只读] 对等节点的端口号。

[只读] 如果启用接收，则为 true，否则为 false。

如果通过此连接发送的所有消息都必须包含经过明确编码的目标节点标识符，则为 true，否则为 false。

如果通过此连接发送的所有邮件都必须包含已明确编码的源节点标识符，则为 true；否则为 false。

[只读] WeaveConnection 对象的状态。

对基于 TCP 或 BLE 的 WeaveConnection 执行优雅关闭，从而舍弃可能传入或传出对等端的所有数据。

调用 Abort() 会立即终止底层连接。在此之后，WeaveConnection 对象无法再用于进一步通信。

调用 Abort() 会减少与 WeaveConnection 对象相关联的引用计数，无论在调用该方法时是否连接处于打开/有效状态。如果这导致引用计数为零，则与连接对象关联的资源将会被释放。出现这种情况时，应用不得再与该对象进行交互。

预留对 WeaveConnection 对象的引用。

AddRef() 方法递增与 WeaveConnection 对象相关联的引用计数。每次调用 AddRef() 时，应用均需对 Release()、Close() 或 Abort() 进行相应的调用。

对基于 TCP 或 BLE 的 WeaveConnection 执行非阻塞安全关闭，并在礼让地通知远程主机我们已重置连接之前提供所有剩余的传出数据。

此方法不能保证远程对等端已收到所有未在应用协议级别确认的外发消息。对于 TCP 和 BLE，底层协议堆栈会尽最大努力，在重置连接之前传送任何待处理的传出数据。对于 TCP，如果在关闭连接之前需要传输层消息接收确认，则应在 Close() 之前使用 Shutdown()。BLE 连接不提供对应的 Shutdown()。

对于基于 BLE 的连接，Close() 会关闭 WeaveConnection 并立即返回，但可能会导致底层 BLEEndPoint 对象停留，直至所有传出数据均已发送。这是 Weave BleLayer 中现有的 Weave over BLE 传输协议实现的副作用。

调用 Close() 后，WeaveConnection 对象将无法再用于进一步通信。

调用 Close() 可减少与 WeaveConnection 对象相关联的引用计数，无论在调用该方法时是否处于“有效”/“有效”状态。如果这导致引用计数为零，则与连接对象关联的资源将会被释放。出现这种情况时，应用不得再与该对象进行交互。

对基于 TCP 或 BLE 的 WeaveConnection 执行非阻塞安全关闭，并在礼让地通知远程主机我们已重置连接之前提供所有剩余的传出数据。

此方法不能保证远程对等端已收到所有未在应用协议级别确认的外发消息。对于 TCP 和 BLE，底层协议堆栈会尽最大努力，在重置连接之前传送任何待处理的传出数据。对于 TCP，如果在关闭连接之前需要传输层消息接收确认，则应在 Close() 之前使用 Shutdown()。BLE 连接不提供对应的 Shutdown()。

对于基于 BLE 的连接，Close() 会关闭 WeaveConnection 并立即返回，但可能会导致底层 BLEEndPoint 对象停留，直至所有传出数据均已发送。这是 Weave BleLayer 中现有的 Weave over BLE 传输协议实现的副作用。

调用 Close() 后，WeaveConnection 对象将无法再用于进一步通信。

调用 Close() 可减少与 WeaveConnection 对象相关联的引用计数，无论在调用该方法时是否处于“有效”/“有效”状态。如果这导致引用计数为零，则与连接对象关联的资源将会被释放。出现这种情况时，应用不得再与该对象进行交互。

使用从指定节点标识符派生的结构 IP 地址连接到 Weave 节点。

使用节点标识符和/或 IP 地址连接到 Weave 节点。

在特定接口上使用节点标识符和/或 IP 地址连接到 Weave 节点。

使用节点标识符和/或字符串主机名连接到 Weave 节点。

如果提供，PeerAddr 可以是以下任何一项：

:

:

[]:

使用节点标识符和/或字符串对等地址连接到 Weave 节点。

如果提供，PeerAddr 可以是以下任何一项：

:

:

[]:

使用节点标识符和/或字符串对等地址连接到 Weave 节点。

如果提供，PeerAddr 可以是以下任何一项：

:

:

[]:

使用节点标识符和/或主机名和端口列表连接到 Weave 节点。

使用节点标识符和/或主机名和端口列表连接到 Weave 节点。

WeaveConnection::DisableKeepAlive。

对底层 TCP 连接停用 TCP keepalive 探测。

注意：此方法只能在由 TCP 连接支持的 Weave 连接上调用。只有当连接的状态允许发送时，才能调用此方法。

如果连接上未启用 keepalive，则此方法不会执行任何操作。

禁止通过此 WeaveConnection 接收邮件。

应用使用此方法表示它尚未准备好通过 TCP 连接接收任何到达数据。要重新启用接收功能，应用需要调用 EnableReceive()，以便通过调用适当的回调允许 WeaveConnection 移交所收到的数据。

WeaveConnection::EnableKeepAlive。

在底层 TCP 连接上启用 TCP keepalive 探测。

注意：此方法只能在由 TCP 连接支持的 Weave 连接上调用。- 只有当连接的状态允许发送时，才能调用此方法。

- 可多次调用该方法，以调整 keepalive 的时间间隔或超时计数。

启用通过此 WeaveConnection 接收的功能。

应用使用此方法向 WeaveConnection 对象指明它已准备好接收任何通过 TCP 连接到达的数据。

获取对等端的 IP 地址信息。

构造一个字符串，描述与连接关联的对等节点。

传入

bool IsIncoming(
  void
) const 

uint16_t LogId(
  void
) const 

void Release(
  void
)

WEAVE_ERROR ResetUserTimeout(
  void
)

WEAVE_ERROR SendMessage(
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

WEAVE_ERROR SendTunneledMessage(
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

void SetConnectTimeout(
  const uint32_t connTimeoutMsecs
)

WEAVE_ERROR SetIdleTimeout(
  uint32_t timeoutMS
)

void SetIncoming(
  bool val
)

WEAVE_ERROR SetUserTimeout(
  uint32_t userTimeoutMillis
)

WEAVE_ERROR Shutdown(
  void
)