Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기

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

nl::Weave::System::PacketBuffer

#include <src/system/SystemPacketBuffer.h>

패킷 버퍼 클래스는 일반적으로 블루투스나 인터넷 프로토콜과 같은 데이터 통신 네트워크의 컨텍스트에서 옥텟 직렬화된 데이터의 패킷을 조작하는 데 사용되는 핵심 구조입니다.

요약

LwIP 기반 환경에서 이 클래스는 해당 라이브러리에 정의된 pbuf 구조를 기반으로 빌드됩니다. LwIP가 없을 경우 Weave는 malloc 기반 구현 또는 심층적으로 삽입된 기기의 메모리 문제와 근접한 풀 기반 구현을 제공합니다.

PacketBuffer 클래스는 계층화된 네트워크 스택에 사용되는 여러 유사한 구조와 마찬가지로 구성 가능한 통신 스택의 각 레이어에서 프로토콜 헤더를 위한 공간을 예약하는 메커니즘을 제공합니다. 자세한 내용은 PacketBuffer::New() 및 LwIP 문서를 참고하세요.

PacketBuffer 객체는 참조로 계산되며 Weave의 일반적인 사용 모드는 'fire-and-forget'입니다. 패킷 (및 기본 PacketBuffer 객체)이 다양한 프로토콜 레이어를 통해 전달되므로 레이어 간의 성공적인 업콜 또는 다운콜은 소유권 이전을 암시하고, 피호출자는 버퍼 해제를 담당합니다. 교차 레이어 호출에 실패하면 버퍼 해제에 대한 책임이 호출자에 있습니다.

PacketBuffer 클래스의 새로운 객체는 기본 환경에서 가져온 메모리 할당이 시작될 때 초기화됩니다(예: 내부 버퍼 풀에서 LwIP pbuf 대상 풀, 표준 C 라이브러리 힙에서). 간단한 사례에서 데이터 버퍼의 크기는 WEAVE_SYSTEM_PACKETBUFFER_SIZE입니다. 다른 크기의 데이터 버퍼를 사용하도록 허용하는 컴포저가 제공됩니다.

더 큰 페이로드를 수용하기 위해 PacketBuffer 객체를 연결할 수 있습니다. 그러나 체이닝은 투명하지 않으며 클래스의 사용자는 체이닝을 지원하도록 명시적으로 결정해야 합니다. 체이닝 지원으로 작성된 클래스의 예는 다음과 같습니다.

@ref nl::Weave::WeaveTLVReader
@ref nl::Weave::WeaveTLVWriter

상속

다음에서 상속: pbuf

