이 페이지는 Cloud Translation API를 통해 번역되었습니다.

nl::매트::WeaveMessageLayer

#include <src/lib/core/WeaveMessageLayer.h>

다른 Weave 노드와의 통신을 관리하는 WeaveMessageLayer 클래스의 정의입니다.

요약

여러 InetLayer 엔드포인트 중 하나를 사용하여 다른 Weave 노드와 통신 채널을 설정합니다.

생성자 및 소멸자
`WeaveMessageLayer(void)` Weave 메시지 레이어 생성자

공개 유형
`AcceptErrorFunct)(WeaveMessageLayer *msgLayer, WEAVE_ERROR err)`	typedef `void(*` 이 함수는 수신 TCP 연결을 처리하는 동안 오류를 보고하는 상위 레이어 콜백입니다.
`CallbackRemovedFunct)(void *listenerState)`	typedef `void(*` 이 함수는 콜백을 삭제하기 위해 호출됩니다.
`ConnectionReceiveFunct)(WeaveMessageLayer msgLayer, WeaveConnection con)`	typedef `void(*` 이 함수는 수신 TCP 연결을 처리하기 위한 상위 계층 콜백입니다.
`MessageLayerActivityChangeHandlerFunct)(bool messageLayerIsActive)`	typedef `void(*` 이 함수는 메시지 레이어 활동 변경사항을 보고하는 애플리케이션 콜백입니다.
`MessageReceiveFunct)(WeaveMessageLayer msgLayer, WeaveMessageInfo msgInfo, PacketBuffer *payload)`	typedef `void(*` 이 함수는 UDP를 통해 Weave 메시지를 수신할 때 호출되는 상위 레이어 콜백입니다.
`ReceiveErrorFunct)(WeaveMessageLayer msgLayer, WEAVE_ERROR err, const IPPacketInfo pktInfo)`	typedef `void(*` 이 함수는 오류가 발생할 때 호출되는 상위 계층 콜백입니다.
`State{ kState_NotInitialized = 0, kState_Initializing = 1, kState_Initialized = 2 }`	enum WeaveMessageLayer의 상태입니다.
`TunneledMsgReceiveFunct)(WeaveMessageLayer msgLayer, PacketBuffer payload)`	typedef `void(*` 이 함수는 로컬 UDP 터널을 통해 터널링된 패킷을 수신하면 호출되는 상위 레이어 콜백입니다.

공개 속성
`AppState`	`void *` 애플리케이션별 상태 객체에 대한 포인터입니다.
`ExchangeMgr`	`WeaveExchangeManager *` [읽기 전용] 연결된 WeaveExchangeManager 객체입니다.
`FabricState`	`WeaveFabricState *` [읽기 전용] 연결된 WeaveFabricState 객체입니다.
`IncomingConIdleTimeout`	`uint32_t` 수신 연결에 대한 기본 유휴 제한 시간 (밀리초)입니다.
`Inet`	`InetLayer *` [읽기 전용] 연결된 InetLayer 객체입니다.
`IsListening`	`bool` [읽기 전용] 수신 연결/메시지를 수신 대기하는 경우 true, 그렇지 않은 경우 false
`OnAcceptError`	`AcceptErrorFunct`
`OnConnectionReceived`	`ConnectionReceiveFunct`
`OnMessageReceived`	`MessageReceiveFunct`
`OnReceiveError`	`ReceiveErrorFunct`
`OnUDPTunneledMessageReceived`	`TunneledMsgReceiveFunct`
`SecurityMgr`	`WeaveSecurityManager *` [읽기 전용] 연결된 WeaveSecurityManager 객체입니다.
`State`	`uint8_t` [읽기 전용] WeaveMessageLayer 객체의 상태입니다.
`SystemLayer`	`System::Layer *`
`mDropMessage`	`bool` 내부 및 디버그 전용입니다. 설정되면 WeaveMessageLayer는 메시지를 삭제하고 반환합니다.

