CKTIS / Java
Binarni podatkovni tokovi: branje in pisanje bajtov, števil in nizov
Polja preberi v istem vrstnem redu, kot jih zapišeš. Spoznaj, kako Java SE 21 predstavi števila in zakaj omejitev `writeUTF` šteje kodirane bajte.
Različica: Java SE 21
Sintaksa
Java SE 21 · java.io
DataOutputStream(OutputStream out)
void writeByte(int v) throws IOException
void writeInt(int v) throws IOException
void writeDouble(double v) throws IOException
void writeUTF(String str) throws IOException
DataInputStream(InputStream in)
byte readByte() throws IOException
int readInt() throws IOException
double readDouble() throws IOException
String readUTF() throws IOException
static String readUTF(DataInput in) throws IOExceptionV Java SE 21 razreda DataOutputStream in DataInputStream iz paketa java.io ovijeta izhodni oziroma vhodni tok. Na obeh straneh uporabi iste tipe in isti vrstni red polj: tok ne vsebuje oznak tipa ali različice. Branje drugega tipa ali v drugem vrstnem redu lahko vrne napačne vrednosti brez izjeme.
writeByte(int) brez preverjanja obsega zapiše le osem najmanj pomembnih bitov. readByte() vrne predznačeni byte od −128 do 127; za int od 0 do 255 uporabi readUnsignedByte(). writeInt(int) in readInt() uporabljata štiri bajte za int v vrstnem redu big-endian, z najpomembnejšim bajtom najprej. writeDouble(double) in readDouble() uporabljata osem bajtov v zapisu IEEE 754 binary64 v istem vrstnem redu. Pri pisanju Double.doubleToLongBits pretvori NaN v kanonični zapis; pri branju se uporabi Double.longBitsToDouble.
writeUTF(String) zapiše nepredznačeno dvobajtno dolžino v vrstnem redu big-endian, nato podatke v spremenjenem UTF-8. Omejitev 65.535 velja za podatkovne bajte brez predpone, ne za znake ali String.length(). To ni standardni UTF-8: U+0000 zavzame dva bajta, znak zunaj osnovne večjezične ravnine pa šest, po tri za vsako kodno enoto UTF-16. Instančna metoda readUTF() bere iz ovitega toka; statična preobremenitev DataInputStream.readUTF(DataInput) bere isti format iz podanega vira.
Pri pisanju predolg kodiran niz sproži UTFDataFormatException, null pa NullPointerException. Pri branju prezgodnji konec v polju, predponi dolžine ali podatkih niza sproži EOFException; zaznano nepravilno kodiranje sproži UTFDataFormatException. Obe sta podtipa IOException. Če zapreš ovoj, zapreš tudi osnovni tok; uporabi try z viri, kadar si odgovoren za zapiranje toka.
Format ni odvisen od vrstnega reda bajtov procesorja ali privzetega kodiranja znakov na platformi, vendar mora bralnik zunaj Jave podpirati isti format. Vrednosti polj iz nezaupanja vrednih zapisov preveri po pravilih aplikacije: uspešno dekodiranje še ne pomeni, da so vrednosti sprejemljive.
Primeri
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.DataInputStream;
import java.io.DataOutputStream;
import java.io.IOException;
import java.util.HexFormat;
public class DataStreamDemo {
public static void main(String[] args) throws IOException {
String label = "A\u00E9";
ByteArrayOutputStream buffer = new ByteArrayOutputStream();
try (var out = new DataOutputStream(buffer)) {
out.writeByte(255);
out.writeInt(0x01020304);
out.writeDouble(1.5);
out.writeUTF(label);
}
byte[] record = buffer.toByteArray();
System.out.println(HexFormat.ofDelimiter(" ").formatHex(record));
try (var in = new DataInputStream(new ByteArrayInputStream(record))) {
System.out.println(in.readByte());
System.out.println(in.readInt());
System.out.println(in.readDouble());
System.out.println(in.readUTF().equals(label));
}
}
}Rezultat
ff 01 02 03 04 3f f8 00 00 00 00 00 00 00 03 41 c3 a9 -1 16909060 1.5 true
Program izpiše bajte zapisa, prebrane vrednosti in rezultat primerjave nizov. `ff` se prebere kot predznačena vrednost `-1`; `00 03` napove tri podatkovne bajte, čeprav ima niz dve kodni enoti UTF-16.
Povezane lekcije
- Java · Lekcija 53 · Napredna · Različica: 2