nl::Weave::Profiles::DataManagement_Legacy::ProfileDatabase

Đây là một lớp trừu tượng.

#include <src/lib/profiles/data-management/Legacy/ProfileDatabase.h>

Lớp phụ trợ trừu tượng ProfileDatabase.

Tóm tắt

WDM tách biệt việc triển khai giao thức với việc triển khai quản lý dữ liệu và ít nhất về nguyên tắc, để lại hầu hết các công việc sau cho nhà phát triển ứng dụng. Tất cả các lệnh gọi thú vị trong WDM và tất cả phương thức trừu tượng mà nhà phát triển hồ sơ bắt buộc phải triển khai để lấy danh sách đường dẫn được mã hoá hoặc danh sách dữ liệu theo TLV. Điều này tạo gánh nặng cho nhà phát triển hồ sơ và trên thực tế, sẽ gây ra nhiều vấn đề trùng lặp mã vì nhà phát triển sau khi viết cùng một mã để đóng gói và giải nén TLV, v.v. Để dễ dàng hơn, chúng tôi cung cấp một loại "bộ công cụ quản lý dữ liệu".

Lớp phụ trợ này hỗ trợ việc lưu trữ và truy xuất dữ liệu miễn là các lớp con ProfileData cụ thể đã được cung cấp và thêm vào phương thức LookupProfileData() bên dưới.

Hàm công khai
LookupDataFromProfileDescriptor(nl::Weave::TLV::TLVReader & aDescReader, ProfileData **aProfileData)
Tìm một đối tượng ProfileData trong cơ sở dữ liệu.
LookupProfileData(nl::Weave::TLV::TLVReader & aPathReader, ProfileData **aProfileData)
Tìm một đối tượng ProfileData trong cơ sở dữ liệu.
LookupProfileData(uint32_t aProfileId, nl::Weave::TLV::TLVReader *aInstanceIdRdr, ProfileData **aResult)=0
virtual WEAVE_ERROR
Tìm một đối tượng ProfileData.
Retrieve(ReferencedTLVData & aPathList, ReferencedTLVData & aDataList)
Truy xuất danh sách dữ liệu dựa vào danh sách đường dẫn.
Retrieve(ReferencedTLVData & aPathList, nl::Weave::TLV::TLVWriter & aWriter)
Viết một danh sách dữ liệu dựa vào một danh sách đường dẫn.
Store(ReferencedTLVData & aDataList)
Lưu trữ một danh sách dữ liệu.

Hàm được bảo vệ
StoreInternal(nl::Weave::TLV::TLVReader & aPathReader, uint64_t aVersion, nl::Weave::TLV::TLVReader & aDataReader)

Lớp
nl::Weave::Profiles::DataManagement_Legacy::ProfileDatabase::ProfileData

Lớp bên trong phụ trợ trừu tượng ProfileData.

Hàm công khai

LookupDataFromProfileDescriptor

WEAVE_ERROR LookupDataFromProfileDescriptor(
  nl::Weave::TLV::TLVReader & aDescReader,
  ProfileData **aProfileData
)

Tìm một đối tượng ProfileData trong cơ sở dữ liệu.

Phương thức tiện ích này dùng để tìm các đối tượng ProfileData trong một ProfileDatabase cụ thể. Việc này phụ thuộc phần lớn vào các phương thức tra cứu do trình triển khai của lớp con ProfileDatabase cụ thể cung cấp.

Thông tin chi tiết
Tham số
[in] aDescReader
Tham chiếu đến trình đọc TLV được đặt tại một đường dẫn WDM – tức là đường dẫn TLV có phần mô tả cấu hình đầu tiên là phần tử đầu tiên.
[out] aProfileData
Con trỏ dùng để trả về một con trỏ đến đối tượng ProfileData quan tâm.
Trả về
WEAVE_NO_ERROR khi thành công, nếu không, hãy trả về WEAVE_ERROR cho biết không thể tra cứu đối tượng ProfileData phù hợp.

LookupProfileData

WEAVE_ERROR LookupProfileData(
  nl::Weave::TLV::TLVReader & aPathReader,
  ProfileData **aProfileData
)

Tìm một đối tượng ProfileData trong cơ sở dữ liệu.

Phương thức tiện ích này dùng để tìm các đối tượng ProfileData trong một ProfileDatabase cụ thể. Việc này phụ thuộc phần lớn vào các phương thức tra cứu do trình triển khai của lớp con ProfileDatabase cụ thể cung cấp.

Thông tin chi tiết
Tham số
[in] aPathReader
Tham chiếu đến trình đọc TLV được đặt tại một đường dẫn WDM – tức là đường dẫn TLV có phần mô tả cấu hình đầu tiên là phần tử đầu tiên.
[out] aProfileData
Con trỏ dùng để trả về một con trỏ đến đối tượng ProfileData quan tâm.
Trả về
WEAVE_NO_ERROR khi thành công, nếu không, hãy trả về WEAVE_ERROR cho biết không thể tra cứu đối tượng ProfileData phù hợp.

