CKTIS / Java
ObjectOutputStream — zapis obiektów Java
ObjectOutputStream zapisuje obiekty jako strumień bajtów serializacji Java. Poznaj writeObject, różnicę między flush i close oraz automatyczne zamykanie przez try-with-resources.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
ObjectOutputStream out = new ObjectOutputStream(outputStream);
out.writeObject(object);
out.flush();
out.close();ObjectOutputStream opakowuje OutputStream i zapisuje binarny format serializacji Java, nie tekst. Konstruktor zapisuje nagłówek. ObjectOutputStream.writeObject(obj) zapisuje graf obiektów; zwykłe obiekty muszą implementować Serializable. Współdzielone referencje i cykle są zachowywane dzięki uchwytom, zamiast wielokrotnego kopiowania obiektu.
Domyślna serializacja obejmuje pola niestatyczne bez transient. Nieserializowalny obiekt wymagający zapisu powoduje NotSerializableException. Odczyt przez ObjectInputStream wymaga zgodnych klas. Jawne operacje odczytu muszą odpowiadać jawnym operacjom zapisu danych pod względem kolejności i rodzaju. Nie oznacza to, że zestaw pól musi być identyczny: przy domyślnej deserializacji dodanie pola może być zmianą zgodną. Usunięcie pola jest zmianą niezgodną: nawet jeśli deserializacja się powiedzie, starsza wersja klasy może otrzymać domyślną wartość tego pola, która uniemożliwi jej spełnienie własnego kontraktu. Nie zapisuj sekretów bez świadomej kontroli serializowanego stanu.
ObjectOutputStream.flush() przekazuje buforowane bajty dalej i wywołuje opróżnienie strumienia bazowego; nie zamyka strumienia ani nie gwarantuje fizycznego zapisu na dysk. ObjectOutputStream.close() zamyka strumień i zwalnia zasoby. Preferuj try-with-resources, które wywołuje close() automatycznie. Operacje mogą zgłaszać IOException; po błędzie writeObject nie zakładaj, że strumień nadal nadaje się do użycia.
Przykłady
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
public class Main {
public static void main(String[] args) throws Exception {
ByteArrayOutputStream bytes = new ByteArrayOutputStream();
try (ObjectOutputStream out = new ObjectOutputStream(bytes)) {
out.writeObject("CKTIS");
out.flush();
}
try (ObjectInputStream in = new ObjectInputStream(
new ByteArrayInputStream(bytes.toByteArray()))) {
System.out.println(in.readObject());
}
}
}Wynik
CKTIS
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.