Artículo

Serialización en Java: qué es Serializable y cómo usarlo

La serialización convierte un objeto Java en un flujo de bytes y la deserialización lo reconstruye. Serializable, serialVersionUID y serialización personalizada.

Serialización en Java: qué es Serializable y cómo usarlo

La serialización en Java convierte un objeto en una secuencia de bytes para guardarlo en un fichero o enviarlo por la red. La deserialización hace lo contrario: reconstruye el objeto a partir de esos bytes. Para que una clase se pueda serializar debe implementar la interfaz Serializable.

Vídeo explicativo

Contenido rápido

  • Serializable es una interfaz sin métodos: solo marca la clase como serializable.
  • ObjectOutputStream.writeObject() serializa y ObjectInputStream.readObject() deserializa.
  • Los campos static y transient no se serializan.
  • serialVersionUID identifica la versión de la clase.
  • Para intercambiar datos entre sistemas hoy se usa JSON, no la serialización nativa.

¿Qué es Serializable en Java?

java.io.Serializable es una interfaz de marcado: no declara ningún método. Al implementarla le dices a la JVM que los objetos de esa clase se pueden convertir en bytes.

public class Persona implements Serializable {

    private static final long serialVersionUID = 1L;

    static String pais = "España";      // static: no se serializa
    private final String nombre;
    private final int edad;
    private transient String password;  // transient: no se serializa

    public Persona(String nombre, int edad, String password) {
        this.nombre = nombre;
        this.edad = edad;
        this.password = password;
    }

    @Override
    public String toString() {
        return nombre + " (" + edad + "), password=" + password;
    }
}

Serializar y deserializar un objeto

Persona persona = new Persona("Ana", 30, "secreto");
Path fichero = Files.createTempFile("persona", ".ser");

// Serializar: objeto -> bytes
try (ObjectOutputStream salida = new ObjectOutputStream(Files.newOutputStream(fichero))) {
    salida.writeObject(persona);
}

// Deserializar: bytes -> objeto
try (ObjectInputStream entrada = new ObjectInputStream(Files.newInputStream(fichero))) {
    Persona copia = (Persona) entrada.readObject();
    System.out.println(copia);
}

Salida:

Ana (30), password=null

El nombre y la edad se recuperan. password vuelve como null porque es transient. Los dos flujos se abren con try-with-resources para que se cierren solos.

transient y static

  • transient excluye un campo de la serialización. Úsalo para datos sensibles (contraseñas), datos que se pueden recalcular o campos cuyo tipo no es serializable. Al deserializar toma el valor por defecto: null, 0 o false.
  • static: los campos estáticos pertenecen a la clase, no al objeto, así que no se guardan.

¿Qué es serialVersionUID?

Es un número que identifica la versión de una clase serializable. Al deserializar, Java compara el serialVersionUID guardado con el de la clase actual. Si no coinciden, lanza InvalidClassException.

Si no lo declaras, el compilador calcula uno a partir de la estructura de la clase, y cualquier cambio (añadir un campo, por ejemplo) lo modifica. Por eso conviene declararlo siempre:

private static final long serialVersionUID = 1L;

Herencia y composición

  • Si una clase es Serializable, sus subclases también lo son.
  • Todos los campos de un objeto serializable deben ser serializables o transient. Si no, writeObject lanza NotSerializableException:
class Direccion {              // no implementa Serializable
    final String calle;
    Direccion(String calle) { this.calle = calle; }
}

class Cliente implements Serializable {
    String nombre = "Ana";
    Direccion direccion = new Direccion("Mayor 1");  // provoca NotSerializableException
}

Lo mismo ocurre con los elementos de un array o de una colección.

Serialización personalizada

Cuando un campo no es serializable y no puedes cambiar su clase, márcalo como transient y escribe tú sus datos con los métodos privados writeObject y readObject:

class Empleado implements Serializable {

    private static final long serialVersionUID = 1L;

    private final String nombre;
    private transient Direccion direccion;

    Empleado(String nombre, Direccion direccion) {
        this.nombre = nombre;
        this.direccion = direccion;
    }

    private void writeObject(ObjectOutputStream out) throws IOException {
        out.defaultWriteObject();          // serializa los campos normales
        out.writeObject(direccion.calle);  // y a mano lo que falta
    }

    private void readObject(ObjectInputStream in) throws IOException, ClassNotFoundException {
        in.defaultReadObject();
        this.direccion = new Direccion((String) in.readObject());
    }
}

Al deserializar un Empleado("Luis", new Direccion("Mayor 1")), la dirección se recupera con su calle.

Records y serialización

Un record se serializa igual, con implements Serializable:

record Punto(int x, int y) implements Serializable {}

Al deserializarlo, Java llama a su constructor canónico, así que las validaciones que tengas en él se vuelven a ejecutar. Es más seguro que con una clase normal.

Cuándo no usar la serialización de Java

  • Seguridad: deserializar datos que vienen de fuera puede ejecutar código malicioso. No deserialices nunca bytes de una fuente en la que no confías.
  • Compatibilidad: el formato solo lo entiende Java y es frágil ante cambios en las clases.

Para una API REST, mensajes entre servicios o guardar datos, usa un formato de texto como JSON. Spring Boot convierte tus objetos a JSON automáticamente, sin Serializable. La serialización nativa queda para casos concretos, como algunas cachés o sesiones HTTP distribuidas.

Preguntas frecuentes

¿Qué es la serialización en Java?

Es el proceso de convertir un objeto en una secuencia de bytes para guardarlo o transmitirlo. El proceso inverso, que reconstruye el objeto, se llama deserialización.

¿Qué es Serializable en Java?

Una interfaz sin métodos del paquete java.io. Una clase la implementa para indicar que sus objetos se pueden serializar con ObjectOutputStream.

¿Para qué sirve transient?

Para excluir un campo de la serialización. Al deserializar, ese campo queda con su valor por defecto.

¿Qué pasa si no declaro serialVersionUID?

Java genera uno automáticamente. Si después cambias la clase, el valor cambia y los objetos guardados con la versión anterior fallan al deserializarse con InvalidClassException.

¿Necesito Serializable para devolver JSON en Spring Boot?

No. La conversión a JSON no usa la serialización nativa de Java, así que tus DTO no necesitan implementar Serializable.

Artículos relacionados

Newsletter Semanal de Java

Cada viernes recibe lo más nuevo del ecosistema Java: frameworks, herramientas y mejores prácticas.

Sin spam. Cancela cuando quieras.

Compartir artículo