Java için Azure SDK'sını kullanma

Java için açık kaynak Azure SDK'sı, Java uygulama kodundan Azure kaynaklarını sağlamayı, yönetmeyi ve kullanmayı basitleştirir.

Önemli ayrıntılar

  • Yerel olarak veya bulutta çalıştırdığınız Java kodundan Azure hizmetlerle iletişim kurmak için Azure kitaplıklarını kullanın.
  • Kitaplıklar Java 8 ve üzerini destekler ve hem Java 8 temeli hem de en son Java uzun vadeli destek sürümüne göre test edilmiştir.
  • Kitaplıklar tam Java modülü desteği içerir; bu da bir Java modülünün gereksinimleriyle tamamen uyumlu oldukları ve kullanım için tüm ilgili paketleri dışarı aktardıkları anlamına gelir.
  • Java için Azure SDK yalnızca belirli Azure hizmetleriyle ilgili birçok ayrı Java kitaplığından oluşur. SDK başka araçlar içermez.
  • SDK'nın farklı "yönetim" ve "istemci" kitaplıkları vardır (bazen "yönetim düzlemi" ve "veri düzlemi" kitaplıkları olarak da adlandırılır). Her küme farklı amaçlara hizmet eder ve farklı kod türleri tarafından kullanılır. Daha fazla bilgi için bu makalenin devamında yer alan aşağıdaki bölümlere bakın:
  • Kitaplıklarla ilgili belgelere, Azure hizmetlerine göre düzenlenmiş Java için Azure Başvurusunda ya da paket adına göre düzenlenmiş Java API tarayıcısında ulaşabilirsiniz.

Diğer ayrıntılar

  • Java kitaplıkları için Azure SDK temel Azure REST API'sinin üzerinde derlenir, böylece bu API'leri tanıdık Java paradigmalar aracılığıyla kullanabilirsiniz. Ancak, dilerseniz REST API'yi doğrudan Java kodundan kullanabilirsiniz.
  • Azure kitaplıklarının kaynak kodunu GitHub deposundabulabilirsiniz. Açık kaynak bir proje olarak, katkılar memnuniyetle karşılanır!
  • Java için Azure SDK, kimlik doğrulama protokolleri, günlüğe kaydetme, izleme, aktarım protokolleri, arabelleğe alınan yanıtlar ve yeniden denemeler gibi yaygın bulut desenlerini paylaşacak şekilde güncelleştiriliyor.
    • Bu paylaşılan işlevsellik azure-core kitaplığında yer alır.
  • Kitaplıklara uygulanan yönergeler hakkında daha fazla bilgi için bkz. Java Azure SDK Tasarım Yönergeleri.

Java için Azure SDK için desteklenen platformlar

Java için Azure SDK, Java 8 ve sonraki sürümleri destekler; ancak geliştirme sırasında ve üretime dağıtım yaparken her zaman Java'nın en güncel uzun süreli destek (LTS) sürümünü kullanın. En son LTS sürümünü kullanmak hata düzeltmeleri, performans iyileştirmeleri ve güvenlik düzeltmeleri dahil olmak üzere Java'da en son iyileştirmelerin kullanılabilir olmasını sağlar. Ayrıca Java için Azure SDK, Java'nın sonraki sürümleri için ek destek içerir. Bu ek destek, performansı artırır ve desteklenen Java 8 temelinin ötesinde JDK'ye özgü geliştirmeler içerir.

Java için Azure SDK, Windows, Linux ve macOS üzerinde test edilir ve desteklenir. JDK'nin desteklediği diğer platformlarda test edilmemektedir ve Android dağıtımlarını desteklememektedir. Android cihazlarda dağıtım için yazılım geliştirmek isteyen ve Azure hizmetlerinden yararlanan geliştiriciler için, Android için Azure SDK'projesinde Android'e özgü kitaplıklar mevcuttur.

İstemci kitaplıklarıyla Azure kaynaklarına bağlanma ve bunları kullanma

İstemci (veya "veri düzlemi") kitaplıkları, önceden sağlanan hizmetlerle etkileşime geçmek için Java uygulama kodu yazmanıza yardımcı olur. İstemci kitaplıkları yalnızca bir istemci API'sini destekleyen hizmetler için mevcuttur. Maven grup kimlikleri com.azureolduğundan bunları tanımlayabilirsiniz.

Tüm Azure Java istemci kitaplıkları, bir istemci örneği oluşturmakla sorumlu bir Java oluşturucu sınıfı sunmakla aynı API tasarım desenini izler. Bu desen, istemcinin tanımını ve örneğini işleminden ayırır, böylece istemci sabittir ve kullanımı daha kolaydır. Ayrıca, tüm istemci kitaplıkları birkaç önemli deseni izler:

  • Hem zaman uyumlu hem de zaman uyumsuz API'leri destekleyen istemci kitaplıklarının bu API'leri ayrı sınıflarda sunması gerekir. Bu gereksinim şu anlama gelir: örneğin bu durumlarda, senkron API’ler için bir KeyVaultClient ve asenkron API’ler için bir KeyVaultAsyncClient vardır.

  • Hem senkron hem de asenkron API'leri oluşturma sorumluluğunu üstlenen tek bir oluşturucu sınıfı vardır. Oluşturucu, Builder dahil olmak üzere eşitleme istemci sınıfına benzer şekilde adlandırılır. Örneğin, KeyVaultClientBuilder. Bu oluşturucu, istemci örnekleri oluşturmak için uygun buildClient() ve buildAsyncClient() yöntemlerine sahiptir.

