CKTIS / Java
Serializar un objeto Java en un array de bytes
Escribe un objeto en un `byte[]` y reconstrúyelo con bytes de confianza generados por el mismo programa. Observa por qué la serialización predeterminada omite los campos `transient`.
Versión: Java SE 21
Sintaxis
Java SE 21 — java.io
ByteArrayOutputStream()
ObjectOutputStream(OutputStream out) throws IOException
void ObjectOutputStream.writeObject(Object obj) throws IOException
void ObjectOutputStream.flush() throws IOException
byte[] ByteArrayOutputStream.toByteArray()
ByteArrayInputStream(byte[] buf)
ObjectInputStream(InputStream in) throws IOException
Object ObjectInputStream.readObject() throws IOException, ClassNotFoundExceptionEn Java SE 21, las clases de java.io permiten escribir y reconstruir un objeto íntegramente en memoria. El constructor de ObjectOutputStream escribe la cabecera del flujo. writeObject(Object) serializa el objeto y el grafo alcanzable a través de las referencias que se serializan. El parámetro de tipo Object no garantiza que la operación tenga éxito: si un objeto que se va a serializar no implementa Serializable, puede producirse una NotSerializableException.
Después de writeObject(Object), llama a flush() para enviar los bytes pendientes al flujo subyacente sin cerrarlo. A continuación, ByteArrayOutputStream.toByteArray() devuelve un byte[] nuevo con una copia de solo los bytes escritos. Esta llamada no expone el búfer interno ni vacía el búfer del flujo de objetos. ByteArrayInputStream(byte[]) usa el array sin copiarlo.
El constructor de ObjectInputStream lee la cabecera. readObject() reconstruye el objeto y lo devuelve como Object; la conversión explícita a Profile comprueba el tipo esperado solo después de la deserialización. Lee los valores sucesivos en el orden en que se escribieron y con los tipos correspondientes. Las operaciones de flujo pueden lanzar IOException; la lectura también puede lanzar ClassNotFoundException si no está disponible una clase necesaria. Los bloques try con recursos cierran los flujos de objetos.
La serialización predeterminada omite los campos static y transient. Al reconstruir una clase serializable ordinaria no se ejecutan su constructor ni sus inicializadores de campos, por lo que cache queda con su valor predeterminado, null, en lugar de warm. Cuando se exige que los valores de serialVersionUID coincidan, una discrepancia provoca una InvalidClassException. Este requisito no se aplica a las clases de arrays ni a las clases record. Que los valores coincidan no hace compatible cualquier cambio en la clase. No es un formato de intercambio independiente del lenguaje. No deserialices datos no confiables: el ejemplo solo lee bytes generados localmente por el mismo programa.
Ejemplos
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
import java.io.Serial;
import java.io.Serializable;
public class SerializationRoundTrip {
private static final class Profile implements Serializable {
@Serial
private static final long serialVersionUID = 1L;
private final String name;
private transient String cache = "warm";
private Profile(String name) {
this.name = name;
}
}
public static void main(String[] args)
throws IOException, ClassNotFoundException {
Profile original = new Profile("Ada");
ByteArrayOutputStream buffer = new ByteArrayOutputStream();
byte[] bytes;
try (ObjectOutputStream out = new ObjectOutputStream(buffer)) {
out.writeObject(original);
out.flush();
bytes = buffer.toByteArray();
}
Profile restored;
try (ObjectInputStream in = new ObjectInputStream(new ByteArrayInputStream(bytes))) {
restored = (Profile) in.readObject();
}
System.out.println("before: " + original.name + ", cache=" + original.cache);
System.out.println("after: " + restored.name + ", cache=" + restored.cache);
}
}Resultado
before: Ada, cache=warm after: Ada, cache=null
Compara `before` y `after`: `name` sigue siendo `Ada`, pero `cache` vale `warm` en el original y `null` en el objeto reconstruido.
Lecciones relacionadas
- Java · Lección 52 · Avanzado · Versión: 2
Fuentes
- ObjectOutputStream (Java SE 21 & JDK 21)
- ByteArrayOutputStream (Java SE 21 & JDK 21)
- ByteArrayInputStream (Java SE 21 & JDK 21)
- ObjectInputStream (Java SE 21 & JDK 21)
- Serializable (Java SE 21 & JDK 21)
- Java Object Serialization Specification: 3 - Object Input Classes
- Java Object Serialization Specification: 5 - Versioning of Serializable Objects