공개 함수
`ClearUnsecuredConnectionListener(ConnectionReceiveFunct oldOnUnsecuredConnectionReceived, CallbackRemovedFunct newOnUnsecuredConnectionCallbacksRemoved)`	`WEAVE_ERROR`
`CloseEndpoints(void)`	`WEAVE_ERROR` 열려 있는 TCP 및 UDP 엔드포인트를 모두 닫습니다.
`CreateTunnel(WeaveConnectionTunnel **tunPtr, WeaveConnection & conOne, WeaveConnection & conTwo, uint32_t inactivityTimeoutMS)`	`WEAVE_ERROR` 지정된 두 WeaveConnection을 결합하여 WeaveConnectionTunnel을 만듭니다.
`DecodeHeader(PacketBuffer msgBuf, WeaveMessageInfo msgInfo, uint8_t **payloadStart)`	`WEAVE_ERROR` 수신된 Weave 메시지에서 Weave 메시지 레이어 헤더를 디코딩합니다.
`EncodeMessage(WeaveMessageInfo msgInfo, PacketBuffer msgBuf, WeaveConnection *con, uint16_t maxLen, uint16_t reserve)`	`WEAVE_ERROR` WeaveMessageLayer 헤더를 PacketBuffer에 인코딩합니다.
`EncodeMessage(const IPAddress & destAddr, uint16_t destPort, InterfaceId sendIntId, WeaveMessageInfo msgInfo, PacketBuffer payload)`	`WEAVE_ERROR` Weave 메시지 레이어 헤더를 PacketBuffer에 인코딩합니다.
`EphemeralUDPPortEnabled(void) const`	`bool` 로컬로 시작된 Weave UDP 교환이 임시 UDP 소스 포트에서 전송되어야 하는지 확인합니다.
`GetConnectionPoolStats(nl::Weave::System::Stats::count_t & aOutInUse) const`	`void` 사용 중인 WeaveConnections 수와 풀 크기를 가져옵니다.
`IPv4ListenEnabled(void) const`	`bool` IPv4를 통한 인바운드 통신을 수신 대기하도록 WeaveMessageLayer가 구성되었는지 확인합니다.
`IPv6ListenEnabled(void) const`	`bool` IPv4를 통한 인바운드 통신을 수신 대기하도록 WeaveMessageLayer가 구성되었는지 확인합니다.
`Init(InitContext *context)`	`WEAVE_ERROR` Weave 메시지 레이어 객체를 초기화합니다.
`IsBoundToLocalIPv4Address(void) const`	`bool` WeaveMessageLayer가 로컬 IPv4 주소에 바인딩되는지 확인합니다.
`IsBoundToLocalIPv6Address(void) const`	`bool` WeaveMessageLayer가 로컬 IPv6 주소에 바인딩되어 있는지 확인합니다.
`IsMessageLayerActive(void)`	`bool`
`NewConnection(void)`	`WeaveConnection *` 풀에서 새 WeaveConnection 객체를 만듭니다.
`NewConnectionTunnel(void)`	`WeaveConnectionTunnel *` 풀에서 새 WeaveConnectionTunnel 객체를 만듭니다.
`ReEncodeMessage(PacketBuffer *buf)`	`WEAVE_ERROR`
`RefreshEndpoints(void)`	`WEAVE_ERROR` 시스템 네트워크 인터페이스의 현재 상태를 기반으로 InetLayer 엔드포인트를 새로고침합니다.
`ResendMessage(WeaveMessageInfo msgInfo, PacketBuffer msgBuf)`	`WEAVE_ERROR` 기본 Inetlayer UDP 엔드포인트를 사용하여 인코딩된 Weave 메시지를 다시 보냅니다.
`ResendMessage(const IPAddress & destAddr, WeaveMessageInfo msgInfo, PacketBuffer msgBuf)`	`WEAVE_ERROR` 기본 Inetlayer UDP 엔드포인트를 사용하여 인코딩된 Weave 메시지를 다시 보냅니다.
`ResendMessage(const IPAddress & destAddr, uint16_t destPort, WeaveMessageInfo msgInfo, PacketBuffer msgBuf)`	`WEAVE_ERROR` 기본 Inetlayer UDP 엔드포인트를 사용하여 인코딩된 Weave 메시지를 다시 보냅니다.
`ResendMessage(const IPAddress & destAddr, uint16_t destPort, InterfaceId interfaceId, WeaveMessageInfo msgInfo, PacketBuffer msgBuf)`	`WEAVE_ERROR` 기본 Inetlayer UDP 엔드포인트를 사용하여 인코딩된 Weave 메시지를 다시 보냅니다.
`SendMessage(WeaveMessageInfo msgInfo, PacketBuffer msgBuf)`	`WEAVE_ERROR` 인코딩 후에 기본 Inetlayer UDP 엔드포인트를 사용하여 Weave 메시지를 보냅니다.
`SendMessage(const IPAddress & destAddr, WeaveMessageInfo msgInfo, PacketBuffer msgBuf)`	`WEAVE_ERROR` 인코딩 후에 기본 Inetlayer UDP 엔드포인트를 사용하여 Weave 메시지를 보냅니다.
`SendMessage(const IPAddress & destAddr, uint16_t destPort, InterfaceId sendIntfId, WeaveMessageInfo msgInfo, PacketBuffer msgBuf)`	`WEAVE_ERROR` 인코딩 후에 기본 Inetlayer UDP 엔드포인트를 사용하여 Weave 메시지를 보냅니다.
`SendUDPTunneledMessage(const IPAddress & destAddr, WeaveMessageInfo msgInfo, PacketBuffer msgBuf)`	`WEAVE_ERROR` 로컬 UDP 터널을 통해 터널링된 패킷을 전송하는 함수입니다.
`SetSignalMessageLayerActivityChanged(MessageLayerActivityChangeHandlerFunct messageLayerActivityChangeHandler)`	`void` 메시지 레이어의 활동이 변경될 때마다 호출되는 애플리케이션 핸들러를 설정합니다.
`SetTCPListenEnabled(bool val)`	`void` WeaveMessageLayer에서 인바운드 TCP 연결 수신을 사용 설정 또는 사용 중지합니다.
`SetUDPListenEnabled(bool val)`	`void` WeaveMessageLayer에서 수신 UDP 메시지 수신을 사용 또는 사용 중지합니다.
`SetUnsecuredConnectionListener(ConnectionReceiveFunct newOnUnsecuredConnectionReceived, CallbackRemovedFunct newOnUnsecuredConnectionCallbacksRemoved, bool force, void *listenerState)`	`WEAVE_ERROR`
`Shutdown(void)`	`WEAVE_ERROR` WeaveMessageLayer를 종료합니다.
`TCPListenEnabled(void) const`	`bool` 인바운드 TCP 연결을 수신 대기하도록 WeaveMessageLayer가 구성되었는지 확인합니다.
`UDPListenEnabled(void) const`	`bool` 인바운드 UDP 메시지를 수신 대기하도록 WeaveMessageLayer가 구성되었는지 확인합니다.
`UnsecuredListenEnabled(void) const`	`bool` 임시 UDP 소스 포트에서 Weave UDP 교환 시작을 사용 설정 또는 사용 중지합니다.

