nl::Weave::WeaveConnection

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

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

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

[READ ONLY] 如果启用了接收功能，则为 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 地址信息。

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

IsIncoming

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
)