Java ile blob kapsayıcısı oluşturma
Azure Depolama'daki bloblar kapsayıcılar halinde düzenlenir. Blobu karşıya yükleyebilmeniz için önce bir kapsayıcı oluşturmanız gerekir. Bu makalede Java için Azure Depolama istemci kitaplığı ile kapsayıcıların nasıl oluşturulacağı gösterilmektedir.
Önkoşullar
- Bu makalede, Java için Azure Blob Depolama istemci kitaplığıyla çalışmak üzere ayarlanmış bir projeniz olduğu varsayılır. Paket yükleme, yönerge ekleme
import
ve yetkili istemci nesnesi oluşturma dahil olmak üzere projenizi ayarlama hakkında bilgi edinmek için bkz. Azure Depolama ve Java ile Çalışmaya Başlama. - Yetkilendirme mekanizmasının blob kapsayıcısı oluşturma izinleri olmalıdır. Daha fazla bilgi edinmek için aşağıdaki REST API işlemi için yetkilendirme kılavuzuna bakın:
Kapsayıcı adlandırma hakkında
Kapsayıcı adı, kapsayıcıyı veya bloblarını ele almak için kullanılan benzersiz URI'nin bir parçasını oluşturduğundan geçerli bir DNS adı olmalıdır. Kapsayıcıyı adlandırırken şu kuralları izleyin:
- Kapsayıcı adları 3 ile 63 karakter uzunluğunda olabilir.
- Kapsayıcı adları bir harf veya sayı ile başlamalıdır ve yalnızca küçük harfler, sayılar ve tire (-) karakteri içerebilir.
- Kapsayıcı adlarında ardışık tire karakterlerine izin verilmez.
Kapsayıcı kaynağının URI'si aşağıdaki gibi biçimlendirilir:
https://my-account-name.blob.core.windows.net/my-container-name
Kapsayıcı oluşturma
Kapsayıcı oluşturmak için sınıfından aşağıdaki yöntemlerden birini çağırın BlobServiceClient
:
Sınıfından aşağıdaki yöntemlerden BlobContainerClient
birini kullanarak da kapsayıcı oluşturabilirsiniz:
Kapsayıcılar depolama hesabının hemen altında oluşturulur. Bir kapsayıcıyı başka bir kapsayıcının altına yerleştirmek mümkün değildir. ve createBlobContainer
yöntemleri içincreate
, aynı ada sahip bir kapsayıcı zaten varsa bir özel durum oluşturulur.
Aşağıdaki örnek bir nesneden kapsayıcı BlobServiceClient
oluşturur:
public BlobContainerClient createContainer(BlobServiceClient blobServiceClient, String containerName) {
// Create the container using the service client object
BlobContainerClient blobContainerClient = blobServiceClient.createBlobContainer(containerName);
return blobContainerClient;
}
Kök kapsayıcıyı oluşturma
Kök kapsayıcı, depolama hesabınız için varsayılan kapsayıcı görevi görür. Her depolama hesabının bir kök kapsayıcısı olabilir ve bu kapsayıcı $root olarak adlandırılmalıdır. Kök kapsayıcı açıkça oluşturulmalıdır veya silinmelidir.
Kök kapsayıcı adını eklemeden kök kapsayıcıda depolanan bir bloba başvurabilirsiniz. Kök kapsayıcı, depolama hesabı hiyerarşisinin en üst düzeyinde bir bloba başvurmanızı sağlar. Örneğin, kök kapsayıcıdaki bir bloba aşağıdaki şekilde başvurabilirsiniz:
https://accountname.blob.core.windows.net/default.html
Aşağıdaki örnek, $root kapsayıcı adıyla yeni BlobContainerClient
bir nesne oluşturur ve depolama hesabında henüz yoksa kapsayıcıyı oluşturur:
public void createRootContainer(BlobServiceClient blobServiceClient) {
// Creates a new BlobContainerClient object by appending the containerName to
// the end of the URI
BlobContainerClient blobContainerClient = blobServiceClient.getBlobContainerClient("$root");
// If the container does not already exist, create it using the container client
blobContainerClient.createIfNotExists();
}
Kaynaklar
Java için Azure Blob Depolama istemci kitaplığını kullanarak kapsayıcı oluşturma hakkında daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın.
REST API işlemleri
Java için Azure SDK' sı, Azure REST API'sinin üzerinde derleyerek tanıdık Java paradigmalarıyla REST API işlemleriyle etkileşim kurmanızı sağlayan kitaplıklar içerir. Kapsayıcı oluşturmaya yönelik istemci kitaplığı yöntemleri aşağıdaki REST API işlemini kullanır:
- Kapsayıcı Oluşturma (REST API)