LookupProfileData

virtual WEAVE_ERROR LookupProfileData(
  uint32_t aProfileId,
  nl::Weave::TLV::TLVReader *aInstanceIdRdr,
  ProfileData **aResult
)=0

Tìm một đối tượng ProfileData.

Tra cứu một đối tượng ProfileData cụ thể dựa vào mã hồ sơ và mã phiên bản (không bắt buộc)< được cung cấp dưới dạng trình đọc TLV.

Thông tin chi tiết
Tham số
[in] aProfileId
Số hồ sơ 32 bit của hồ sơ bạn quan tâm.
[in] aInstanceIdRdr
Con trỏ trỏ đến trình đọc TLV được đặt tại dữ liệu giá trị nhận dạng thực thể. Nếu bạn không cung cấp giá trị nhận dạng thực thể thì giá trị này sẽ là NULL.
[out] aResult
Con trỏ dùng để trả về một con trỏ đến đối tượng ProfileData quan tâm.
Trả về
WEAVE_NO_ERROR Khi thành công. Nếu không, hãy trả về WEAVE_ERROR cho biết không thể tìm thấy đối tượng ProfileData.

Truy xuất

WEAVE_ERROR Retrieve(
  ReferencedTLVData & aPathList,
  ReferencedTLVData & aDataList
)

Truy xuất danh sách dữ liệu dựa vào danh sách đường dẫn.

Khi đã cung cấp một danh sách đường dẫn, hãy truy xuất một danh sách dữ liệu chứa các phần tử danh sách dữ liệu cho mỗi đường dẫn trong đường dẫn liệt kê dữ liệu là điểm cuối của đường dẫn đó.

Thông tin chi tiết
Tham số
[in] aPathList
Tham chiếu đến đối tượng ReferencedTLVData chứa danh sách các đường dẫn được mã hoá theo TLV biểu thị dữ liệu cần truy xuất. Tham số này không đổi trong suốt quá trình thực thi hàm này.
[out] aDataList
Tham chiếu đến đối tượng ReferencedTLVData để ghi kết quả được truy xuất. Độ dài dữ liệu chỉ được điều chỉnh sau khi thực thi thành công hàm này.
Trả về
WEAVE_NO_ERROR Khi thành công. Nếu không, hãy trả về WEAVE_ERROR cho biết không truy xuất được danh sách dữ liệu bạn quan tâm.

Truy xuất

WEAVE_ERROR Retrieve(
  ReferencedTLVData & aPathList,
  nl::Weave::TLV::TLVWriter & aWriter
)

Viết một danh sách dữ liệu dựa vào một danh sách đường dẫn.

Đối với danh sách các đường dẫn và người ghi TLV, hãy viết một danh sách dữ liệu chứa các phần tử danh sách dữ liệu cho từng đường dẫn trong danh sách đường dẫn đó, cũng như dữ liệu là điểm cuối của đường dẫn đó.

Thông tin chi tiết
Tham số
[in] aPathList
Tham chiếu đến đối tượng ReferencedTLVData chứa danh sách các đường dẫn TLV biểu thị dữ liệu cần truy xuất. Tham số này không đổi trong suốt quá trình thực thi hàm này.
[in] aWriter
Tham chiếu đến trình ghi TLV để sử dụng khi viết danh sách đường dẫn được truy xuất. Trạng thái nội bộ của người viết có thể không khôi phục được trong trường hợp xảy ra lỗi.
Trả về
WEAVE_NO_ERROR Khi thành công. Nếu không, hãy trả về WEAVE_ERROR cho biết không truy xuất được dữ liệu hoặc không ghi danh sách dữ liệu cần quan tâm.

Cửa hàng

WEAVE_ERROR Store(
  ReferencedTLVData & aDataList
)

Lưu trữ một danh sách dữ liệu.

Với danh sách dữ liệu được mã hoá TLV, phương thức này sẽ trải qua quá trình phân tích cú pháp danh sách đó và gọi các phương thức cụ thể do các trình triển khai lớp con ProfileDatabase cung cấp để đặt dữ liệu được tham chiếu vào đúng vị trí.

Thông tin chi tiết
Tham số
[in] aDataList
Tham chiếu đến đối tượng ReferencedTLVData chứa dữ liệu quan tâm ở dạng mã hoá TLV.
Trả về
WEAVE_NO_ERROR Khi thành công. Nếu không, hãy trả về WEAVE_ERROR cho biết không thể lưu trữ dữ liệu quan tâm.

Hàm được bảo vệ

StoreInternal

WEAVE_ERROR StoreInternal(
  nl::Weave::TLV::TLVReader & aPathReader,
  uint64_t aVersion,
  nl::Weave::TLV::TLVReader & aDataReader
)