공개 정적 함수
`GetMaxWeavePayloadSize(const PacketBuffer *msgBuf, bool isUDP, uint32_t udpMTU)`	`uint32_t` 메시지 구성 및 제공된 PacketBuffer의 최대 Weave 페이로드 크기를 가져옵니다.
`GetPeerDescription(char buf, size_t bufSize, uint64_t nodeId, const IPAddress addr, uint16_t port, InterfaceId interfaceId, const WeaveConnection *con)`	`void` 피어 노드 및 연결된 주소 / 연결 정보를 설명하는 문자열을 구성합니다.
`GetPeerDescription(char buf, size_t bufSize, const WeaveMessageInfo msgInfo)`	`void` 피어에서 수신한 메시지와 연결된 정보를 바탕으로 피어 노드를 설명하는 문자열을 구성합니다.

클래스
nl::Weave::WeaveMessageLayer::InitContext	InitContext 클래스의 정의입니다.

공개 유형

오류 허용

void(* AcceptErrorFunct)(WeaveMessageLayer *msgLayer, WEAVE_ERROR err)

이 함수는 수신 TCP 연결을 처리하는 동안 오류를 보고하는 상위 레이어 콜백입니다.

세부정보

매개변수

`[in] msgLayer`	WeaveMessageLayer 객체에 대한 포인터.
`[in] err`	수신되는 TCP 연결을 처리하는 중에 WEAVE_ERROR가 발생했습니다.

CallbackRemovedFunct

void(* CallbackRemovedFunct)(void *listenerState)

이 함수는 콜백을 삭제하기 위해 호출됩니다.

세부정보

매개변수

[in] listenerState

애플리케이션 상태 객체에 대한 포인터입니다.

ConnectionReceiveFunct(연결 수신)

void(* ConnectionReceiveFunct)(WeaveMessageLayer *msgLayer, WeaveConnection *con)

이 함수는 수신 TCP 연결을 처리하기 위한 상위 계층 콜백입니다.

세부정보

매개변수

`[in] msgLayer`	WeaveMessageLayer 객체에 대한 포인터.
`[in] con`	WeaveConnection 객체에 대한 포인터입니다.

MessageLayerActivityChangeHandlerFunct

void(* MessageLayerActivityChangeHandlerFunct)(bool messageLayerIsActive)

이 함수는 메시지 레이어 활동 변경사항을 보고하는 애플리케이션 콜백입니다.

열린 거래소 또는 대기 중인 메시지 카운터 동기화 요청이 하나 이상 있는 경우 메시지 레이어가 활성 상태로 간주됩니다.

세부정보

매개변수

[in] messageLayerIsActive

메시지 레이어의 활성 여부를 나타내는 부울 값입니다.

MessageReceiveFunct

void(* MessageReceiveFunct)(WeaveMessageLayer *msgLayer, WeaveMessageInfo *msgInfo, PacketBuffer *payload)

이 함수는 UDP를 통해 Weave 메시지를 수신할 때 호출되는 상위 레이어 콜백입니다.

세부정보

매개변수

`[in] msgLayer`	WeaveMessageLayer 객체에 대한 포인터.
`[in] msgInfo`	WeaveMessageInfo 객체를 가리키는 포인터.
`[in] payload`	터널링된 수신 패킷을 포함하는 PacketBuffer 메시지에 대한 포인터입니다.

ReceiveErrorFunct

void(* ReceiveErrorFunct)(WeaveMessageLayer *msgLayer, WEAVE_ERROR err, const IPPacketInfo *pktInfo)

이 함수는 오류가 발생할 때 호출되는 상위 계층 콜백입니다.

세부정보

매개변수

`[in] msgLayer`	WeaveMessageLayer 객체에 대한 포인터.
`[in] err`	데이터를 수신하는 중에 WEAVE_ERROR가 발생했습니다.
`[in] pktInfo`	IPPacketInfo 객체에 대한 읽기 전용 포인터입니다.

상태

 State

WeaveMessageLayer의 상태입니다.

속성
`kState_Initialized`	WeaveMessageLayer가 초기화되는 상태입니다.
`kState_Initializing`	WeaveMessageLayer가 초기화 중인 상태입니다.
`kState_NotInitialized`	WeaveMessageLayer가 초기화되지 않은 상태입니다.

터널링 MsgReceiveFunct

void(* TunneledMsgReceiveFunct)(WeaveMessageLayer *msgLayer, PacketBuffer *payload)

이 함수는 로컬 UDP 터널을 통해 터널링된 패킷을 수신하면 호출되는 상위 레이어 콜백입니다.

세부정보

매개변수

`[in] msgLayer`	WeaveMessageLayer 객체에 대한 포인터.
`[in] payload`	터널링된 수신 패킷을 포함하는 PacketBuffer 메시지에 대한 포인터입니다.

공개 속성

앱 상태

void * AppState

애플리케이션별 상태 객체에 대한 포인터입니다.

Exchange 관리자

WeaveExchangeManager * ExchangeMgr

[읽기 전용] 연결된 WeaveExchangeManager 객체입니다.

FabricState

WeaveFabricState * FabricState

[읽기 전용] 연결된 WeaveFabricState 객체입니다.

수신 ConIdle제한 시간

uint32_t IncomingConIdleTimeout

수신 연결에 대한 기본 유휴 제한 시간 (밀리초)입니다.

네트

InetLayer * Inet

