Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Priamy ByteBuffer: zápis, čítanie a zachovanie neprečítaných bajtov

Zapíš šesť bajtov do priameho 32-bajtového buffera a sleduj, ako `flip()`, `compact()` a `clear()` menia rozsah dostupný na čítanie alebo zápis.

Verzia: Java SE 21

Syntax

import java.nio.ByteBuffer;
import java.nio.ByteOrder;

ByteBuffer b = ByteBuffer.allocateDirect(32);
b.isDirect();
b.capacity();
b.order();
b.order(ByteOrder.LITTLE_ENDIAN);
b.position();
b.position(newPosition);
b.limit();
b.limit(newLimit);

b.putInt(intValue);
b.putInt(byteIndex, intValue);
b.putShort(shortValue);
b.putShort(byteIndex, shortValue);
b.getInt();
b.getInt(byteIndex);
b.getShort();
b.getShort(byteIndex);

b.clear();
b.flip();
b.compact();

V Java SE 21 statická metóda java.nio.ByteBuffer.allocateDirect(n) vytvorí priamy buffer pre n bajtov. Záporná kapacita vyvolá IllegalArgumentException. isDirect() zisťuje, či je buffer priamy. JVM sa pri natívnom vstupe a výstupe snaží vyhnúť medzikópiám, ale nezaručuje to. Obsah môže byť mimo haldy Javy. Žiadna z tu opísaných operácií neuvoľní pamäť buffera.

capacity() vracia pevnú kapacitu v bajtoch, position() určuje index ďalšieho bajtu pri relatívnom prístupe a limit() prvý neprístupný index. Na začiatku je pozícia 0, limit sa rovná kapacite a bajty sú vynulované. position(p) vyžaduje 0 <= p <= limit; limit(l) vyžaduje 0 <= l <= capacity a podľa potreby zníži pozíciu na l. Neplatný argument vyvolá IllegalArgumentException. Každá z týchto metód zruší značku, ak je za novou pozíciou, respektíve za novým limitom.

order() vracia poradie bajtov, spočiatku ByteOrder.BIG_ENDIAN (najvýznamnejší bajt je prvý). order(ByteOrder.LITTLE_ENDIAN) pri nasledujúcich viacbajtových prístupoch použije najmenej významný bajt ako prvý bez zmeny poradia uložených bajtov. Riaď sa formátom dát, nie poradím procesora.

putInt(value) a getInt() zapisujú alebo čítajú štyri bajty; putShort(value) a getShort() dva. Relatívne operácie začínajú na position() a posunú ju o veľkosť hodnoty. Ak je limit - position primalé, čítanie vyvolá BufferUnderflowException a zápis do buffera, ktorý umožňuje zápis, vyvolá BufferOverflowException. Pokus o zápis do buffera iba na čítanie môže vyvolať ReadOnlyBufferException. Ak v bufferi iba na čítanie zároveň nezostáva dosť miesta na relatívny zápis, Java SE 21 neurčuje, ktorá z týchto dvoch výnimiek pri zápise má prednosť. Absolútne preťaženia getInt(i), getShort(i), putInt(i, value) a putShort(i, value) pozíciu nemenia. Celý ich rozsah bajtov musí ležať v [0, limit), inak vyvolajú IndexOutOfBoundsException.

flip() nastaví limit na pôvodnú pozíciu a pozíciu na 0, aby sa dalo čítať. clear() nastaví pozíciu na 0 a limit na kapacitu, aby sa dal znova zaplniť celý buffer, ale dáta nevymaže. Po čiastočnom čítaní compact() presunie bajty z [position, limit) na začiatok, nastaví pozíciu na počet zachovaných bajtov a obnoví limit na kapacitu, aby sa dali pripísať dáta. Pred ďalším čítaním zavolaj flip(). Všetky tri metódy rušia značku; compact() pri bufferi iba na čítanie vyvolá ReadOnlyBufferException.

Príklady

import java.nio.ByteBuffer;
import java.nio.ByteOrder;

public class Main {
    public static void main(String[] args) {
        ByteBuffer b = ByteBuffer.allocateDirect(32).order(ByteOrder.LITTLE_ENDIAN);
        System.out.println("direct=" + b.isDirect() + ", capacity=" + b.capacity()
                + ", order=" + b.order());

        b.putInt(0x01020304).putShort((short) 200);
        state("after put", b);
        b.flip();
        state("after flip", b);
        System.out.println("first byte=" + b.get(0));
        System.out.println("int=" + b.getInt());
        state("after getInt", b);

        b.compact();
        state("after compact", b);
        b.putShort((short) 300);
        b.flip();
        state("after second flip", b);
        short retained = b.getShort();
        short appended = b.getShort();
        System.out.println("shorts=" + retained + ", " + appended);

        b.clear();
        state("after clear", b);
    }

    private static void state(String label, ByteBuffer b) {
        System.out.println(label + ": position=" + b.position() + ", limit=" + b.limit());
    }
}

Výsledok

direct=true, capacity=32, order=LITTLE_ENDIAN
after put: position=6, limit=32
after flip: position=0, limit=6
first byte=4
int=16909060
after getInt: position=4, limit=6
after compact: position=2, limit=32
after second flip: position=0, limit=4
shorts=200, 300
after clear: position=0, limit=32

Dáta zaberajú šesť z 32 bajtov. Absolútne volanie `get(0)` ukáže najmenej významný bajt (`4`) bez posunutia pozície. Po prečítaní `int` metóda `compact()` zachová dva bajty hodnoty `200`; po pripísaní `300` druhé `flip()` sprístupní obe hodnoty na čítanie. `clear()` obnoví celý rozsah na zápis.

Súvisiace lekcie

  • Java · Lekcia 50 · Pokročilá · Verzia: 2

Zdroje