DataBuffer

Mengunjungi penyimpanan pendukung buffer ini.

Implementasi buffer bertanggung jawab untuk meneruskan kembali referensi ke penyimpanan data aktual kepada pengunjung yang disediakan. Pengunjung tidak harus menangani semua kemungkinan jenis penyimpanan data dan hanya dapat mengganti metode penyimpanan yang benar-benar diminati. Untuk jenis penyimpanan lainnya, panggilan ini akan kembali ke fallback() sehingga pengunjung dapat menjalankan beberapa rutinitas umum jika diperlukan.

Tulis referensi objek dalam array sumber ke dalam buffer ini.

Jika ada lebih banyak nilai untuk disalin daripada ukuran buffer tujuan, yaitu size > dst.size() , maka tidak ada nilai yang ditransfer dan BufferOverflowException dilempar. Di sisi lain, jika ada lebih banyak nilai untuk disalin daripada ukuran buffer sumber, yaitu > src.size() , maka BufferUnderfloatException akan dilempar.

Jika tidak, metode ini akan menyalin nilai n = size dari buffer ini ke buffer tujuan.

Memeriksa kesetaraan antara buffer data.

Buffer data sama dengan objek lain jika objek ini adalah DataBuffer lain dengan ukuran, tipe, dan elemen yang sama serta dalam urutan yang sama. Misalnya:

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
 

Perhatikan bahwa komputasi yang diperlukan untuk memverifikasi kesetaraan antara dua buffer bisa mahal dalam beberapa kasus dan oleh karena itu, disarankan untuk tidak menggunakan metode ini di jalur kritis yang mengutamakan kinerja.

Membaca nilai pada indeks yang diberikan. Penting: Penggunaan metode ini harus dibatasi pada buffer tipe non-primitif atau ketika tipe data tidak diketahui secara deterministik oleh pemanggil. Dalam kasus lain, pilihlah penggunaan varian primitif yang akan meningkatkan kinerja secara signifikan (misalnya IntDataBuffer.getInt(idx)

Memberitahukan apakah buffer ini didukung oleh array yang dapat diakses atau tidak.

Membuat buffer baru yang kontennya merupakan kelanjutan bersama dari konten buffer ini, yang ukurannya diatur ke nilai yang ditentukan.

Ukuran baru tidak boleh lebih besar dari ukuran buffer ini. Perubahan pada konten buffer ini akan terlihat di buffer baru dan sebaliknya. Buffer baru akan bersifat read-only jika, dan hanya jika, buffer ini bersifat read-only.

Panggilan ini setara dengan slice(0, size)

Membuat buffer baru yang kontennya merupakan kelanjutan bersama dari konten buffer ini, dimulai dari indeks yang ditentukan.

Indeks tidak boleh lebih besar dari ukuran buffer ini. Perubahan pada konten buffer ini akan terlihat di buffer baru dan sebaliknya. Buffer baru akan bersifat read-only jika, dan hanya jika, buffer ini bersifat read-only.

Panggilan ini setara dengan slice(index, size() - index)

Baca referensi objek dalam buffer ini ke dalam array tujuan.

Metode ini mentransfer nilai dari buffer ini ke array tujuan tertentu. Jika nilai dalam buffer lebih sedikit daripada yang diperlukan untuk memenuhi permintaan, yaitu jika dst.length > size() , maka tidak ada nilai yang ditransfer dan BufferUnderflowException dilempar.

Jika tidak, metode ini akan menyalin nilai n = dst.length dari buffer ini ke dalam array yang diberikan.

Baca referensi objek dalam buffer ini ke dalam array tujuan.

Metode ini mentransfer nilai dari buffer ini ke array tujuan tertentu. Jika ada lebih sedikit nilai dalam buffer daripada yang dibutuhkan untuk memenuhi permintaan, yaitu, jika length > size() , maka tidak ada nilai yang ditransfer dan BufferUnderflowException dilempar.

Jika tidak, metode ini akan menyalin nilai n = length dari buffer ini ke dalam larik tertentu mulai dari offset tertentu.

Menulis nilai yang diberikan ke dalam buffer ini pada indeks yang diberikan. Penting: Penggunaan metode ini harus dibatasi pada buffer tipe non-primitif atau ketika tipe data tidak diketahui secara deterministik oleh pemanggil. Dalam kasus lain, pilihlah penggunaan varian primitif yang akan meningkatkan kinerja secara signifikan (misalnya IntDataBuffer.setInt(idx)

Ukuran buffer, dalam elemen.

Misalnya, dalam kasus buffer byte, nilai ini sama dengan jumlah byte yang dapat ditampung oleh buffer ini. Untuk buffer bilangan bulat sama dengan jumlah bilangan bulat, oleh karena itu ukuran buffer ini dalam byte adalah size() * Integer.BYTES .

Membuat buffer baru yang kontennya merupakan kelanjutan bersama dari konten buffer ini, dimulai dari indeks tertentu dan ukuran tertentu.

Indeks ditambah ukuran baru tidak boleh lebih besar dari ukuran buffer ini. Perubahan pada konten buffer ini akan terlihat di buffer baru dan sebaliknya. Buffer baru akan bersifat read-only jika, dan hanya jika, buffer ini bersifat read-only.

Membuat DataBufferWindow yang menyediakan sebagian tampilan buffer ini.

Jendela yang dibuat memiliki ukuran tetap dan dapat "slide" di sepanjang buffer ini untuk memberikan tampilan data yang berbeda tanpa mengalokasikan instance buffer baru, seperti yang dilakukan offset(long) . Hal ini meningkatkan kinerja secara keseluruhan bila operasi ini sering diulang. Misalnya:

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

Objek yang dikembalikan bersifat stateful dan tidak aman untuk thread.

Tulis referensi objek dalam array sumber ke dalam buffer ini.

Metode ini mentransfer nilai dalam array sumber tertentu ke dalam buffer ini. Jika ada lebih banyak nilai dalam array sumber daripada di buffer ini, yaitu jika src.length > size() , maka tidak ada nilai yang ditransfer dan BufferOverflowException dilempar.

Jika tidak, metode ini akan menyalin nilai n = src.length dari array yang diberikan.

Metode penempatan massal, menggunakan array int.

Metode ini mentransfer nilai dalam array sumber tertentu ke dalam buffer ini. Jika ada lebih banyak nilai dalam array sumber daripada di buffer ini, yaitu jika length > size() , maka tidak ada nilai yang ditransfer dan BufferOverflowException dilempar.

Jika tidak, metode ini akan menyalin nilai n = length dari larik tertentu ke dalam buffer ini, dimulai dari offset yang ditentukan.