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 地址信息。

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

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
)