База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

ByteBuffer — двоични данни и състояние на буфера

ByteBuffer съхранява байтове и позволява четене и записване на двоични стойности. Научете как да създавате буфер, да задавате реда на байтовете и да управлявате position и limit с flip, clear и compact.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

ByteBuffer b = ByteBuffer.allocate(capacity).order(ByteOrder.BIG_ENDIAN);
b.putInt(value).putShort((short) count);
b.flip();
int valueRead = b.getInt();
short countRead = b.getShort();

java.nio.ByteBuffer е буфер с байтове и фиксиран капацитет, който се използва и за I/O. ByteBuffer.allocate(n) създава буфер с масив като основа, а ByteBuffer.wrap(array) споделя съществуващ масив без копиране. ByteBuffer.allocateDirect(n) създава директен буфер: JVM се опитва да намали копирането при нативен I/O, но не гарантира по-висока скорост. ByteBuffer.isDirect() разпознава този вид буфер.

ByteBuffer.capacity() връща фиксирания капацитет в байтове. ByteBuffer.position() обозначава следващия байт, а ByteBuffer.limit() — първия недостъпен индекс; претоварените методи с аргумент задават тези стойности. В сила е 0 <= position <= limit <= capacity, а ByteBuffer.remaining() е равно на limit - position.

ByteBuffer.put и ByteBuffer.get записват и четат байтове. ByteBuffer.putInt / ByteBuffer.getInt обработват 4 байта, а ByteBuffer.putShort / ByteBuffer.getShort — 2 байта. Относителните операции придвижват позицията; претоварените методи с индекс не я променят, но продължават да спазват лимита. ByteBuffer.order() извлича реда на байтовете, а order(ByteOrder.LITTLE_ENDIAN) го променя; по подразбиране е BIG_ENDIAN. Ако при относителна операция няма достатъчно място или данни, съответно възниква BufferOverflowException или BufferUnderflowException.

След записване ByteBuffer.flip() задава лимита на предишната позиция и позицията на нула. ByteBuffer.compact() премества непрочетените байтове в началото, задава позицията непосредствено след тях и лимита на капацитета, така че да могат да се добавят още данни. ByteBuffer.clear() задава позицията на нула и лимита на капацитета, но не изтрива данните. Едновременният достъп до буфер изисква синхронизация.

Примери

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

public class Main {
    public static void main(String[] args) {
        ByteBuffer b = ByteBuffer.allocate(8).order(ByteOrder.LITTLE_ENDIAN);
        b.putInt(16909060).putShort((short) 7).put((byte) 9);
        System.out.println(b.position() + " " + b.limit() + " " + b.capacity());
        b.flip();
        System.out.println(b.getInt() + " " + b.getShort());
        b.compact();
        b.put((byte) 10);
        b.flip();
        System.out.println(b.remaining() + " " + b.get() + " " + b.get());
        b.clear();
        System.out.println(b.position() + " " + b.limit());
    }
}

Резултат

7 8 8
16909060 7
2 9 10
0 8

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници