DataBuffer

Thăm bộ nhớ đệm của bộ đệm này.

Việc triển khai bộ đệm có trách nhiệm chuyển lại tham chiếu đến nơi lưu trữ dữ liệu thực tế cho khách truy cập được cung cấp. Khách truy cập không phải xử lý tất cả các loại lưu trữ dữ liệu có thể có và chỉ có thể ghi đè các phương thức lưu trữ mà họ thực sự quan tâm. Đối với bất kỳ loại lưu trữ nào khác, lệnh gọi này sẽ chuyển sang fallback() để khách truy cập có thể thực hiện một số quy trình chung nếu cần thiết.

Viết các tham chiếu của các đối tượng trong mảng nguồn vào bộ đệm này.

Nếu có nhiều giá trị cần sao chép hơn kích thước bộ đệm đích, tức là size > dst.size() thì không có giá trị nào được chuyển và BufferOverflowException sẽ được ném ra. Mặt khác, nếu có nhiều giá trị hơn để sao chép kích thước bộ đệm nguồn đó, tức là > src.size() , thì BufferUnderfloatException sẽ được đưa ra.

Mặt khác, phương thức này sao chép các giá trị n = size từ bộ đệm này vào bộ đệm đích.

Kiểm tra sự bình đẳng giữa các bộ đệm dữ liệu.

Một bộ đệm dữ liệu bằng một đối tượng khác nếu đối tượng này là một DataBuffer khác có cùng kích thước, loại và các phần tử bằng nhau và theo cùng thứ tự. Ví dụ:

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
 

Lưu ý rằng việc tính toán cần thiết để xác minh sự bằng nhau giữa hai bộ đệm có thể tốn kém trong một số trường hợp và do đó, bạn không nên sử dụng phương pháp này trong đường dẫn quan trọng nơi hiệu suất đóng vai trò quan trọng.

Đọc giá trị tại chỉ mục đã cho. Quan trọng: Việc sử dụng phương pháp này nên được giới hạn ở các bộ đệm thuộc loại không nguyên thủy hoặc khi kiểu dữ liệu không được người gọi xác định rõ ràng. Trong mọi trường hợp khác, hãy ưu tiên sử dụng biến thể nguyên thủy của nó để cải thiện đáng kể hiệu suất (ví dụ: IntDataBuffer.getInt(idx)

Cho biết bộ đệm này có được hỗ trợ bởi một mảng có thể truy cập hay không.

Tạo một bộ đệm mới có nội dung là một chuỗi con được chia sẻ của nội dung của bộ đệm này, có kích thước được đặt thành giá trị đã cho.

Kích thước mới không được lớn hơn kích thước bộ đệm này. Những thay đổi đối với nội dung của bộ đệm này sẽ hiển thị trong bộ đệm mới và ngược lại. Bộ đệm mới sẽ ở chế độ chỉ đọc khi và chỉ khi bộ đệm này ở chế độ chỉ đọc.

Cuộc gọi này tương đương với slice(0, size)

Tạo một bộ đệm mới có nội dung là một chuỗi con được chia sẻ của nội dung của bộ đệm này, bắt đầu từ chỉ mục đã cho.

Chỉ mục không được lớn hơn kích thước bộ đệm này. Những thay đổi đối với nội dung của bộ đệm này sẽ hiển thị trong bộ đệm mới và ngược lại. Bộ đệm mới sẽ ở chế độ chỉ đọc khi và chỉ khi bộ đệm này ở chế độ chỉ đọc.

Cuộc gọi này tương đương với slice(index, size() - index)

Đọc các tham chiếu của các đối tượng trong bộ đệm này vào mảng đích.

Phương thức này chuyển các giá trị từ bộ đệm này vào mảng đích đã cho. Nếu có ít giá trị trong bộ đệm hơn mức cần thiết để đáp ứng yêu cầu, tức là nếu dst.length > size() thì không có giá trị nào được chuyển và BufferUnderflowException sẽ được ném ra.

Mặt khác, phương thức này sao chép các giá trị n = dst.length từ bộ đệm này vào mảng đã cho.

Đọc các tham chiếu của các đối tượng trong bộ đệm này vào mảng đích.

Phương thức này chuyển các giá trị từ bộ đệm này vào mảng đích đã cho. Nếu có ít giá trị trong bộ đệm hơn mức cần thiết để đáp ứng yêu cầu, tức là nếu length > size() thì không có giá trị nào được chuyển và BufferUnderflowException sẽ được ném ra.

Mặt khác, phương thức này sao chép các giá trị n = length từ bộ đệm này vào mảng đã cho bắt đầu từ offset đã cho.

Ghi giá trị đã cho vào bộ đệm này tại chỉ mục đã cho. Quan trọng: Việc sử dụng phương pháp này nên được giới hạn ở các bộ đệm thuộc loại không nguyên thủy hoặc khi kiểu dữ liệu không được người gọi xác định rõ ràng. Trong mọi trường hợp khác, hãy ưu tiên sử dụng biến thể nguyên thủy của nó để cải thiện đáng kể hiệu suất (ví dụ: IntDataBuffer.setInt(idx)

Kích thước của bộ đệm, tính theo phần tử.

Ví dụ, trong trường hợp bộ đệm byte, giá trị này bằng số byte mà bộ đệm này có thể chứa. Đối với bộ đệm số nguyên, nó bằng số lượng số nguyên, do đó kích thước tính bằng byte của bộ đệm này là size() * Integer.BYTES .

Tạo một bộ đệm mới có nội dung là một chuỗi con được chia sẻ của nội dung của bộ đệm này, bắt đầu từ chỉ mục đã cho và có kích thước nhất định.

Chỉ số cộng với kích thước mới không được lớn hơn kích thước bộ đệm này. Những thay đổi đối với nội dung của bộ đệm này sẽ hiển thị trong bộ đệm mới và ngược lại. Bộ đệm mới sẽ ở chế độ chỉ đọc khi và chỉ khi bộ đệm này ở chế độ chỉ đọc.

Tạo DataBufferWindow cung cấp chế độ xem một phần bộ đệm này.

Cửa sổ được tạo có kích thước cố định và có thể "slide" dọc theo bộ đệm này để cung cấp các chế độ xem dữ liệu khác nhau mà không cần phân bổ phiên bản bộ đệm mới, giống như offset(long) . Điều này cải thiện hiệu suất tổng thể khi thao tác này được lặp lại thường xuyên. Ví dụ:

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

Đối tượng được trả về có trạng thái và không an toàn theo luồng.

Viết các tham chiếu của các đối tượng trong mảng nguồn vào bộ đệm này.

Phương thức này chuyển các giá trị trong mảng nguồn đã cho vào bộ đệm này. Nếu có nhiều giá trị trong mảng nguồn hơn trong bộ đệm này, tức là nếu src.length > size() thì không có giá trị nào được chuyển và BufferOverflowException sẽ được ném ra.

Mặt khác, phương thức này sao chép các giá trị n = src.length từ mảng đã cho.

Phương pháp đặt số lượng lớn, sử dụng mảng int.

Phương thức này chuyển các giá trị trong mảng nguồn đã cho vào bộ đệm này. Nếu có nhiều giá trị trong mảng nguồn hơn trong bộ đệm này, tức là nếu length > size() thì không có giá trị nào được chuyển và BufferOverflowException sẽ được ném ra.

Mặt khác, phương thức này sao chép các giá trị n = length từ mảng đã cho vào bộ đệm này, bắt đầu từ offset đã cho.