Sdílet prostřednictvím


Základní koncepty sady Azure SDK pro C++

Sada Azure SDK pro C++ poskytuje sadu knihoven navržených tak, aby vývojářům jazyka C++ pomohla integrovat služby Azure do svých aplikací. Tento článek popisuje základní koncepty, které jsou základem sady SDK, včetně rozlišení mezi rovinami dat a správy, rolí Azure Core, konvencí vytváření názvů balíčků, klientských objektů a možností konfigurace. Pochopení těchto základních konceptů vám umožní efektivně používat sadu SDK v aplikacích C++.

Datová plocha a plocha správy

Sada Azure SDK pro C++ poskytuje knihovny pro operace roviny dat, ale nenabízí knihovny pro operace roviny správy. Datové roviny knihoven se využívají k interakci s již zřízenými službami Azure. Pokud ke zřizování a správě prostředků Azure v jazyce C++ potřebujete knihovny roviny správy, ponechte problém v našem úložišti GitHub.

Azure Core vs. jiné knihovny

Knihovna Azure Core (azure-core) poskytuje základní funkce, které ostatní knihovny vytvářejí, aby poskytovaly specifické funkce pro různé služby Azure. Vývojáři potřebují porozumět roli Azure Core, aby mohli efektivně používat sadu SDK.

Mezi hlavní sdílené koncepty Azure::Core patří:

  • Zpracování streamovaných dat a vstupu/výstupu (I/O) prostřednictvím BodyStream a jeho odvozených typů.
  • Přístup k podrobnostem odpovědi HTTP pro vrácený model jakékoli operace klienta sady SDK prostřednictvím Response<T>.
  • Dotazování dlouhotrvajících operací (LRO) prostřednictvím Operation<T>.
  • Výjimky pro konzistentní hlášení chyb z požadavků služby prostřednictvím základního typu RequestFailedException.
  • Abstrakce přihlašovacích údajů Azure SDKTokenCredential.
  • Nahraditelná přenosová vrstva HTTP pro odesílání požadavků a přijímání odpovědí přes síť.
  • Kanál HTTP a zásady HTTP, jako je opakování a protokolování, lze konfigurovat prostřednictvím možností specifické pro klienta služby.

Schéma pojmenování balíčků

Sada Azure SDK pro C++ používá konzistentní schéma pojmenování: azure-<group_name>-<service_name>-<sub_service_name>. Každý název začíná řetězcem azure-, následovaným skupinou, službou a volitelně podslužbou. Jedná se například azure-security-keyvault-secrets o tajné kódy služby Azure Key Vault.

Klientské objekty

Klientské objekty v sadě Azure SDK pro C++ se používají k interakci se službami Azure. Každý objekt klienta odpovídá konkrétní službě Azure a poskytuje metody pro provádění operací s danou službou. Slouží například BlobClient k interakci se službou Azure Blob Storage.

Parametr Možnosti pro klientské objekty

Klientské objekty v sadě Azure SDK pro C++ mají metody, které pro přizpůsobení interakcí se službou přebírají parametr možností. Tyto parametry možností se dají použít k nastavení věcí, jako jsou vypršení časového limitu, zásady opakování a další konfigurace.