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

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

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

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

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 phần lớn phần cài đặt 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 cấu hình bắt buộc phải triển khai lấy danh sách đường dẫn hoặc danh sách dữ liệu được mã hoá TLV. Điều này sẽ 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 trường hợp trùng lặp mã vì nhà phát triển sau khi nhà phát triển viết cùng một mã để đóng gói và giải nén TLV, v.v. Để đơn giản hoá mọi thứ, chúng tôi cung cấp một loại "bộ công cụ quản lý dữ liệu".

Lớp phụ này hỗ trợ việc lưu trữ và truy xuất dữ liệu, với điều kiện là các lớp con ProfileData cụ thể cần thiết đã đượ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 đối tượng ProfileData trong cơ sở dữ liệu.
LookupProfileData(nl::Weave::TLV::TLVReader & aPathReader, ProfileData **aProfileData)
Tìm đố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
Tra cứu đối tượng ProfileData.
Retrieve(ReferencedTLVData & aPathList, ReferencedTLVData & aDataList)
Truy xuất một danh sách dữ liệu dựa vào một 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 trên danh sách đường dẫn.
Store(ReferencedTLVData & aDataList)
Lưu trữ 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 phụ trợ ProfileData bên trong trừu tượng.

Hàm công khai

LookupDataFromProfileDescriptor

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

Tìm đố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ể. Điều 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 lớp con ProfileDatabase cụ thể cung cấp.

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

LookupProfileData

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

Tìm đố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ể. Điều 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 lớp con ProfileDatabase cụ thể cung cấp.

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

LookupProfileData

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

Tra cứu đối tượng ProfileData.

Tìm một đối tượng ProfileData cụ thể bằng cách cung cấp một mã hồ sơ và một mã thực thể (không bắt buộc)< được cung cấp dưới dạng trình đọc TLV.

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

Truy xuất

WEAVE_ERROR Retrieve(
  ReferencedTLVData & aPathList,
  ReferencedTLVData & aDataList
)

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

Khi bạn cung cấp danh sách đường dẫn, hãy truy xuất danh sách dữ liệu chứa các phần tử của danh sách dữ liệu cho từng đường dẫn trong danh sách đường dẫn chứa dữ liệu là thiết bị đầu cuối của đường dẫn đó.

Thông tin chi tiết
Thông số
[in] aPathList
Tham chiếu đến đối tượng ReferencedTLVData chứa danh sách các đường dẫn được mã hoá TLV biểu thị dữ liệu cần truy xuất. Tham số này được duy trì 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 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 trên danh sách đường dẫn.

Cho sẵn một danh sách đường dẫn và một trình ghi TLV, viết một danh sách dữ liệu chứa các phần tử của danh sách dữ liệu cho từng đường dẫn trong danh sách đường dẫn và dữ liệu là cửa sổ cuối của đường dẫn đó.

Thông tin chi tiết
Thông số
[in] aPathList
Tham chiếu đến đối tượng ReferencedTLVData chứa danh sách đường dẫn TLV đại diện cho dữ liệu cần truy xuất. Tham số này được duy trì không đổi trong suốt quá trình thực thi hàm này.
[in] aWriter
Tham chiếu đến đối tượng 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 ghi 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 ghi ra danh sách dữ liệu mà bạn quan tâm.

Cửa hàng

WEAVE_ERROR Store(
  ReferencedTLVData & aDataList
)

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

Với một 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 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
Thông số
[in] aDataList
Tham chiếu đến đối tượng ReferencedTLVData chứa dữ liệu quan tâm ở dạng được 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 lưu trữ được 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
)