CKTIS / Java
ObjectInputStream — deserializace objektů
ObjectInputStream rekonstruuje objekty z binárního serializačního proudu Javy. Seznamte se s metodou readObject(), zpracováním výjimek a zavíráním pomocí close() a mějte na paměti, že deserializace nedůvěryhodných dat je nebezpečná.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
public ObjectInputStream(InputStream in) throws IOException
public final Object readObject() throws IOException, ClassNotFoundException
public void close() throws IOExceptionObjectInputStream z java.io čte data zapsaná pomocí ObjectOutputStream, nikoli libovolný text nebo JSON. Konstruktor přijímá InputStream a kontroluje hlavičku serializace; může blokovat, dokud hlavička nedorazí. Tento text se vztahuje k Java SE 21; běhová prostředí repozitáře a produkce nejsou potvrzena.
ObjectInputStream.readObject() rekonstruuje objekt i objekty, na které odkazuje, a zachovává sdílené reference. Vrací Object, včetně null, proto je třeba očekávaný typ zkontrolovat nebo přetypovat. Hodnoty čtěte ve stejném pořadí a typech, v jakých byly zapsány; primitivní data čtěte metodami, jako je readInt(). Metoda deklaruje IOException a ClassNotFoundException; nekompatibilní třída může způsobit InvalidClassException.
ObjectInputStream.close() zavře proud a uvolní související prostředky; může vyvolat IOException. Používejte try-with-resources, aby se close() zavolala i po výjimce. Příklad zapíše lokálně vytvořený String do paměti, poté jej přečte a vypíše Hello, Java!.
Nedeserializujte nedůvěryhodná data: během rekonstrukce se mohou spouštět metody tříd. Přetypování po readObject() není bezpečnostní opatření. Pokud je deserializace nutná, před čtením nastavte ObjectInputFilter a omezte povolené třídy i velikost grafu; filtrování nenahrazuje ověření dat.
Příklady
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
public class Main {
public static void main(String[] args)
throws IOException, ClassNotFoundException {
ByteArrayOutputStream bytes = new ByteArrayOutputStream();
try (ObjectOutputStream out = new ObjectOutputStream(bytes)) {
out.writeObject("Hello, Java!");
}
try (ObjectInputStream in = new ObjectInputStream(
new ByteArrayInputStream(bytes.toByteArray()))) {
String message = (String) in.readObject();
System.out.println(message);
}
}
}
Výsledek
Hello, Java!
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.