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 را از آرایه داده شده در این بافر کپی می کند و از آفست داده شده شروع می شود.