Bu kurallar nedeniyle, Client ile biten tüm sınıflar sabittir ve bir Azure hizmetiyle etkileşime geçmek için işlemler sağlar. ClientBuilder ile biten tüm sınıflar, belirli bir istemci türünün örneğini yapılandırmaya ve oluşturmaya yönelik işlemler sağlar.

İstemci kitaplıkları örneği

Aşağıdaki kod örneğinde zaman uyumlu key vault KeyClientnasıl oluşturulacağı gösterilmektedir:

KeyClient client = new KeyClientBuilder()
        .endpoint(<your Key Vault URL>)
        .credential(new DefaultAzureCredentialBuilder().build())
        .buildClient();

Aşağıdaki kod örneği, zaman uyumsuz bir Key Vault KeyAsyncClient'un nasıl oluşturulacağını göstermektedir:

KeyAsyncClient client = new KeyClientBuilder()
        .endpoint(<your Key Vault URL>)
        .credential(new DefaultAzureCredentialBuilder().build())
        .buildAsyncClient();

Her istemci kitaplığıyla çalışma hakkında daha fazla bilgi için, SDK GitHub deposunda kitaplığın proje dizininde bulunan README.md dosyasına bakın. Ayrıca başvuru belgelerinde ve Azure Örnekleri içinde daha fazla kod parçacığı bulabilirsiniz.

Yönetim kitaplıklarıyla Azure kaynaklarını sağlama ve yönetme

Yönetim (veya "yönetim düzlemi") kitaplıkları, Java uygulama kodundan Azure kaynakları oluşturmanıza, sağlamanıza ve yönetmenize yardımcı olur. Bu kitaplıkları com.azure.resourcemanager Maven grup kimliğinde bulabilirsiniz. Tüm Azure hizmetlerinin karşılık gelen yönetim kitaplıkları vardır.

Yönetim kitaplıklarını kullanarak, Azure portal veya Azure CLI aracılığıyla gerçekleştirebileceğiniz görevlerin aynısını gerçekleştirmek için yapılandırma ve dağıtım betikleri yazabilirsiniz.

Tüm Azure Java yönetim kitaplıkları, azure işlem hizmeti için *Manager veya popüler hizmetlerin toplanması için ComputeManager gibi bir hizmet API'si olarak AzureResourceManager sınıfı sağlar.

Yönetim kitaplıkları örneği

Aşağıdaki kod örneğinde ComputeManageroluşturma gösterilmektedir:

ComputeManager computeManager = ComputeManager
    .authenticate(
        new DefaultAzureCredentialBuilder().build(),
        new AzureProfile(AzureEnvironment.AZURE));

Aşağıdaki kod örneği, yeni bir sanal makinenin nasıl oluşturulacağını gösterir.

VirtualMachine virtualMachine = computeManager.virtualMachines()
    .define(<your virtual machine>)
    .withRegion(Region.US_WEST)
    .withExistingResourceGroup(<your resource group>)
    .withNewPrimaryNetwork("10.0.0.0/28")
    .withPrimaryPrivateIPAddressDynamic()
    .withoutPrimaryPublicIPAddress()
    .withPopularLinuxImage(KnownLinuxVirtualMachineImage.UBUNTU_SERVER_18_04_LTS)
    .withRootUsername(<virtual-machine username>)
    .withSsh(<virtual-machine SSH key>)
    .create();

Aşağıdaki kod örneğinde var olan bir sanal makinenin nasıl alınacakları gösterilmektedir:

VirtualMachine virtualMachine = computeManager.virtualMachines()
    .getByResourceGroup(<your resource group>, <your virtual machine>);

Aşağıdaki kod örneğinde sanal makinenin nasıl güncelleştirilip yeni bir veri diski ekleneceği gösterilmektedir:

virtualMachine.update()
    .withNewDataDisk(10)
    .apply();

Her yönetim kitaplığıyla çalışma hakkında daha fazla bilgi için SDK GitHub deposunda kitaplığın proje dizininde bulunan README.md dosyasına bakın. Ayrıca başvuru belgelerinde ve Azure Örnekleri içinde daha fazla kod parçacığı bulabilirsiniz.

Yardım alın ve SDK ekibiyle bağlantı kurun

Sonraki adımlar

Artık Java için Azure SDK’nın ne olduğunu anladığınıza göre, kitaplıkları kullanırken verimli olmanıza yardımcı olan birçok ortak kavramı inceleyin. Aşağıdaki makaleler iyi başlangıç noktaları sağlar:

  • Last updated on