공개 함수
`AddRef(void)`	`void` 현재 버퍼의 참조 카운트를 증가시킵니다.
`AddToEnd(PacketBuffer *aPacket)`	`void` 지정된 패킷 버퍼를 버퍼 체인 끝에 추가하고, 그에 따라 체인에 있는 각 버퍼의 총 길이를 조정합니다.
`AlignPayload(uint16_t aAlignBytes)`	`bool` 지정된 바이트 경계에서 버퍼 페이로드를 정렬합니다.
`AllocSize(void) const`	`size_t` 예약된 데이터 공간과 페이로드 데이터 공간을 포함해 할당의 크기를 반환하되 PacketBuffer 구조에 할당된 공간은 포함하지 않습니다.
`AvailableDataLength(void) const`	`uint16_t` 현재 시작 위치와 데이터 길이를 고려하여 현재 버퍼에 추가될 수 있는 데이터의 바이트 수를 가져옵니다.
`CompactHead(void)`	`void` 체인의 후속 버퍼에서 가득 찼을 때까지 현재 버퍼로 데이터를 이동합니다.
`Consume(uint16_t aConsumeLength)`	`PacketBuffer *` 버퍼 체인에서 데이터를 사용합니다.
`ConsumeHead(uint16_t aConsumeLength)`	`void` 현재 버퍼를 조정하여 소비된 데이터 양을 표시합니다.
`DataLength(void) const`	`uint16_t` 패킷 버퍼에 있는 데이터의 길이(바이트)를 가져옵니다.
`DetachTail(void)`	`PacketBuffer *` 현재 버퍼를 체인에서 분리하고 나머지 버퍼의 포인터를 반환합니다.
`EnsureReservedSize(uint16_t aReservedSize)`	`bool` 버퍼에 최소한 지정된 양의 예약된 공간이 있는지 확인합니다.
`MaxDataLength(void) const`	`uint16_t` 현재 시작 위치와 버퍼 크기를 고려하여 버퍼에 들어가는 최대 데이터 양(바이트)을 가져옵니다.
`Next(void) const`	`PacketBuffer *` 체인에 있는 다음 버퍼를 가리키는 포인터를 가져옵니다.
`ReservedSize(void) const`	`uint16_t` 버퍼 시작과 현재 데이터 시작 위치 사이의 현재 버퍼 내에서 바이트 수를 가져옵니다.
`SetDataLength(uint16_t aNewLen, PacketBuffer *aChainHead)`	`void` 버퍼에 있는 데이터의 길이를 바이트 단위로 설정하고 이에 따라 총 길이를 조정합니다.
`SetStart(uint8_t *aNewStart)`	`void` 시작 데이터를 버퍼에 설정하고 이에 따라 길이와 총 길이를 조정합니다.
`Start(void) const`	`uint8_t *` 버퍼의 데이터 시작을 가리키는 포인터를 가져옵니다.
`TotalLength(void) const`	`uint16_t` 버퍼 체인에서 패킷 데이터의 전체 길이를 가져옵니다.

공개 정적 함수
`Free(PacketBuffer *aPacket)`	`void` 체인의 모든 패킷 버퍼를 해제합니다.
`FreeHead(PacketBuffer *aPacket)`	`PacketBuffer *` 체인의 첫 번째 버퍼를 해제하고 나머지 버퍼를 가리키는 포인터를 반환합니다.
`New(void)`	`PacketBuffer *` 페이로드에 예약된 기본 크기 (WEAVE_SYSTEM_CONFIG_HEADER_RESERVE_SIZE)와 함께 기본 최대 크기 (WEAVE_SYSTEM_CONFIG_PACKETBUFFER_CAPACITY_MAX)의 단일 PacketBuffer를 할당합니다.
`New(uint16_t aReservedSize)`	`PacketBuffer *` 특정 헤더 예약 크기와 함께 최대 총 크기의 단일 PacketBuffer를 할당합니다.
`NewWithAvailableSize(size_t aAvailableSize)`	`PacketBuffer *` 헤더의 페이로드에 예약된 기본 크기 (WEAVE_SYSTEM_CONFIG_HEADER_RESERVE_SIZE)와 함께 PacketBuffer를 할당하고 초기 커서 포인터 뒤에 추가 데이터를 위해 `aAllocSize`바이트 이상의 공간을 할당합니다.
`NewWithAvailableSize(uint16_t aReservedSize, size_t aAvailableSize)`	`PacketBuffer *` 헤더용 페이로드에 예약된 `aReservedSize`바이트 이상과 초기 커서 포인터 뒤에 추가 데이터를 위한 `aAllocSize`바이트 이상의 공간이 있는 PacketBuffer 객체를 할당합니다.
`RightSize(PacketBuffer *aPacket)`	`PacketBuffer *` 적절한 크기의 버퍼에 제공된 버퍼를 복사합니다(해당하는 경우).

공개 함수

AddRef

void AddRef(
  void
)

현재 버퍼의 참조 카운트를 증가시킵니다.

AddToEnd

void AddToEnd(
  PacketBuffer *aPacket
)

지정된 패킷 버퍼를 버퍼 체인 끝에 추가하고, 그에 따라 체인에 있는 각 버퍼의 총 길이를 조정합니다.

세부정보

매개변수

[in] aPacket

- 현재 체인의 끝에 추가할 패킷 버퍼입니다.

AlignPayload

bool AlignPayload(
  uint16_t aAlignBytes
)

지정된 바이트 경계에서 버퍼 페이로드를 정렬합니다.

