Spring Cloud Azure kaynak işleme

Bu makale şunlar için geçerlidir: ✔️ Sürüm 4.14.0 ✔️ Sürüm 5.8.0

Spring projesi, bir dizi alt düzey kaynağa erişmek için bir Spring Resources soyutlaması sağlar. Proje, ResourceLoader ve ResourcePatternResolvergibi Resourcearabirimler sağlar. Spring Cloud Azure, Azure Depolama hizmetleri için bu arabirimleri uygulayarak Spring programlama modelini kullanarak Azure depolama Blobu ve Dosya Paylaşımı ile etkileşim kurmanızı sağlar. Spring Cloud Azure, Azure Depolama Blob ve spring-cloud-azure-starter-storage-file-share Azure Depolama Dosya Paylaşımı'nı otomatik olarak yapılandırma ve sağlarspring-cloud-azure-starter-storage-blob.

Aşağıdaki tabloda Azure Depolama ilgili kitaplıklar listeleniyor:

Bağımlılık kurulumu

<dependencies>
    <dependency>
        <groupId>com.azure.spring</groupId>
        <artifactId>spring-cloud-azure-starter-storage-blob</artifactId>
    </dependency>
    <dependency>
        <groupId>com.azure.spring</groupId>
        <artifactId>spring-cloud-azure-starter-storage-file-share</artifactId>
    </dependency>
</dependencies>

spring-cloud-azure-starter-storage-blob Bağımlılık yalnızca Azure Depolama Blob'unu kullanırken gereklidir.

spring-cloud-azure-starter-storage-file-share Bağımlılık yalnızca Azure Depolama Dosya Paylaşımı'nı kullanırken gereklidir.

Yapılandırma

Aşağıdaki tabloda, öğesinin yapılandırılabilir özellikleri spring-cloud-azure-starter-storage-bloblistelenir:

Aşağıdaki tabloda, öğesinin yapılandırılabilir özellikleri spring-cloud-azure-starter-storage-file-sharelistelenir:

Temel kullanım

Application.yml dosyanıza aşağıdaki özellikleri ekleyin:

spring:
  cloud:
    azure:
      storage:
        blob:
          account-name: ${STORAGE_ACCOUNT_NAME}
          account-key: ${STORAGE_ACCOUNT_KEY}
          endpoint: ${STORAGE_BLOB_ENDPOINT}
        fileshare:
          account-name: ${STORAGE_ACCOUNT_NAME}
          account-key: ${STORAGE_ACCOUNT_KEY}
          endpoint:  ${STORAGE_FILESHARE_ENDPOINT}

Kaynak alma

ile kaynak alma @Value

Aşağıdaki örnekte gösterildiği gibi bir blob kaynağını otomatik olarak bağlamak için ek açıklamasını @Value("azure-blob://[your-container-name]/[your-blob-name]") kullanabilirsiniz:

@Value("azure-blob://[your-container-name]/[your-blob-name]")
private Resource storageBlobResource;

Ek açıklamasını @Value("azure-file://[your-fileshare-name]/[your-file-name]") , aşağıdaki örnekte gösterildiği gibi bir dosya kaynağını otomatik olarak bağlamak için kullanabilirsiniz:

@Value("azure-file://[your-fileshare-name]/[your-file-name]")
private Resource storageFileResource;

ResourceLoader ile kaynak alma

@Autowired
private ResourceLoader resourceLoader;
...
// Get a BlobResource.
Resource storageBlobResource = resourceLoader.getResource("azure-blob://[your-container-name]/[your-blob-name]");

// Get a FileResource.
Resource storageFileResource = resourceLoader.getResource("azure-file://[your-fileshare-name]/[your-file-name]");

Deseni arayarak kaynakları alma

Kaynak aramak için uygulama sınıfını ResourcePatternResolver kullanabilirsiniz. Kaynakları aramak ve AzureStorageFileProtocolResolver kaynakları aramak file için kullanınAzureStorageBlobProtocolResolver.blob

• Desen araması için veya searchPatternazure-file://ile azure-blob:// başlamalıdır. Örneğin, azure-blob://**/** tüm kapsayıcılardaki tüm blobları listeleme ve azure-blob://demo-container/** herhangi bir alt klasör de dahil olmak üzere kapsayıcıdaki demo-container tüm blobları listeleme anlamına gelir.

• Konum araması için veya searchLocation ile azure-blob://azure-file:// başlamalıdır ve kalan dosya yolu bulunmalıdır, aksi takdirde bir özel durum oluşturulur.

@Autowired
private AzureStorageBlobProtocolResolver azureStorageBlobProtocolResolver;

@Autowired
private AzureStorageFileProtocolResolver azureStorageFileProtocolResolver;

// Get all text blobs.
Resource[] blobTextResources = azureStorageBlobProtocolResolver.getResources("azure-blob://[container-pattern]/*.txt");

// Get all text files.
Resource[] fileTextResources = azureStorageFileProtocolResolver.getResources("azure-file://[fileshare-pattern]/*.txt");

Kaynakla işleme

Belirli bir kaynaktan veri indirme

Azure Depolama Blob'dan veya Dosya Paylaşımı'ndan yöntemini Resourcekullanarak getInputStream() bir kaynak indirebilirsiniz.

@Value("azure-blob://[your-container-name]/[your-blob-name]")
private Resource storageBlobResource;

@Value("azure-file://[your-fileshare-name]/[your-file-name]")
private Resource storageFileResource;

//...

// Download data as a stream from a blob resource.
InputStream inputblobStream = storageBlobResource.getInputStream();

// Download data as a stream from a file resource.
InputStream inputfileStream = storageFileResource.getInputStream();

Verileri belirli bir kaynağa yükleme

Aşağıdaki örnekte gösterildiği gibi Spring'i Resource öğesine dönüştürerek Azure Blob'a WritableResourceveya dosya depolamaya bir kaynağa yükleyebilirsiniz:

@Value("azure-blob://[your-container-name]/[your-blob-name]")
private Resource storageBlobResource;

@Value("azure-file://[your-fileshare-name]/[your-file-name]")
private Resource storageFileResource;

String data = "sampledata";

// Upload string data to a blob.
try (OutputStream blobos = ((WritableResource) this.storageBlobResource).getOutputStream()) {
    blobos.write(data.getBytes());
}

// Upload string data to a file.
try (OutputStream fileos = ((WritableResource) this.storageFileResource).getOutputStream()) {
    fileos.write(data.getBytes());
}

Çok parçalı karşıya yükleme

4 MiB'den büyük dosyalar paralel olarak Azure Depolama'a yüklenir.

Örnekler

GitHub'da storage-blob-sample ve storage-file-sample depolarına bakın.