DataBuffer

Visita l'archivio di backup di questo buffer.

L'implementazione del buffer è responsabile di restituire al visitatore fornito un riferimento all'effettiva memorizzazione dei dati. Il visitatore non deve gestire tutti i possibili tipi di archiviazione dei dati e può sovrascrivere solo i metodi di archiviazione a cui è effettivamente interessato. Per qualsiasi altro tipo di archiviazione, questa chiamata eseguirà il fallback su fallback() in modo che il visitatore possa eseguire alcune routine generiche se necessario.

Scrivi i riferimenti degli oggetti nell'array di origine in questo buffer.

Se sono presenti più valori da copiare rispetto alla dimensione del buffer di destinazione, ovvero size > dst.size() , non viene trasferito alcun valore e viene generata un'eccezione BufferOverflowException. D'altra parte, se ci sono più valori da copiare rispetto alla dimensione del buffer di origine, ad esempio > src.size() , viene lanciata un'eccezione BufferUnderfloatException.

Altrimenti, questo metodo copia n = size da questo buffer nel buffer di destinazione.

Controlla l'uguaglianza tra i buffer di dati.

Un buffer di dati è uguale a un altro oggetto se questo oggetto è un altro DataBuffer della stessa dimensione, tipo e gli elementi sono uguali e nello stesso ordine. Ad esempio:

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
 

Si noti che il calcolo richiesto per verificare l'uguaglianza tra due buffer può essere costoso in alcuni casi e pertanto si consiglia di non utilizzare questo metodo in un percorso critico in cui le prestazioni contano.

Legge il valore dell'indice specificato. Importante: l'utilizzo di questo metodo deve essere limitato ai buffer di tipi non primitivi o quando il tipo di dati non è conosciuto in modo deterministico dal chiamante. In ogni altro caso, preferisci l'utilizzo della sua variante primitiva che migliorerà significativamente le prestazioni (ad esempio IntDataBuffer.getInt(idx)

Indica se questo buffer è supportato o meno da un array accessibile.

Crea un nuovo buffer il cui contenuto è una sottosequenza condivisa del contenuto di questo buffer, la cui dimensione è impostata sul valore specificato.

La nuova dimensione non deve essere maggiore della dimensione del buffer. Le modifiche al contenuto di questo buffer saranno visibili nel nuovo buffer e viceversa. Il nuovo buffer sarà di sola lettura se, e solo se, questo buffer è di sola lettura.

Questa chiamata è equivalente a slice(0, size)

Crea un nuovo buffer il cui contenuto è una sottosequenza condivisa del contenuto di questo buffer, a partire dall'indice specificato.

L'indice non deve essere maggiore della dimensione del buffer. Le modifiche al contenuto di questo buffer saranno visibili nel nuovo buffer e viceversa. Il nuovo buffer sarà di sola lettura se, e solo se, questo buffer è di sola lettura.

Questa chiamata è equivalente a slice(index, size() - index)

Leggere i riferimenti degli oggetti in questo buffer nell'array di destinazione.

Questo metodo trasferisce i valori da questo buffer nell'array di destinazione specificato. Se nel buffer sono presenti meno valori di quelli necessari per soddisfare la richiesta, ovvero se dst.length > size() , non viene trasferito alcun valore e viene generata un'eccezione BufferUnderflowException.

Altrimenti, questo metodo copia i valori n = dst.length da questo buffer nell'array specificato.

Leggere i riferimenti degli oggetti in questo buffer nell'array di destinazione.

Questo metodo trasferisce i valori da questo buffer nell'array di destinazione specificato. Se nel buffer sono presenti meno valori di quelli necessari per soddisfare la richiesta, ovvero se length > size() , non viene trasferito alcun valore e viene generata un'eccezione BufferUnderflowException.

Altrimenti, questo metodo copia n = length da questo buffer nell'array specificato a partire dall'offset specificato.

Scrive il valore dato in questo buffer in corrispondenza dell'indice dato. Importante: l'utilizzo di questo metodo deve essere limitato ai buffer di tipi non primitivi o quando il tipo di dati non è conosciuto in modo deterministico dal chiamante. In ogni altro caso, preferisci l'utilizzo della sua variante primitiva che migliorerà significativamente le prestazioni (ad esempio IntDataBuffer.setInt(idx)

Dimensione del buffer, in elementi.

Ad esempio, nel caso di un buffer di byte, questo valore è uguale al numero di byte che questo buffer può contenere. Per un buffer intero, è uguale al numero di numeri interi, pertanto la dimensione in byte di questo buffer è size() * Integer.BYTES .

Crea un nuovo buffer il cui contenuto è una sottosequenza condivisa del contenuto di questo buffer, a partire dall'indice e dalla dimensione specificati.

L'indice più la nuova dimensione non devono essere maggiori della dimensione del buffer. Le modifiche al contenuto di questo buffer saranno visibili nel nuovo buffer e viceversa. Il nuovo buffer sarà di sola lettura se, e solo se, questo buffer è di sola lettura.

Crea un DataBufferWindow che fornisce una visualizzazione parziale di questo buffer.

La finestra creata ha una dimensione fissa e può "slide" lungo questo buffer per fornire diverse visualizzazioni dei dati senza allocare una nuova istanza del buffer, come fa offset(long) . Ciò migliora le prestazioni generali quando questa operazione viene ripetuta frequentemente. Ad esempio:

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

L'oggetto restituito è con stato e non è thread-safe.

Scrivi i riferimenti degli oggetti nell'array di origine in questo buffer.

Questo metodo trasferisce i valori nell'array di origine specificato in questo buffer. Se sono presenti più valori nell'array di origine che in questo buffer, ovvero se src.length > size() , non viene trasferito alcun valore e viene generata un'eccezione BufferOverflowException.

Altrimenti, questo metodo copia i valori n = src.length dall'array specificato.

Metodo di immissione in blocco, utilizzando array int.

Questo metodo trasferisce i valori nell'array di origine specificato in questo buffer. Se sono presenti più valori nell'array di origine che in questo buffer, ovvero se length > size() , non viene trasferito alcun valore e viene generata un'eccezione BufferOverflowException.

Altrimenti, questo metodo copia n = length dall'array specificato in questo buffer, a partire dall'offset specificato.