مشاركة عبر

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

  • مقالة

عند سرد الحاويات في حساب Azure Storage من التعليمات البرمجية الخاصة بك، يمكنك تحديد عدة خيارات لإدارة كيفية إرجاع النتائج من Azure Storage. توضح هذه المقالة كيفية سرد الحاويات باستخدام مكتبة عميل Azure Storage ل Java.

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

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

حول خيارات سرد الحاوية

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

لسرد الحاويات في حساب تخزين، قم باستدعاء الطريقة التالية:

يقوم هذا الأسلوب بإرجاع قابل للتكبير من النوع BlobContainerItem. يتم ترتيب الحاويات معجميا بالاسم.

إدارة عدد النتائج التي يتم إرجاعها

بشكل افتراضي، تعرض عملية السرد ما يصل إلى 5000 نتيجة في المرة الواحدة. لإرجاع مجموعة أصغر من النتائج، قم بتوفير قيمة غير صفرية لحجم صفحة النتائج المراد إرجاعها. يمكنك تعيين هذه القيمة باستخدام الأسلوب التالي:

توضح لك الأمثلة المعروضة في هذه المقالة كيفية عرض النتائج في الصفحات. لمعرفة المزيد حول مفاهيم ترقيم الصفحات، راجع ترقيم الصفحات باستخدام Azure SDK ل Java.

تصفية النتائج باستخدام البادئة

لتصفية قائمة الحاويات، حدد سلسلة للمعلمة prefix. يمكن أن تتضمن سلسلة البادئة حرفاً واحداً أو أكثر. ثم يقوم Azure Storage بإرجاع الحاويات التي تبدأ أسماؤها بهذه البادئة فقط. يمكنك تعيين هذه القيمة باستخدام الأسلوب التالي:

تضمين بيانات تعريف الحاوية

لتضمين بيانات تعريف الحاوية مع النتائج، قم بإنشاء مثيل BlobContainerListDetails وتمرير true إلى الأسلوب التالي:

ثم مرر BlobContainerListDetails الكائن إلى الأسلوب التالي:

تضمين الحاويات المحذوفة

لتضمين حاويات محذوفة مبدئيا مع النتائج، قم بإنشاء مثيل BlobContainerListDetails وتمرير true إلى الأسلوب التالي:

ثم مرر BlobContainerListDetails الكائن إلى الأسلوب التالي:

أمثلة على التعليمات البرمجية

يسرد المثال التالي الحاويات ويصفي النتائج حسب بادئة محددة:

public void listContainers(BlobServiceClient blobServiceClient) {
    // Set a prefix to filter results based on a specified character or string
    ListBlobContainersOptions options = new ListBlobContainersOptions()
            .setPrefix("container-");

    System.out.println("List containers:");
    for (BlobContainerItem blobContainerItem : blobServiceClient.listBlobContainers(options, null)) {
        System.out.printf("Container name: %s%n", blobContainerItem.getName());
    }
}

يمكنك أيضا إرجاع مجموعة أصغر من النتائج، عن طريق تحديد حجم صفحة النتائج لإرجاعها:

public void listContainersWithPaging(BlobServiceClient blobServiceClient) {
    // Set a prefix to filter results and specify a page limit
    ListBlobContainersOptions options = new ListBlobContainersOptions()
            .setMaxResultsPerPage(2)  // Low number for demonstration purposes
            .setPrefix("container-");

    int i = 0;
    Iterable<PagedResponse<BlobContainerItem>> blobContainerPages = blobServiceClient
            .listBlobContainers(options, null).iterableByPage();
    for (PagedResponse<BlobContainerItem> page : blobContainerPages) {
        System.out.printf("Page %d%n", ++i);
        page.getElements().forEach(container -> {
            System.out.printf("Name: %s%n", container.getName());
        });
    }
}

الموارد

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

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

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

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

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

(راجع أيضًا )