[읽기 전용] 연결된 InetLayer 객체입니다.

듣기

bool IsListening

[읽기 전용] 수신 연결/메시지를 수신 대기하는 경우 true, 그렇지 않은 경우 false

OnAcceptError

AcceptErrorFunct OnAcceptError

OnConnectionReceived

ConnectionReceiveFunct OnConnectionReceived

온메시지 수신됨

MessageReceiveFunct OnMessageReceived

OnReceiveError

ReceiveErrorFunct OnReceiveError

OnUDPTunneledMessageReceived

TunneledMsgReceiveFunct OnUDPTunneledMessageReceived

보안 관리자

WeaveSecurityManager * SecurityMgr

[읽기 전용] 연결된 WeaveSecurityManager 객체입니다.

상태

uint8_t State

[읽기 전용] WeaveMessageLayer 객체의 상태입니다.

시스템 레이어

System::Layer * SystemLayer

mDropMessage

bool mDropMessage

내부 및 디버그 전용입니다. 설정되면 WeaveMessageLayer는 메시지를 삭제하고 반환합니다.

공개 함수

ClearUnsecuredConnectionListener

WEAVE_ERROR ClearUnsecuredConnectionListener(
  ConnectionReceiveFunct oldOnUnsecuredConnectionReceived,
  CallbackRemovedFunct newOnUnsecuredConnectionCallbacksRemoved
)

닫기 엔드포인트

WEAVE_ERROR CloseEndpoints(
  void
)

열려 있는 TCP 및 UDP 엔드포인트를 모두 닫습니다.

그런 다음 열려 있는 WeaveConnections를 취소하고 열려 있는 WeaveConnectionTunnel 객체를 종료합니다.

참고 항목:
Shutdown()

CreateTunnel

WEAVE_ERROR CreateTunnel(
  WeaveConnectionTunnel **tunPtr,
  WeaveConnection & conOne,
  WeaveConnection & conTwo,
  uint32_t inactivityTimeoutMS
)

지정된 두 WeaveConnection을 결합하여 WeaveConnectionTunnel을 만듭니다.

생성이 완료되면 구성요소 WeaveConnection 객체에 해당하는 TCPEndPoint가 WeaveConnectionTunnel에 전달됩니다. 그렇지 않으면 WeaveConnection이 닫힙니다.

세부정보

매개변수

`[out] tunPtr`	WeaveConnectionTunnel 포인터의 포인터입니다.
`[in] conOne`	첫 번째 WeaveConnection 객체에 대한 참조입니다.
`[in] conTwo`	두 번째 WeaveConnection 객체에 대한 참조입니다.
`[in] inactivityTimeoutMS`	Weave 연결 터널이 유휴 상태일 수 있는 최대 시간(밀리초)입니다.

반환 값

`WEAVE_NO_ERROR`	WeaveConnectionTunnel 생성에 대해 알아보겠습니다.
`WEAVE_ERROR_INCORRECT_STATE`	WeaveConnectionTunnel의 구성 요소 WeaveConnection 객체가 올바른 상태가 아닌 경우.
`WEAVE_ERROR_NO_MEMORY`	새 WeaveConnectionTunnel 객체를 만들 수 없는 경우

디코드헤더

WEAVE_ERROR DecodeHeader(
  PacketBuffer *msgBuf,
  WeaveMessageInfo *msgInfo,
  uint8_t **payloadStart
)

수신된 Weave 메시지에서 Weave 메시지 레이어 헤더를 디코딩합니다.

세부정보

매개변수

`[in] msgBuf`	Weave 메시지를 포함하는 PacketBuffer 객체에 관한 포인터입니다.
`[in] msgInfo`	메시지에 관한 정보를 수신할 WeaveMessageInfo 객체에 관한 포인터입니다.
`[out] payloadStart`	디코딩이 완료된 후 메시지 버퍼의 위치에 대한 포인터를 가리키는 포인터입니다.

반환 값

`WEAVE_NO_ERROR`	메시지 헤더의 디코딩 완료 시
`WEAVE_ERROR_INVALID_MESSAGE_LENGTH`	전달된 메시지 버퍼의 길이가 잘못된 경우
`WEAVE_ERROR_UNSUPPORTED_MESSAGE_VERSION`	Weave 메시지 헤더 형식 버전이 지원되지 않는 경우

EncodeMessage

WEAVE_ERROR EncodeMessage(
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf,
  WeaveConnection *con,
  uint16_t maxLen,
  uint16_t reserve
)

WeaveMessageLayer 헤더를 PacketBuffer에 인코딩합니다.

세부정보

매개변수

`[in] msgInfo`	인코딩할 메시지에 대한 정보가 포함된 WeaveMessageInfo 객체에 대한 포인터입니다.
`[in] msgBuf`	Weave 메시지를 보유할 PacketBuffer 객체에 관한 포인터입니다.
`[in] con`	WeaveConnection 객체에 대한 포인터입니다.
`[in] maxLen`	인코딩된 Weave 메시지의 최대 길이입니다.
`[in] reserve`	페이로드 앞에 있는 Weave 메시지 헤더를 보관할 예약된 공간입니다.

반환 값