필요한 경우 버퍼의 페이로드를 앞으로 이동합니다.

세부정보

매개변수

[in] aAlignBytes

- 페이로드 시작 포인터의 바이트 정렬 수를 지정합니다.

반환

정렬에 성공하면 true, 버퍼에 공간이 충분하지 않으면 false

AllocSize

size_t AllocSize(
  void
) const

예약된 데이터 공간과 페이로드 데이터 공간을 포함해 할당의 크기를 반환하되 PacketBuffer 구조에 할당된 공간은 포함하지 않습니다.

참고: 할당 크기는 Create 메서드의 aAllocSize 매개변수보다 크거나 같습니다.)

세부정보
반환	할당 크기

AvailableDataLength

uint16_t AvailableDataLength(
  void
) const

현재 시작 위치와 데이터 길이를 고려하여 현재 버퍼에 추가될 수 있는 데이터의 바이트 수를 가져옵니다.

세부정보
반환	현재 시작 위치 및 데이터 길이를 고려하여 현재 버퍼에 적합한 데이터의 길이(바이트)

CompactHead

void CompactHead(
  void
)

체인의 후속 버퍼에서 가득 찼을 때까지 현재 버퍼로 데이터를 이동합니다.

현재 버퍼만 압축됩니다. 즉, 현재 버퍼 내의 데이터가 버퍼 앞으로 이동하므로 예약된 공간이 제거됩니다. 사용 가능한 나머지 공간은 현재 버퍼가 가득 찰 때까지 체인의 후속 버퍼에서 이동한 데이터로 채워집니다. 체인의 후속 버퍼가 현재 버퍼 전체로 이동되면 체인에서 제거되어 해제됩니다. 이 메서드는 매개변수를 사용하지 않고, 결과를 반환하지 않으며, 실패할 수 없습니다.

소비

PacketBuffer * Consume(
  uint16_t aConsumeLength
)

버퍼 체인에서 데이터를 사용합니다.

현재 버퍼에서 시작하여 체인의 나머지 버퍼를 거치는 버퍼 체인에서 데이터를 사용합니다. 완전히 소비된 각 버퍼가 해제되고 함수는 나머지 데이터를 포함하는 첫 번째 버퍼 (있는 경우)를 반환합니다. 현재 버퍼는 버퍼 체인의 헤드여야 합니다.

세부정보

매개변수

[in] aConsumeLength

- 현재 체인에서 사용할 바이트 수입니다.

반환

나머지 데이터가 포함된 현재 체인의 첫 번째 버퍼. 남아 있는 데이터가 없으면 NULL이 반환됩니다.

ConsumeHead

void ConsumeHead(
  uint16_t aConsumeLength
)

현재 버퍼를 조정하여 소비된 데이터 양을 표시합니다.

현재 버퍼의 데이터 시작 위치를 지정된 양(바이트)만큼 버퍼의 데이터 길이만큼 진행합니다. 길이 및 총 길이를 소비한 양만큼 줄입니다.

세부정보

매개변수

[in] aConsumeLen

- 현재 버퍼에서 소비할 바이트 수입니다.

DataLength

uint16_t DataLength(
  void
) const

패킷 버퍼에 있는 데이터의 길이(바이트)를 가져옵니다.

세부정보
반환	바이트 단위의 길이 (현재 페이로드 길이)입니다.

DetachTail

PacketBuffer * DetachTail(
  void
)

현재 버퍼를 체인에서 분리하고 나머지 버퍼의 포인터를 반환합니다.

현재 버퍼는 체인의 헤드여야 합니다.

세부정보
반환	현재 버퍼 체인의 꼬리 또는 NULL(현재 버퍼가 체인의 유일한 버퍼인 경우)

EnsureReservedSize

bool EnsureReservedSize(
  uint16_t aReservedSize
)

버퍼에 최소한 지정된 양의 예약된 공간이 있는지 확인합니다.

필요한 경우 공간을 확보할 수 있도록 버퍼의 데이터를 앞으로 이동하는 지정된 공간이 버퍼에 있어야 합니다.

