DataBuffer

Odwiedza pamięć zapasową tego bufora.

Implementacja bufora odpowiada za przekazanie odwiedzającemu odniesienia do faktycznego przechowywania danych. Odwiedzający nie musi obsługiwać wszystkich możliwych typów przechowywania danych i może zastąpić tylko metody przechowywania, którymi faktycznie jest zainteresowany. W przypadku każdego innego typu przechowywania to wywołanie powróci do fallback() , więc odwiedzający będzie mógł wykonać jakąś ogólną procedurę, jeśli potrzebne.

Zapisz odniesienia do obiektów w tablicy źródłowej w tym buforze.

Jeśli jest więcej wartości do skopiowania niż rozmiar bufora docelowego, tj. size > dst.size() , wówczas żadne wartości nie są przesyłane i zgłaszany jest wyjątek BufferOverflowException. Z drugiej strony, jeśli istnieje więcej wartości do skopiowania niż rozmiar bufora źródłowego, tj. > src.size() , zgłaszany jest wyjątek BufferUnderfloatException.

W przeciwnym razie ta metoda kopiuje wartości n = size z tego bufora do bufora docelowego.

Sprawdza równość pomiędzy buforami danych.

Bufor danych jest równy innemu obiektowi, jeśli ten obiekt jest innym DataBuffer tego samego rozmiaru, typu, a elementy są równe i w tej samej kolejności. Na przykład:

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
 

Należy zauważyć, że obliczenia wymagane do sprawdzenia równości między dwoma buforami mogą być w niektórych przypadkach kosztowne, dlatego też nie zaleca się stosowania tej metody w ścieżce krytycznej, w której liczy się wydajność.

Odczytuje wartość o podanym indeksie. Ważne: użycie tej metody powinno być ograniczone do buforów typów innych niż pierwotne lub gdy typ danych nie jest deterministycznie znany wywołującemu. W każdym innym przypadku preferuj użycie jego prymitywnego wariantu, który znacznie poprawi wydajność (np IntDataBuffer.getInt(idx)

Informuje, czy ten bufor jest wspierany przez dostępną tablicę.

Tworzy nowy bufor, którego zawartość jest współdzielonym podciągiem zawartości tego bufora, którego rozmiar jest ustawiony na podaną wartość.

Nowy rozmiar nie może być większy niż rozmiar bufora. Zmiany w zawartości tego bufora będą widoczne w nowym buforze i odwrotnie. Nowy bufor będzie tylko do odczytu wtedy i tylko wtedy, gdy ten bufor będzie tylko do odczytu.

To wywołanie jest równoważne slice(0, size)

Tworzy nowy bufor, którego zawartość jest współdzielonym podciągiem zawartości tego bufora, zaczynając od podanego indeksu.

Indeks nie może być większy niż rozmiar bufora. Zmiany w zawartości tego bufora będą widoczne w nowym buforze i odwrotnie. Nowy bufor będzie tylko do odczytu wtedy i tylko wtedy, gdy ten bufor będzie tylko do odczytu.

To wywołanie jest równoważne z slice(index, size() - index)

Przeczytaj referencje obiektów w tym buforze do tablicy docelowej.

Ta metoda przenosi wartości z tego bufora do podanej tablicy docelowej. Jeśli w buforze znajduje się mniej wartości, niż jest to wymagane do zaspokojenia żądania, to znaczy, jeśli dst.length > size() , wówczas żadne wartości nie są przesyłane i zgłaszany jest wyjątek BufferUnderflowException.

W przeciwnym razie ta metoda kopiuje wartości n = dst.length z tego bufora do podanej tablicy.

Przeczytaj referencje obiektów w tym buforze do tablicy docelowej.

Ta metoda przenosi wartości z tego bufora do podanej tablicy docelowej. Jeśli w buforze znajduje się mniej wartości, niż jest to wymagane do zaspokojenia żądania, to znaczy, jeśli length > size() , wówczas żadne wartości nie są przesyłane i zgłaszany jest wyjątek BufferUnderflowException.

W przeciwnym razie ta metoda kopiuje wartości n = length z tego bufora do danej tablicy, zaczynając od danego przesunięcia.

Zapisuje podaną wartość do tego bufora pod podanym indeksem. Ważne: użycie tej metody powinno być ograniczone do buforów typów innych niż pierwotne lub gdy typ danych nie jest deterministycznie znany wywołującemu. W każdym innym przypadku preferuj użycie jego pierwotnego wariantu, który znacznie poprawi wydajność (np IntDataBuffer.setInt(idx)

Rozmiar bufora w elementach.

Na przykład w przypadku bufora bajtowego wartość ta jest równa liczbie bajtów, które ten bufor może pomieścić. W przypadku bufora liczb całkowitych jest on równy liczbie liczb całkowitych, dlatego rozmiar tego bufora w bajtach wynosi size() * Integer.BYTES .

Tworzy nowy bufor, którego zawartość jest współdzielonym podciągiem zawartości tego bufora, zaczynając od podanego indeksu i o podanym rozmiarze.

Indeks plus nowy rozmiar nie może być większy niż rozmiar bufora. Zmiany w zawartości tego bufora będą widoczne w nowym buforze i odwrotnie. Nowy bufor będzie tylko do odczytu wtedy i tylko wtedy, gdy ten bufor będzie tylko do odczytu.

Tworzy DataBufferWindow , który zapewnia częściowy widok tego buforu.

Utworzone okno ma stały rozmiar i może "slide" wzdłuż tego bufora, aby zapewnić różne widoki danych bez przydzielania nowej instancji bufora, tak jak robi to offset(long) . Poprawia to ogólną wydajność, gdy ta operacja jest często powtarzana. Na przykład:

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

Zwrócony obiekt jest stanowy i nie jest bezpieczny dla wątków.

Zapisz odniesienia do obiektów w tablicy źródłowej w tym buforze.

Ta metoda przenosi wartości z danej tablicy źródłowej do tego bufora. Jeśli w tablicy źródłowej znajduje się więcej wartości niż w tym buforze, to znaczy, jeśli src.length > size() , wówczas żadne wartości nie są przesyłane i zgłaszany jest wyjątek BufferOverflowException.

W przeciwnym razie ta metoda kopiuje wartości n = src.length z podanej tablicy.

Metoda umieszczania zbiorczego przy użyciu tablic typu int.

Ta metoda przenosi wartości z danej tablicy źródłowej do tego bufora. Jeśli w tablicy źródłowej znajduje się więcej wartości niż w tym buforze, to znaczy, jeśli length > size() , wówczas żadne wartości nie są przesyłane i zgłaszany jest wyjątek BufferOverflowException.

W przeciwnym razie ta metoda kopiuje wartości n = length z podanej tablicy do tego bufora, zaczynając od danego przesunięcia.