DataBuffer

يزور تخزين الدعم لهذا المخزن المؤقت.

يعد تنفيذ المخزن المؤقت مسؤولاً عن إعادة مرجع إلى تخزين البيانات الفعلي إلى الزائر المقدم. لا يتعين على الزائر التعامل مع جميع أنواع تخزين البيانات الممكنة ويمكنه فقط تجاوز طرق التخزين التي يهتم بها بالفعل. بالنسبة لأي نوع آخر من التخزين، سيرجع هذا الاستدعاء إلى fallback() حتى يتمكن الزائر من تنفيذ بعض الإجراءات العامة إذا ضروري.

اكتب مراجع الكائنات الموجودة في المصفوفة المصدر في هذا المخزن المؤقت.

إذا كان هناك قيم أكثر لنسخها من حجم المخزن المؤقت الوجهة، أي size > dst.size() ، فلن يتم نقل أي قيم وسيتم طرح BufferOverflowException. من ناحية أخرى، إذا كان هناك المزيد من القيم لنسخ حجم المخزن المؤقت المصدر، على سبيل المثال > src.size() ، فسيتم طرح BufferUnderfloatException.

بخلاف ذلك، تقوم هذه الطريقة بنسخ قيم n = size من هذا المخزن المؤقت إلى المخزن المؤقت الوجهة.

التحقق من المساواة بين مخازن البيانات المؤقتة.

يكون المخزن المؤقت للبيانات مساويًا لكائن آخر إذا كان هذا الكائن عبارة عن DataBuffer آخر بنفس الحجم والنوع والعناصر متساوية وبنفس الترتيب. على سبيل المثال:

IntDataBuffer buffer = DataBuffers.of(1, 2, 3);

 assertEquals(buffer, DataBuffers.of(1, 2, 3));  // true
 assertEquals(buffer, DataBuffers.ofObjects(1, 2, 3));  // true, as Integers are equal to ints
 assertNotEquals(buffer, DataBuffers.of(1, 2, 3, 0));  // false, different sizes
 assertNotEquals(buffer, DataBuffers.of(1, 3, 2));  // false, different order
 assertNotEquals(buffer, DataBuffers.of(1L, 2L, 3L));  // false, different types
 

لاحظ أن الحساب المطلوب للتحقق من المساواة بين مخزنين مؤقتين يمكن أن يكون مكلفًا في بعض الحالات، وبالتالي، يوصى بعدم استخدام هذه الطريقة في مسار حرج حيث يكون الأداء مهمًا.

