Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Izravni ByteBuffer: pisanje, čitanje i zadržavanje nepročitanih bajtova

Zapiši šest bajtova u izravni međuspremnik od 32 bajta i pogledaj kako `flip()`, `compact()` i `clear()` mijenjaju raspon za čitanje ili pisanje.

Verzija: Java SE 21

Sintaksa

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();

U Java SE 21 statička metoda java.nio.ByteBuffer.allocateDirect(n) stvara izravni međuspremnik za n bajtova. Negativan kapacitet izaziva IllegalArgumentException. isDirect() pokazuje je li međuspremnik izravan. JVM pokušava izbjeći posredne kopije pri izvornim ulazno-izlaznim operacijama, ali to ne jamči. Sadržaj može biti izvan Javine hrpe. Nijedna od opisanih operacija ne oslobađa memoriju međuspremnika.

capacity() vraća fiksni kapacitet u bajtovima, position() pokazuje indeks sljedećeg bajta pri relativnom pristupu, a limit() prvi nedostupni indeks. Početni je položaj 0, granica je jednaka kapacitetu, a svi su bajtovi postavljeni na nulu. position(p) zahtijeva 0 <= p <= limit; limit(l) zahtijeva 0 <= l <= capacity i po potrebi smanjuje položaj na l. Nevaljani argument izaziva IllegalArgumentException. Svaka od tih metoda odbacuje oznaku ako prelazi novi položaj odnosno novu granicu.

order() vraća redoslijed bajtova, u početku ByteOrder.BIG_ENDIAN (najznačajniji bajt prvi). order(ByteOrder.LITTLE_ENDIAN) u sljedećim višebajtnim pristupima stavlja najmanje značajan bajt na prvo mjesto, bez promjene redoslijeda pohranjenih bajtova. Slijedi format podataka, a ne redoslijed procesora.

putInt(value) i getInt() zapisuju ili čitaju četiri bajta; putShort(value) i getShort() koriste dva. Relativne operacije počinju na position() i pomiču položaj za veličinu vrijednosti. Ako je limit - position premalen, čitanje izaziva BufferUnderflowException, a pisanje u međuspremnik koji dopušta pisanje izaziva BufferOverflowException. Pokušaj pisanja u međuspremnik samo za čitanje može izazvati ReadOnlyBufferException. Ako u međuspremniku samo za čitanje ujedno nema dovoljno mjesta za relativno pisanje, Java SE 21 ne određuje koja od tih dviju iznimaka pri pisanju ima prednost. Apsolutne preopterećene metode getInt(i), getShort(i), putInt(i, value) i putShort(i, value) ne mijenjaju položaj. Cijeli raspon bajtova mora biti unutar [0, limit), inače izazivaju IndexOutOfBoundsException.

flip() postavlja granicu na prethodni položaj, a položaj na 0 radi čitanja. clear() postavlja položaj na 0, a granicu na kapacitet kako bi cijeli međuspremnik ponovno bio dostupan za pisanje, bez brisanja podataka. Nakon djelomičnog čitanja compact() premješta bajtove iz [position, limit) na početak, postavlja položaj na broj zadržanih bajtova i vraća granicu na kapacitet kako bi se mogli dodati podaci. Prije ponovnog čitanja pozovi flip(). Sve tri metode odbacuju oznaku; compact() na međuspremniku samo za čitanje izaziva ReadOnlyBufferException.

Primjeri

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

Rezultat

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

Podaci zauzimaju šest od 32 bajta. Apsolutni poziv `get(0)` prikazuje najmanje značajan bajt (`4`) bez pomicanja položaja. Nakon čitanja vrijednosti `int`, `compact()` zadržava dva bajta vrijednosti `200`; nakon dodavanja `300` drugi `flip()` omogućuje čitanje obje vrijednosti. `clear()` vraća puni raspon za pisanje.

Povezane lekcije

  • Java · Lekcija 50 · Napredno · Verzija: 2

Izvori