세부정보

매개변수

[in] aReservedSize

- 헤더에 필요한 바이트 수입니다.

반환

요청된 예약된 크기를 사용할 수 있는 경우 true, 버퍼에 공간이 충분하지 않으면 false입니다.

MaxDataLength

uint16_t MaxDataLength(
  void
) const

현재 시작 위치와 버퍼 크기를 고려하여 버퍼에 들어가는 최대 데이터 양(바이트)을 가져옵니다.

세부정보
반환	현재 시작 위치를 고려하여 버퍼에 맞는 바이트 수입니다.

PacketBuffer * Next(
  void
) const

체인에 있는 다음 버퍼를 가리키는 포인터를 가져옵니다.

세부정보
반환	체인의 다음 버퍼를 가리키는 포인터입니다. 체인에 버퍼가 없으면 `NULL`가 반환됩니다.

ReservedSize

uint16_t ReservedSize(
  void
) const

버퍼 시작과 현재 데이터 시작 위치 사이의 현재 버퍼 내에서 바이트 수를 가져옵니다.

세부정보
반환	버퍼의 시작과 현재 데이터 시작 위치 사이의 공간 크기(바이트)입니다.

SetDataLength

void SetDataLength(
  uint16_t aNewLen,
  PacketBuffer *aChainHead
)

버퍼에 있는 데이터의 길이를 바이트 단위로 설정하고 이에 따라 총 길이를 조정합니다.

이 함수는 버퍼에 있는 데이터의 길이를 바이트 단위로 설정하고 총 길이를 적절하게 조정합니다. 버퍼가 버퍼 체인의 헤드가 아닌 경우 (일반적인 경우: 호출자가 상위 레이어를 호출하기 전에 PacketBuffer 체인의 마지막 버퍼에 데이터를 추가함) aChainHead가 반드시 전달되어 현재 버퍼보다 앞서 각 버퍼의 총 길이를 적절하게 조정합니다.

세부정보

매개변수

`[in] aNewLen`	- 이 버퍼의 새 길이(바이트)입니다.
`[in,out] aChainHead`	- 현재 버퍼가 속한 버퍼 체인의 헤드. 현재 버퍼가 버퍼 체인의 헤드인 경우 NULL일 수 있습니다.

SetStart

void SetStart(
  uint8_t *aNewStart
)

시작 데이터를 버퍼에 설정하고 이에 따라 길이와 총 길이를 조정합니다.

세부정보

매개변수

[in] aNewStart

- 새 페이로드가 시작해야 하는 위치를 가리키는 포인터입니다. newStart는 PacketBuffer 체인의 첫 번째 버퍼의 경계 내에 속하도록 내부적으로 조정됩니다.

시작

uint8_t * Start(
  void
) const

버퍼의 데이터 시작을 가리키는 포인터를 가져옵니다.

세부정보
반환	데이터의 시작을 가리키는 포인터입니다.

TotalLength

uint16_t TotalLength(
  void
) const

버퍼 체인에서 패킷 데이터의 전체 길이를 가져옵니다.

세부정보
반환	총 길이(옥텟)입니다.

공개 정적 함수

무료

void Free(
  PacketBuffer *aPacket
)

체인의 모든 패킷 버퍼를 해제합니다.

현재 체인의 모든 버퍼에 대한 참조 수를 줄입니다. 참조 수가 0에 도달하면 각 버퍼가 해제되거나 적절하게 할당 풀로 반환됩니다. 일반적으로 사용자는 이 메서드를 free() 함수와 동등한 것으로 취급하고 호출 후 인수를 사용하지 않아야 합니다.

세부정보

매개변수

[in] aPacket

- 해제될 패킷 버퍼.

FreeHead

PacketBuffer * FreeHead(
  PacketBuffer *aPacket
)

체인의 첫 번째 버퍼를 해제하고 나머지 버퍼를 가리키는 포인터를 반환합니다.