يقرأ القيمة في الفهرس المحدد. هام: يجب أن يقتصر استخدام هذه الطريقة على المخازن المؤقتة للأنواع غير البدائية أو عندما لا يكون نوع البيانات معروفًا بشكل قاطع بواسطة المتصل. في أي حالة أخرى، يفضل استخدام متغيره البدائي الذي سيؤدي إلى تحسين الأداء بشكل ملحوظ (على سبيل المثال IntDataBuffer.getInt(idx)

يوضح ما إذا كان هذا المخزن المؤقت مدعومًا بمصفوفة يمكن الوصول إليها أم لا.

إنشاء مخزن مؤقت جديد يكون محتواه عبارة عن تسلسل مشترك لمحتوى هذا المخزن المؤقت، ويتم تعيين حجمه على القيمة المحددة.

يجب ألا يكون الحجم الجديد أكبر من حجم المخزن المؤقت هذا. ستكون التغييرات التي يتم إجراؤها على محتوى هذا المخزن المؤقت مرئية في المخزن المؤقت الجديد والعكس صحيح. سيكون المخزن المؤقت الجديد للقراءة فقط إذا كان هذا المخزن المؤقت للقراءة فقط.

هذه المكالمة تعادل slice(0, size)

إنشاء مخزن مؤقت جديد يكون محتواه عبارة عن تسلسل مشترك لمحتوى هذا المخزن المؤقت، بدءًا من الفهرس المحدد.

يجب ألا يكون الفهرس أكبر من حجم المخزن المؤقت هذا. ستكون التغييرات التي يتم إجراؤها على محتوى هذا المخزن المؤقت مرئية في المخزن المؤقت الجديد والعكس صحيح. سيكون المخزن المؤقت الجديد للقراءة فقط إذا كان هذا المخزن المؤقت للقراءة فقط.

هذه المكالمة تعادل slice(index, size() - index)

اقرأ مراجع الكائنات الموجودة في هذا المخزن المؤقت في المصفوفة الوجهة.

تقوم هذه الطريقة بنقل القيم من هذا المخزن المؤقت إلى مصفوفة الوجهة المحددة. إذا كان هناك قيم أقل في المخزن المؤقت مما هو مطلوب لتلبية الطلب، أي إذا كان dst.length > size() ، فلن يتم نقل أي قيم وسيتم طرح BufferUnderflowException.

بخلاف ذلك، تقوم هذه الطريقة بنسخ قيم n = dst.length من هذا المخزن المؤقت إلى المصفوفة المحددة.

اقرأ مراجع الكائنات الموجودة في هذا المخزن المؤقت في المصفوفة الوجهة.

تقوم هذه الطريقة بنقل القيم من هذا المخزن المؤقت إلى مصفوفة الوجهة المحددة. إذا كان هناك قيم أقل في المخزن المؤقت مما هو مطلوب لتلبية الطلب، أي إذا كان length > size() ، فلن يتم نقل أي قيم ويتم طرح BufferUnderflowException.

بخلاف ذلك، تقوم هذه الطريقة بنسخ قيم n = length من هذا المخزن المؤقت إلى المصفوفة المحددة بدءًا من الإزاحة المحددة.

يكتب القيمة المحددة في هذا المخزن المؤقت في الفهرس المحدد. هام: يجب أن يقتصر استخدام هذه الطريقة على المخازن المؤقتة للأنواع غير البدائية أو عندما لا يكون نوع البيانات معروفًا بشكل قاطع بواسطة المتصل. في أي حالة أخرى، يفضل استخدام متغيره البدائي الذي سيؤدي إلى تحسين الأداء بشكل ملحوظ (على سبيل المثال IntDataBuffer.setInt(idx)

حجم المخزن المؤقت، في العناصر.

على سبيل المثال، في حالة وجود مخزن مؤقت للبايت، فإن هذه القيمة تساوي عدد البايتات التي يمكن أن يحتفظ بها هذا المخزن المؤقت. بالنسبة للمخزن المؤقت للأعداد الصحيحة، فهو يساوي عدد الأعداد الصحيحة، وبالتالي فإن الحجم بالبايت لهذا المخزن المؤقت هو size() * Integer.BYTES .

إنشاء مخزن مؤقت جديد يكون محتواه عبارة عن تسلسل مشترك لمحتوى هذا المخزن المؤقت، بدءًا من الفهرس المحدد وبالحجم المحدد.

يجب ألا يكون الفهرس بالإضافة إلى الحجم الجديد أكبر من حجم المخزن المؤقت هذا. ستكون التغييرات التي يتم إجراؤها على محتوى هذا المخزن المؤقت مرئية في المخزن المؤقت الجديد والعكس صحيح. سيكون المخزن المؤقت الجديد للقراءة فقط إذا كان هذا المخزن المؤقت للقراءة فقط.

يقوم بإنشاء DataBufferWindow الذي يوفر عرضًا جزئيًا لهذا المخزن المؤقت.

النافذة التي تم إنشاؤها لها حجم ثابت ويمكنها "slide" على طول هذا المخزن المؤقت لتوفير طرق عرض مختلفة للبيانات دون تخصيص مثيل مخزن مؤقت جديد، كما يفعل offset(long) . يؤدي هذا إلى تحسين الأداء العام عند تكرار هذه العملية بشكل متكرر. على سبيل المثال:

IntDataBuffer bufferA = DataBuffers.ofInts(1024);
 // ... init buffer data
 IntDataBuffer bufferB = DataBuffers.ofInts(1, 2, 3, 4);

 // Return the index of the first occurrence of bufferB in bufferA using a sliding window
 DataBufferWindow<IntDataBuffer> windowA = bufferA.window(4);
 for (int i = 0; i < bufferA.size() - bufferB.size(); ++i) {
     if (windowA.slideTo(i).buffer().equals(bufferB)) {
         return i;
     
 }
 }

الكائن الذي تم إرجاعه ذو حالة وليس آمنًا لمؤشر الترابط.

اكتب مراجع الكائنات الموجودة في المصفوفة المصدر في هذا المخزن المؤقت.

تقوم هذه الطريقة بنقل القيم الموجودة في مصفوفة المصدر المحددة إلى هذا المخزن المؤقت. إذا كانت هناك قيم في المصفوفة المصدر أكثر من تلك الموجودة في هذا المخزن المؤقت، أي إذا كان src.length > size() ، فلن يتم نقل أي قيم وسيتم طرح BufferOverflowException.

بخلاف ذلك، تقوم هذه الطريقة بنسخ قيم n = src.length من المصفوفة المحددة.

طريقة الوضع المجمعة، باستخدام صفائف int.

تقوم هذه الطريقة بنقل القيم الموجودة في مصفوفة المصدر المحددة إلى هذا المخزن المؤقت. إذا كانت هناك قيم في المصفوفة المصدر أكثر من تلك الموجودة في هذا المخزن المؤقت، أي إذا كان length > size() ، فلن يتم نقل أي قيم وسيتم طرح BufferOverflowException.

بخلاف ذلك، تقوم هذه الطريقة بنسخ قيم n = length من المصفوفة المحددة إلى هذا المخزن المؤقت، بدءًا من الإزاحة المحددة.