Podstawowe pojęcia dotyczące zestawu Azure SDK dla języka C++

Zestaw Azure SDK dla języka C++ udostępnia zestaw bibliotek zaprojektowanych w celu ułatwienia deweloperom języka C++ integracji usług platformy Azure z aplikacjami. W tym artykule przedstawiono podstawowe pojęcia, które stanowią podstawę zestawu SDK, w tym rozróżnienie między płaszczyznami danych i zarządzania, rolą platformy Azure Core, konwencjami nazewnictwa pakietów, obiektami klienta i opcjami konfiguracji. Zrozumienie tych podstawowych pojęć umożliwi efektywne korzystanie z zestawu SDK w aplikacjach języka C++.

Płaszczyzna danych a płaszczyzna zarządzania

Zestaw Azure SDK dla języka C++ udostępnia biblioteki dla operacji płaszczyzny danych, ale nie oferuje bibliotek dla operacji płaszczyzny zarządzania. Biblioteki płaszczyzny danych są używane do interakcji z już aprowizowanymi usługami platformy Azure. Jeśli potrzebujesz bibliotek płaszczyzny zarządzania do aprowizowania zasobów platformy Azure i zarządzania nimi w języku C++, pozostaw problem w naszym repozytorium GitHub.

Azure Core kontra inne biblioteki

Biblioteka Azure Core (azure-core) udostępnia podstawowe funkcje, na których bazują inne biblioteki, aby zapewnić określone funkcje dla różnych usług Azure. Deweloperzy muszą zrozumieć rolę platformy Azure Core, aby efektywnie korzystać z zestawu SDK.

Główne wspólne pojęcia obejmują Azure::Core :

• Obsługa danych przesyłanych strumieniowo i danych wejściowych/wyjściowych (We/Wy) za pośrednictwem BodyStream wraz z ich typami pochodnymi.
• Uzyskiwanie dostępu do szczegółów odpowiedzi HTTP dla zwróconego modelu dowolnej operacji klienta zestawu SDK za pośrednictwem polecenia Response<T>.
• Sondowanie długotrwałych operacji (LRO) za pośrednictwem metody Operation<T>.
• Wyjątki dotyczące spójnego raportowania błędów z żądań obsługi za pośrednictwem podstawowego typu wyjątku RequestFailedException.
• Abstrakcje dla poświadczeń Azure SDK TokenCredential.
• Zastępowana warstwa transportu HTTP do wysyłania żądań i odbierania odpowiedzi za pośrednictwem sieci.
• Potok HTTP i zasady HTTP, takie jak ponawianie i rejestrowanie, które można skonfigurować za pośrednictwem opcji specyficznych dla klienta usługi.

Schemat nazewnictwa pakietów

Zestaw Azure SDK dla języka C++ używa spójnego schematu nazewnictwa: azure-<group_name>-<service_name>-<sub_service_name>. Każda nazwa zaczyna się od azure-, a następnie grupą, usługą i opcjonalnie podusługą. Na przykład azure-security-keyvault-secrets odnosi się do sekrety usługi Azure Key Vault.

Obiekty klienta

Obiekty klienta w zestawie Azure SDK dla języka C++ są używane do interakcji z usługami platformy Azure. Każdy obiekt klienta odpowiada określonej usłudze platformy Azure i udostępnia metody wykonywania operacji na tej usłudze. Na przykład BlobClient służy do interakcji z usługą Azure Blob Storage.

Parametr opcji dla obiektów klienta

Obiekty klienta w zestawie Azure SDK dla języka C++ mają metody, które przyjmują parametr opcji dostosowywania interakcji z usługą. Te parametry opcji mogą służyć do ustawiania elementów, takich jak limity czasu, zasady ponawiania prób i inne konfiguracje.