`WEAVE_NO_ERROR`	메시지가 성공적으로 인코딩됩니다.
`WEAVE_ERROR_UNSUPPORTED_MESSAGE_VERSION`	Weave 메시지 헤더 형식 버전이 지원되지 않는 경우.
`WEAVE_ERROR_INVALID_MESSAGE_LENGTH`	메시지 버퍼의 페이로드 길이가 0인 경우.
`WEAVE_ERROR_UNSUPPORTED_ENCRYPTION_TYPE`	메일 헤더의 암호화 유형이 지원되지 않는 경우.
`WEAVE_ERROR_MESSAGE_TOO_LONG`	인코딩된 메시지가 요청된 최댓값보다 긴 경우.
`WEAVE_ERROR_BUFFER_TOO_SMALL`	메시지 페이로드 앞 또는 뒤에 공간이 부족한 경우
`other`	세션 상태를 가져올 때 패브릭 상태 객체에서 생성된 오류

EncodeMessage

WEAVE_ERROR EncodeMessage(
  const IPAddress & destAddr,
  uint16_t destPort,
  InterfaceId sendIntId,
  WeaveMessageInfo *msgInfo,
  PacketBuffer *payload
)

Weave 메시지 레이어 헤더를 PacketBuffer에 인코딩합니다.

세부정보

매개변수

`[in] destAddr`	대상 IP 주소입니다.
`[in] destPort`	대상 포트.
`[in] sendIntId`	Weave 메시지를 보낼 인터페이스입니다.
`[in] msgInfo`	WeaveMessageInfo 객체를 가리키는 포인터.
`[in] payload`	Weave 메시지를 보유할 PacketBuffer 객체에 관한 포인터입니다.

반환 값

`WEAVE_NO_ERROR`	메시지가 표시됩니다
`WEAVE_ERROR_UNSUPPORTED_MESSAGE_VERSION`	Weave 메시지 버전이 지원되지 않는 경우
`WEAVE_ERROR_INVALID_MESSAGE_LENGTH`	메시지 버퍼의 페이로드 길이가 0인 경우.
`WEAVE_ERROR_UNSUPPORTED_ENCRYPTION_TYPE`	암호화 유형이 지원되지 않는 경우.
`WEAVE_ERROR_MESSAGE_TOO_LONG`	인코딩된 메시지가 요청된 최댓값보다 긴 경우.
`WEAVE_ERROR_BUFFER_TOO_SMALL`	메시지 페이로드 앞 또는 뒤에 공간이 부족한 경우
`other`	세션 상태를 가져올 때 패브릭 상태 객체에서 생성된 오류

임시{/2}

bool EphemeralUDPPortEnabled(
  void
) const

로컬로 시작된 Weave UDP 교환이 임시 UDP 소스 포트에서 전송되어야 하는지 확인합니다.

GetConnectionPoolStats

void GetConnectionPoolStats(
  nl::Weave::System::Stats::count_t & aOutInUse
) const

사용 중인 WeaveConnections 수와 풀 크기를 가져옵니다.

세부정보

매개변수

[out] aOutInUse

size_t에 대한 참조로, 사용 중인 연결 수가 저장됩니다.

IPv4ListenEnabled

bool IPv4ListenEnabled(
  void
) const

IPv4를 통한 인바운드 통신을 수신 대기하도록 WeaveMessageLayer가 구성되었는지 확인합니다.

IPv6ListenEnabled

bool IPv6ListenEnabled(
  void
) const

IPv4를 통한 인바운드 통신을 수신 대기하도록 WeaveMessageLayer가 구성되었는지 확인합니다.

Init

WEAVE_ERROR Init(
  InitContext *context
)

Weave 메시지 레이어 객체를 초기화합니다.

세부정보

매개변수

[in] context

InitContext 객체에 대한 포인터.

반환 값

`WEAVE_NO_ERROR`	보여줍니다.
`WEAVE_ERROR_INVALID_ARGUMENT`	전달된 InitContext 객체가 NULL인 경우
`WEAVE_ERROR_INCORRECT_STATE`	WeaveMessageLayer 객체의 상태가 잘못된 경우.
`other`	엔드포인트 생성 중에 하위 Inet 레이어에서 생성된 오류

IsBoundToLocalIPv4Address

bool IsBoundToLocalIPv4Address(
  void
) const

WeaveMessageLayer가 로컬 IPv4 주소에 바인딩되는지 확인합니다.

IsBoundToLocalIPv6Address

bool IsBoundToLocalIPv6Address(
  void
) const

WeaveMessageLayer가 로컬 IPv6 주소에 바인딩되어 있는지 확인합니다.

IsMessageLayerActive

bool IsMessageLayerActive(
  void
)

새 연결

WeaveConnection * NewConnection(
  void
)

풀에서 새 WeaveConnection 객체를 만듭니다.

세부정보
반환	성공한 경우 새로 생성된 WeaveConnection 객체에 대한 포인터, 그렇지 않은 경우 NULL.

새 연결 터널

WeaveConnectionTunnel * NewConnectionTunnel(
  void
)

풀에서 새 WeaveConnectionTunnel 객체를 만듭니다.

세부정보
반환	성공한 경우 새로 생성된 WeaveConnectionTunnel 객체에 대한 포인터이고, 그렇지 않으면 NULL입니다.

ReEncodeMessage

WEAVE_ERROR ReEncodeMessage(
  PacketBuffer *buf
)

새로고침 엔드포인트

WEAVE_ERROR RefreshEndpoints(
  void
)

시스템 네트워크 인터페이스의 현재 상태를 기반으로 InetLayer 엔드포인트를 새로고침합니다.

세부정보

반환 값

`WEAVE_NO_ERROR`	표시됩니다.
`InetLayer`	TCP/UDP 엔드포인트 생성 호출에 기반한 오류

메시지 다시 보내기