* @note When the buffer chain is referenced by multiple callers,FreeHead()` 가 헤드를 분리하지만 헤드 버퍼를 강제로 할당 해제하지는 않습니다.

세부정보

매개변수

[in] aPacket

- 버퍼 체인

반환

입력 버퍼의 꼬리로 구성된 패킷 버퍼 체인 (NULL일 수 있음)입니다.

신규

PacketBuffer * New(
  void
)

페이로드에 예약된 기본 크기 (WEAVE_SYSTEM_CONFIG_HEADER_RESERVE_SIZE)와 함께 기본 최대 크기 (WEAVE_SYSTEM_CONFIG_PACKETBUFFER_CAPACITY_MAX)의 단일 PacketBuffer를 할당합니다.

예약된 크기 (WEAVE_SYSTEM_CONFIG_HEADER_RESERVE_SIZE)는 전송 계층 헤더와 WeaveMessageLayer 및 WeaveExchangeLayer에 필요한 헤더를 보관할 수 있을 만큼 큽니다.

신규

PacketBuffer * New(
  uint16_t aReservedSize
)

특정 헤더 예약 크기와 함께 최대 총 크기의 단일 PacketBuffer를 할당합니다.

전달되는 매개변수는 할당할 버퍼의 전체 크기가 아니라 다양한 스택 레이어의 패킷 헤더를 수용하기 위해 페이로드 이전에 예약된 크기입니다. 호출에 지정된 버퍼(WEAVE_SYSTEM_CONFIG_PACKETBUFFER_CAPACITY_MAX)의 크기입니다.

PacketBuffer::New(0) : 이 방식으로 호출하면 예약된 헤더 없이 버퍼가 반환되므로 호출자가 전체 페이로드를 사용할 수 있습니다. 이 패턴은 네트워킹 스택의 하위 레이어에서 특히 유용합니다. 사용자는 페이로드가 적절한 헤더 예약을 통해 최종 메시지에 복사된다는 것을 알고 있거나 PacketBuffer::AddToEnd()를 통해 PacketBuffer 체인에 추가되는 PacketBuffer를 만드는 경우에 유용합니다. 매개변수

[in] aReservedSize

여유 공간이 확보됩니다.

반환

성공 시 PacketBuffer를 가리키는 포인터, 실패 시 NULL

NewWithAvailableSize

PacketBuffer * NewWithAvailableSize(
  size_t aAvailableSize
)

헤더의 페이로드에 예약된 기본 크기 (WEAVE_SYSTEM_CONFIG_HEADER_RESERVE_SIZE)와 함께 PacketBuffer를 할당하고 초기 커서 포인터 뒤에 추가 데이터를 위해 aAllocSize바이트 이상의 공간을 할당합니다.

이 사용법은 애플리케이션 레이어 메시지에 PacketBuffer를 할당할 때 가장 적합합니다.

세부정보

매개변수

[in] aAvailableSize

커서 뒤에 할당할 옥텟 수입니다.

반환

성공 시 할당된 블록의 PacketBuffer를 가리키는 포인터입니다. 실패 시 NULL. *

NewWithAvailableSize

PacketBuffer * NewWithAvailableSize(
  uint16_t aReservedSize,
  size_t aAvailableSize
)

헤더용 페이로드에 예약된 aReservedSize바이트 이상과 초기 커서 포인터 뒤에 추가 데이터를 위한 aAllocSize바이트 이상의 공간이 있는 PacketBuffer 객체를 할당합니다.

세부정보

매개변수

`[in] aReservedSize`	커서 뒤에 예약할 옥텟 수입니다.
`[in] aAvailableSize`	커서 뒤에 할당할 옥텟 수입니다.

반환

성공 시 할당된 블록의 PacketBuffer를 가리키는 포인터입니다. 실패 시 NULL.

RightSize

PacketBuffer * RightSize(
  PacketBuffer *aPacket
)

적절한 크기의 버퍼에 제공된 버퍼를 복사합니다(해당하는 경우).

이 함수는 소켓에서 작동하지 않습니다.

세부정보

매개변수

[in] aPacket

- 버퍼 또는 버퍼 체인

반환

원래 버퍼인 경우