مشاركة عبر

إنشاء حاوية كائن ثنائي كبير الحجم باستخدام Java

  • مقالة

يتم تنظيم الكائنات الثنائية في تخزين Azure ضمن حاويات. قبل أن تتمكن من تحميل كائن ثنائي كبير الحجم، عليك أولاً إنشاء حاوية. توضح هذه المقالة كيفية إنشاء حاويات باستخدام مكتبة عميل Azure Storage ل Java.

المتطلبات الأساسية

  • تفترض هذه المقالة أن لديك بالفعل مشروعا تم إعداده للعمل مع مكتبة عميل Azure Blob Storage ل Java. للتعرف على إعداد مشروعك، بما في ذلك تثبيت الحزمة وإضافة import التوجيهات وإنشاء كائن عميل معتمد، راجع بدء استخدام Azure Storage وJava.
  • يجب أن يكون لآلية التخويل أذونات لإنشاء حاوية كائن ثنائي كبير الحجم. لمعرفة المزيد، راجع إرشادات التخويل لعملية REST API التالية:

حول تسمية الحاوية

يجب أن يكون اسم الحاوية اسم DNS صالحاً، لأنه يشكل جزءاً من عنوان URI الفريد المستخدم لمعالجة الحاوية أو كائناتها الثنائية كبيرة الحجم. اتبع هذه القواعد عند تسمية حاوية:

  • يمكن اختيار أسماء الحاويات بحيث يتراوح طولها بين 3 أحرف و63 حرفاً.
  • يجب أن تبدأ أسماء الحاويات بحرف أو رقم، ويمكن أن تحتوي فقط على أحرف صغيرة و أرقام وحرف الشرطة (-).
  • لا يسمح بأحرف الشرطة المتتالية في أسماء الحاويات.

يتم تنسيق URI لمورد حاوية كما يلي:

https://my-account-name.blob.core.windows.net/my-container-name

إنشاء حاوية

لإنشاء حاوية، قم باستدعاء إحدى الطرق التالية من BlobServiceClient الفئة :

يمكنك أيضا إنشاء حاوية باستخدام إحدى الطرق التالية من BlobContainerClient الفئة :

يتم إنشاء الحاويات مباشرةً أسفل حساب التخزين. ليس من الممكن وضع حاوية واحدة أسفل أخرى. بالنسبة للأساليب create و createBlobContainer ، يتم طرح استثناء إذا كانت حاوية بنفس الاسم موجودة بالفعل.

ينشئ المثال التالي حاوية من كائن BlobServiceClient :

public BlobContainerClient createContainer(BlobServiceClient blobServiceClient, String containerName) {
    // Create the container using the service client object
    BlobContainerClient blobContainerClient = blobServiceClient.createBlobContainer(containerName);

    return blobContainerClient;
}

إنشاء حاوية الجذر

تعمل حاوية الجذر كحاوية افتراضية لحساب التخزين الخاص بك. قد يحتوي كل حساب تخزين على حاوية جذر واحدة، والتي يجب تسميتها «$root». يجب إنشاء حاوية الجذر أو حذفها بشكل صريح.

يمكنك الرجوع إلى نقطة مخزنة في حاوية الجذر دون تضمين اسم حاوية الجذر. تمكنك حاوية الجذر من الرجوع إلى نقطة في المستوى العلوي من التدرج الهرمي لحساب التخزين. على سبيل المثال، يمكنك الرجوع إلى نقطة موجودة في حاوية الجذر بالطريقة التالية:

https://accountname.blob.core.windows.net/default.html

ينشئ المثال التالي كائنا جديدا BlobContainerClient باسم الحاوية $root، ثم ينشئ الحاوية إذا لم تكن موجودة بالفعل في حساب التخزين:

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();
}

الموارد

لمعرفة المزيد حول إنشاء حاوية باستخدام مكتبة عميل Azure Blob Storage ل Java، راجع الموارد التالية.

عمليات واجهة برمجة تطبيقات REST

يحتوي Azure SDK ل Java على مكتبات تستند إلى واجهة برمجة تطبيقات AZURE REST، مما يسمح لك بالتفاعل مع عمليات REST API من خلال نماذج Java المألوفة. تستخدم أساليب مكتبة العميل لإنشاء حاوية عملية REST API التالية:

نماذج التعليمات البرمجية

موارد مكتبة العميل