WEAVE_ERROR ResendMessage(
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

기본 Inetlayer UDP 엔드포인트를 사용하여 인코딩된 Weave 메시지를 다시 보냅니다.

세부정보

매개변수

`[in] msgInfo`	WeaveMessageInfo 객체를 가리키는 포인터.
`[in] payload`	인코딩된 Weave 메시지를 포함하는 PacketBuffer 객체에 관한 포인터입니다.

반환 값

`WEAVE_NO_ERROR`	네트워크 레이어로 메시지를 성공적으로 보낼 수 있습니다.
`errors`	전송하는 동안 하위 Inet 레이어 UDP 엔드포인트에서 생성됩니다.

메시지 다시 보내기

WEAVE_ERROR ResendMessage(
  const IPAddress & destAddr,
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

기본 Inetlayer UDP 엔드포인트를 사용하여 인코딩된 Weave 메시지를 다시 보냅니다.

세부정보

매개변수

`[in] destAddr`	대상 IP 주소입니다.
`[in] msgInfo`	WeaveMessageInfo 객체를 가리키는 포인터.
`[in] payload`	인코딩된 Weave 메시지를 포함하는 PacketBuffer 객체에 관한 포인터입니다.

반환 값

`WEAVE_NO_ERROR`	네트워크 레이어로 메시지를 성공적으로 보낼 수 있습니다.
`errors`	전송하는 동안 하위 Inet 레이어 UDP 엔드포인트에서 생성됩니다.

메시지 다시 보내기

WEAVE_ERROR ResendMessage(
  const IPAddress & destAddr,
  uint16_t destPort,
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

기본 Inetlayer UDP 엔드포인트를 사용하여 인코딩된 Weave 메시지를 다시 보냅니다.

세부정보

매개변수

`[in] destAddr`	대상 IP 주소입니다.
`[in] destPort`	대상 포트.
`[in] msgInfo`	WeaveMessageInfo 객체를 가리키는 포인터.
`[in] payload`	인코딩된 Weave 메시지를 포함하는 PacketBuffer 객체에 관한 포인터입니다.

반환 값

`WEAVE_NO_ERROR`	네트워크 레이어로 메시지를 성공적으로 보낼 수 있습니다.
`errors`	전송하는 동안 하위 Inet 레이어 UDP 엔드포인트에서 생성됩니다.

메시지 다시 보내기

WEAVE_ERROR ResendMessage(
  const IPAddress & destAddr,
  uint16_t destPort,
  InterfaceId interfaceId,
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

기본 Inetlayer UDP 엔드포인트를 사용하여 인코딩된 Weave 메시지를 다시 보냅니다.

참고:-대상 주소가 제공되지 않은 경우 메일 헤더의 노드 식별자에서 목적지 주소를 확인해 보세요. 이 작업을 처리할 수 없으면 실패합니다. -대상 주소가 로컬 패브릭의 Fabric 주소이며 호출자가 대상 노드 ID를 지정하지 않은 경우 대상 주소에서 가져옵니다.

세부정보

매개변수

`[in] aDestAddr`	대상 IP 주소입니다.
`[in] destPort`	대상 포트.
`[in] interfaceId`	Weave 메시지를 보낼 인터페이스입니다.
`[in] msgInfo`	WeaveMessageInfo 객체를 가리키는 포인터.
`[in] payload`	인코딩된 Weave 메시지를 포함하는 PacketBuffer 객체에 관한 포인터입니다.

반환 값

`WEAVE_NO_ERROR`	네트워크 레이어로 메시지를 성공적으로 보낼 수 있습니다.
`errors`	전송하는 동안 하위 Inet 레이어 UDP 엔드포인트에서 생성됩니다.

메시지 보내기

WEAVE_ERROR SendMessage(
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

인코딩 후에 기본 Inetlayer UDP 엔드포인트를 사용하여 Weave 메시지를 보냅니다.

세부정보

매개변수

`[in] msgInfo`	전송할 메시지에 대한 정보가 포함된 WeaveMessageInfo 객체에 대한 포인터입니다.
`[in] payload`	인코딩된 Weave 메시지를 포함하는 PacketBuffer 객체에 관한 포인터입니다.

반환 값

`WEAVE_NO_ERROR`	네트워크 레이어로 메시지를 성공적으로 보낼 수 있습니다.
`errors`	전송하는 동안 하위 Inet 레이어 UDP 엔드포인트에서 생성됩니다.

메시지 보내기

WEAVE_ERROR SendMessage(
  const IPAddress & destAddr,
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

인코딩 후에 기본 Inetlayer UDP 엔드포인트를 사용하여 Weave 메시지를 보냅니다.

참고: 사용되는 대상 포트는 WEAVE_PORT입니다. -대상 주소가 제공되지 않은 경우 메일 헤더의 노드 식별자에서 도착 주소를 확인합니다. 이 작업을 처리할 수 없으면 실패합니다.

-대상 주소가 로컬 패브릭의 Fabric 주소이며 호출자가 대상 노드 ID를 지정하지 않은 경우 대상 주소에서 가져옵니다.

세부정보

매개변수

`[in] destAddr`	대상 IP 주소입니다.
`[in] msgInfo`	전송할 메시지에 대한 정보가 포함된 WeaveMessageInfo 객체에 대한 포인터입니다.
`[in] payload`	인코딩된 Weave 메시지를 포함하는 PacketBuffer 객체에 관한 포인터입니다.

반환 값

`WEAVE_NO_ERROR`	네트워크 레이어로 메시지를 성공적으로 보낼 수 있습니다.
`errors`	전송하는 동안 하위 Inet 레이어 UDP 엔드포인트에서 생성됩니다.

메시지 보내기

WEAVE_ERROR SendMessage(
  const IPAddress & destAddr,
  uint16_t destPort,
  InterfaceId sendIntfId,
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

인코딩 후에 기본 Inetlayer UDP 엔드포인트를 사용하여 Weave 메시지를 보냅니다.

세부정보

매개변수

`[in] aDestAddr`	대상 IP 주소입니다.
`[in] destPort`	대상 포트.
`[in] sendIntfId`	Weave 메시지를 보낼 인터페이스입니다.
`[in] msgInfo`	전송할 메시지에 대한 정보가 포함된 WeaveMessageInfo 객체에 대한 포인터입니다.
`[in] payload`	인코딩된 Weave 메시지를 포함하는 PacketBuffer 객체에 관한 포인터입니다.

반환 값

`WEAVE_NO_ERROR`	네트워크 레이어로 메시지를 성공적으로 보낼 수 있습니다.
`WEAVE_ERROR_INVALID_ADDRESS`	destAddr가 지정되지 않았거나 대상 노드 ID에서 확인되지 않는 경우
`errors`	전송하는 동안 하위 Inet 레이어 UDP 엔드포인트에서 생성됩니다.

SendUDPTunneledMessage

WEAVE_ERROR SendUDPTunneledMessage(
  const IPAddress & destAddr,
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

로컬 UDP 터널을 통해 터널링된 패킷을 전송하는 함수입니다.

UDP를 통해 터널링된 IPv6 데이터 메시지를 전송합니다.

세부정보

매개변수

`[in] msgInfo`	WeaveMessageInfo 객체를 가리키는 포인터.
`[in] destAddr`	UDP 터널 대상의 IP 주소입니다.
`[in] msgBuf`	패킷을 전송할 PacketBuffer 객체에 대한 포인터입니다.

반환 값

`WEAVE_NO_ERROR`	네트워크 레이어로 메시지를 성공적으로 보낼 수 있습니다.
`WEAVE_ERROR_INVALID_ADDRESS`	destAddr가 지정되지 않았거나 대상 노드 ID에서 확인되지 않는 경우
`errors`	전송하는 동안 하위 Inet 레이어 UDP 엔드포인트에서 생성됩니다.

SetSignalMessageLayerActivityChanged

void SetSignalMessageLayerActivityChanged(
  MessageLayerActivityChangeHandlerFunct messageLayerActivityChangeHandler
)

메시지 레이어의 활동이 변경될 때마다 호출되는 애플리케이션 핸들러를 설정합니다.

특히 매번 다음과 같은 알림을 받게 됩니다.

열린 거래소의 수가 변경됩니다.
대기 중인 메시지 카운터 동기화 요청 수가 0개에서 1개 이상으로 변경되고 다시 0으로 변경됩니다. 핸들러는 진행 중인 Weave 대화 또는 대기 중인 응답이 있는지 여부를 나타내는 일반적인 신호로 사용됩니다. 핸들러는 WeaveMessageLayer가 초기화된 후에 설정해야 합니다. WeaveMessageLayer를 종료하면 현재 핸들러가 지워집니다.

세부정보

매개변수

[in] messageLayerActivityChangeHandler

메시지 레이어 활동이 변경될 때마다 호출할 함수에 대한 포인터입니다.

반환 값

None.

SetTCPListenEnabled

void SetTCPListenEnabled(
  bool val
)

WeaveMessageLayer에서 인바운드 TCP 연결 수신을 사용 설정 또는 사용 중지합니다.

참고: TCP 수신 상태가 변경된 후 RefreshEndpoints()를 호출해야 합니다.

SetUDPListenEnabled

void SetUDPListenEnabled(
  bool val
)

WeaveMessageLayer에서 수신 UDP 메시지 수신을 사용 또는 사용 중지합니다.

참고: UDP 수신 상태가 변경된 후 RefreshEndpoints()를 호출해야 합니다.

SetUnsecuredConnectionListener

WEAVE_ERROR SetUnsecuredConnectionListener(
  ConnectionReceiveFunct newOnUnsecuredConnectionReceived,
  CallbackRemovedFunct newOnUnsecuredConnectionCallbacksRemoved,
  bool force,
  void *listenerState
)

종료

WEAVE_ERROR Shutdown(
  void
)

WeaveMessageLayer를 종료합니다.

열려 있는 Inet 레이어 엔드포인트를 모두 닫고 상위 계층 콜백, 구성원 변수, 객체를 모두 재설정합니다. Shutdown()을 호출하면 WeaveMessageLayer 객체가 종료됩니다.

TCPListenEnabled

bool TCPListenEnabled(
  void
) const

인바운드 TCP 연결을 수신 대기하도록 WeaveMessageLayer가 구성되었는지 확인합니다.

UDPListenEnabled:

bool UDPListenEnabled(
  void
) const

인바운드 UDP 메시지를 수신 대기하도록 WeaveMessageLayer가 구성되었는지 확인합니다.

UnsecuredListenEnabled

bool UnsecuredListenEnabled(
  void
) const

임시 UDP 소스 포트에서 Weave UDP 교환 시작을 사용 설정 또는 사용 중지합니다.

참고: 임시 포트 상태가 변경된 후 RefreshEndpoints()를 호출해야 합니다. 보안되지 않은 듣기가 사용 설정되어 있는지 확인합니다.

WeaveMessageLayer

 WeaveMessageLayer(
  void
)

Weave 메시지 레이어 생성자

공개 정적 함수

GetMaxWeavePayloadSize

uint32_t GetMaxWeavePayloadSize(
  const PacketBuffer *msgBuf,
  bool isUDP,
  uint32_t udpMTU
)

메시지 구성 및 제공된 PacketBuffer의 최대 Weave 페이로드 크기를 가져옵니다.

반환되는 최대 페이로드 크기는 제공된 PacketBuffer 내의 페이로드에 사용 가능한 공간을 초과하지 않습니다.

메시지가 UDP인 경우 반환되는 최대 페이로드 크기는 지정된 UDP MTU를 오버플로하지 않는 Weave 메시지가 아닙니다.

마지막으로 반환되는 최대 페이로드 크기는 Weave 메시지 최대 크기를 초과하는 Weave 메시지가 아닙니다.

세부정보

매개변수

`[in] msgBuf`	메시지 페이로드가 기록될 PacketBuffer에 대한 포인터입니다.
`[in] isUDP`	메시지가 UDP 메시지인 경우 true입니다.
`[in] udpMTU`	UDP MTU의 크기입니다. isUDP가 false인 경우 무시됩니다.

반환

최대 Weave 페이로드 크기입니다.

피어 설명

void GetPeerDescription(
  char *buf,
  size_t bufSize,
  uint64_t nodeId,
  const IPAddress *addr,
  uint16_t port,
  InterfaceId interfaceId,
  const WeaveConnection *con
)

피어 노드 및 연결된 주소 / 연결 정보를 설명하는 문자열을 구성합니다.

생성된 문자열의 형식은 다음과 같습니다.

 ([]:%, con )

세부정보

매개변수

`[in] buf`	문자열을 작성해야 하는 버퍼에 대한 포인터입니다. 제공된 버퍼는 최소한 kWeavePeerDescription_MaxLength보다 커야 합니다. 더 작은 버퍼가 제공되면 문자열이 잘립니다. 출력에는 모든 경우에 NUL 종료 문자가 포함됩니다.
`[in] bufSize`	buf가 가리키는 버퍼의 크기입니다.
`[in] nodeId`	출력할 노드 ID입니다.
`[in] addr`	출력할 IP 주소에 대한 포인터이거나 출력해야 할 IP 주소가 없으면 NULL입니다.
`[in] port`	출력할 IP 포트 번호입니다. addr가 NULL인 경우 포트 번호가 출력되지 않습니다.
`[in] interfaceId`	출력할 인터페이스를 식별하는 인터페이스 ID입니다. 출력 문자열에는 기본 네트워크 스택에 알려진 인터페이스 이름이 포함됩니다. InterfaceId가 INET_NULL_INTERFACEID이거나 addr가 NULL인 경우 인터페이스 이름이 출력되지 않습니다.
`[in] con`	로깅 ID를 인쇄해야 하는 WeaveConnection 객체에 대한 포인터이거나, 연결 ID를 출력하지 않아야 하는 경우 NULL입니다.

피어 설명

void GetPeerDescription(
  char *buf,
  size_t bufSize,
  const WeaveMessageInfo *msgInfo
)

피어에서 수신한 메시지와 연결된 정보를 바탕으로 피어 노드를 설명하는 문자열을 구성합니다.

세부정보

매개변수

`[in] buf`	문자열을 작성해야 하는 버퍼에 대한 포인터입니다. 제공된 버퍼는 최소한 kWeavePeerDescription_MaxLength보다 커야 합니다. 더 작은 버퍼가 제공되면 문자열이 잘립니다. 출력에는 모든 경우에 NUL 종료 문자가 포함됩니다.
`[in] bufSize`	buf가 가리키는 버퍼의 크기입니다.
`[in] msgInfo`	메시지 관련 정보가 포함된 WeaveMessageInfo 구조에 대한 포인터입니다.

nl::매트::WeaveMessageLayer

요약

생성자 및 소멸자

공개 유형

공개 속성

공개 함수

공개 정적 함수

클래스

공개 유형

오류 허용

CallbackRemovedFunct

ConnectionReceiveFunct(연결 수신)

MessageLayerActivityChangeHandlerFunct

MessageReceiveFunct

ReceiveErrorFunct

상태

터널링 MsgReceiveFunct

공개 속성

앱 상태

Exchange 관리자

FabricState

수신 ConIdle제한 시간

네트

듣기

OnAcceptError

OnConnectionReceived

온메시지 수신됨

OnReceiveError

OnUDPTunneledMessageReceived

보안 관리자

상태

시스템 레이어

mDropMessage

공개 함수

ClearUnsecuredConnectionListener

닫기 엔드포인트

CreateTunnel

디코드헤더

EncodeMessage

EncodeMessage

임시{/2}

GetConnectionPoolStats

IPv4ListenEnabled

IPv6ListenEnabled

Init

IsBoundToLocalIPv4Address

IsBoundToLocalIPv6Address

IsMessageLayerActive

새 연결

새 연결 터널

ReEncodeMessage

새로고침 엔드포인트

메시지 다시 보내기

메시지 다시 보내기

메시지 다시 보내기

메시지 다시 보내기

메시지 보내기

메시지 보내기

메시지 보내기

SendUDPTunneledMessage

SetSignalMessageLayerActivityChanged

SetTCPListenEnabled

SetUDPListenEnabled

SetUnsecuredConnectionListener

종료

TCPListenEnabled

UDPListenEnabled:

UnsecuredListenEnabled

WeaveMessageLayer

공개 정적 함수

GetMaxWeavePayloadSize

피어 설명

피어 설명