Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Neposredni ByteBuffer: pisanje, branje in ohranjanje neprebranih bajtov

Zapiši šest bajtov v 32-bajtni neposredni medpomnilnik in preveri, kako `flip()`, `compact()` in `clear()` spremenijo obseg za branje ali pisanje.

Različica: 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();

V Java SE 21 statična metoda java.nio.ByteBuffer.allocateDirect(n) ustvari neposredni medpomnilnik za n bajtov. Negativna kapaciteta sproži IllegalArgumentException. isDirect() pove, ali je medpomnilnik neposreden. JVM se pri izvornem vhodu in izhodu skuša izogniti vmesnemu kopiranju, vendar tega ne zagotavlja. Vsebina je lahko zunaj Javine kopice. Nobena od opisanih operacij ne sprosti pomnilnika medpomnilnika.

capacity() vrne stalno kapaciteto v bajtih, position() določa indeks naslednjega bajta za relativni dostop, limit() pa prvi nedostopni indeks. Na začetku je položaj 0, meja je enaka kapaciteti in vsi bajti imajo vrednost nič. position(p) zahteva 0 <= p <= limit; limit(l) zahteva 0 <= l <= capacity in po potrebi zniža položaj na l. Neveljaven argument sproži IllegalArgumentException. Vsaka od teh metod zavrže oznako, če ta presega novi položaj oziroma novo mejo.

order() vrne vrstni red bajtov, sprva ByteOrder.BIG_ENDIAN (najpomembnejši bajt je prvi). order(ByteOrder.LITTLE_ENDIAN) pri nadaljnjem dostopu do večbajtnih vrednosti uporabi najmanj pomembni bajt kot prvi, ne da bi preuredila shranjene bajte. Upoštevaj zapis podatkov, ne vrstnega reda procesorja.

putInt(value) in getInt() zapišeta oziroma prebereta štiri bajte; putShort(value) in getShort() uporabljata dva. Relativne operacije začnejo pri position() in jo premaknejo za velikost vrednosti. Če je limit - position premajhen, branje sproži BufferUnderflowException, pisanje v medpomnilnik, ki omogoča pisanje, pa BufferOverflowException. Poskus pisanja v medpomnilnik samo za branje lahko sproži ReadOnlyBufferException. Če v medpomnilniku samo za branje hkrati ni dovolj prostora za relativno pisanje, Java SE 21 ne določa, katera od teh dveh izjem pri pisanju ima prednost. Absolutne preobremenitve getInt(i), getShort(i), putInt(i, value) in putShort(i, value) ne spremenijo položaja. Celoten obseg bajtov mora biti znotraj [0, limit), sicer sprožijo IndexOutOfBoundsException.

flip() nastavi mejo na prejšnji položaj in položaj na 0 za branje. clear() nastavi položaj na 0 in mejo na kapaciteto, da lahko znova napolniš ves medpomnilnik, ne da bi izbrisal podatke. Po delnem branju compact() premakne bajte iz [position, limit) na začetek, nastavi položaj na število ohranjenih bajtov in mejo na kapaciteto, da lahko dodaš podatke. Pred ponovnim branjem pokliči flip(). Vse tri metode zavržejo oznako; compact() na medpomnilniku samo za branje sproži ReadOnlyBufferException.

Primeri

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

Podatki zasedejo šest od 32 bajtov. Absolutni klic `get(0)` pokaže najmanj pomembni bajt (`4`), ne da bi premaknil položaj. Po branju vrednosti `int` metoda `compact()` ohrani dva bajta vrednosti `200`; po dodajanju `300` drugi `flip()` omogoči branje obeh vrednosti. `clear()` obnovi celoten obseg za pisanje.

Povezane lekcije

  • Java · Lekcija 50 · Napredna · Različica: 2

Viri