Laboratorul 12: Programare Avansată Java

• Autori: Florian-Luis Micu , Sorina-Anamaria Buf , Ștefan Cocioran
• Data publicării: 12.01.2026
• Data ultimei modificări: 12.01.2026

Serializarea reprezintă procesul prin care un obiect Java este transformat într-o reprezentare transferabilă, de regulă o secvență de bytes sau un format text, astfel încât să poată fi:

• salvat pe disc
• transmis prin rețea
• stocat temporar (cache)
• restaurat ulterior în memorie

Operația inversă se numește deserializare și presupune refacerea obiectului original din această reprezentare.

Serializarea este folosită în special pentru:

• salvarea stării unei aplicații
• persistarea temporară a obiectelor
• transfer de date între procese sau servicii
• sisteme de cache distribuit
• mecanisme de rollback / snapshot

Pentru ca un obiect să poată fi serializat de JVM folosind mecanismul nativ, clasa sa trebuie să implementeze interfața: java.io.Serializable.

public class User implements Serializable {
    private String name;
    private int age;
}

Această interfață:

• este un marker interface (deci nu definește metode),
• este verificată de JVM la runtime,
• permite folosirea claselor ObjectOutputStream și ObjectInputStream.

Dacă un obiect nu este serializabil, JVM aruncă NotSerializableException.

1. Clasa model

import java.io.Serializable;
 
public class Person implements Serializable {
    private String name;
    private int age;
 
    public Person(String name, int age) {
        this.name = name;
        this.age = age;
    }
 
    @Override
    public String toString() {
        return name + " (" + age + ")";
    }
}

2. Serializarea unui obiect

import java.io.FileOutputStream;
import java.io.ObjectOutputStream;
 
public class SerializeDemo {
    public static void main(String[] args) throws Exception {
        Person p = new Person("Ana", 30);
 
        ObjectOutputStream out =
            new ObjectOutputStream(new FileOutputStream("person.ser"));
 
        out.writeObject(p);
        out.close();
 
        System.out.println("Object serialized.");
    }
}

3. Deserializarea unui obiect

import java.io.FileInputStream;
import java.io.ObjectInputStream;
 
public class DeserializeDemo {
    public static void main(String[] args) throws Exception {
        ObjectInputStream in =
            new ObjectInputStream(new FileInputStream("person.ser"));
 
        Person p = (Person) in.readObject();
        in.close();
 
        System.out.println("Deserialized: " + p);
    }
}

Object serialized.
Deserialized: Ana (30)

Nu toate câmpurile unui obiect ar trebui serializate. Exemple tipice:

• parole
• token-uri
• conexiuni
• cache-uri

Pentru a exclude un câmp de la serializare folosim cuvântul cheie transient.

public class Account implements Serializable {
    private String username;
    private transient String password;
}

Câmpul serialVersionUID identifică versiunea unei clase serializate.

private static final long serialVersionUID = 1L;

Acest identificator este folosit de JVM pentru a verifica dacă o clasă este compatibilă cu obiectul serializat, astfel putem garanta compatibilitatea operațiilor.

Jackson este o bibliotecă externă foarte populară care permite:

• serializarea obiectelor Java în JSON,
• deserializarea JSON-ului în obiecte Java.

Spre deosebire de serializarea nativă:

• nu folosește format binar,
• nu necesită Serializable,
• este independentă de JVM.

De ce este Jackson preferat în aplicațiile moderne?

• JSON este lizibil și ușor de debugat,
• este interoperabil cu alte limbaje,
• permite control fin prin adnotări,
• este mult mai sigur decât serializarea nativă.

Este standardul de facto pentru:

• API-uri REST,
• microservicii,
• testare și integrare.

1. Dependința Jackson

Într-un proiect real (Maven), Jackson se adaugă astfel:

pom.xml

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.16.1</version>
</dependency>

2. Clasa model

import com.fasterxml.jackson.annotation.JsonIgnore;
import com.fasterxml.jackson.annotation.JsonProperty;
 
public class User {
 
    private String name;
    private int age;
 
    @JsonIgnore
    private String password;
 
    public User() {
        // constructor fără parametri NECESAR pentru deserializare
    }
 
    public User(String name, int age, String password) {
        this.name = name;
        this.age = age;
        this.password = password;
    }
 
    public String getName() {
        return name;
    }
 
    public int getAge() {
        return age;
    }
 
    @JsonProperty("years")
    public void setAge(int age) {
        this.age = age;
    }
 
    public String getPassword() {
        return password;
    }
 
    @Override
    public String toString() {
        return "User{name='" + name + "', age=" + age + "}";
    }
}

3. Serializare: obiect → JSON

import com.fasterxml.jackson.databind.ObjectMapper;
 
public class JacksonSerializeDemo {
 
    public static void main(String[] args) throws Exception {
 
        ObjectMapper mapper = new ObjectMapper();
 
        User user = new User("Ana", 30, "secret123");
 
        String json = mapper.writeValueAsString(user);
 
        System.out.println("JSON rezultat:");
        System.out.println(json);
    }
}

{"name":"Ana","age":30}

4. Deserializare: JSON → obiect

import com.fasterxml.jackson.databind.ObjectMapper;
 
public class JacksonDeserializeDemo {
 
    public static void main(String[] args) throws Exception {
 
        ObjectMapper mapper = new ObjectMapper();
 
        String json = """
        {
          "name": "Ion",
          "years": 25,
          "password": "shouldBeIgnored"
        }
        """;
 
        User user = mapper.readValue(json, User.class);
 
        System.out.println("Obiect deserializat:");
        System.out.println(user);
    }
}

User{name='Ion', age=25}

5. Serializare în fișier și citire din fișier

Scriere în fișier

mapper.writeValue(new File("user.json"), user);

Citire din fișier

User user = mapper.readValue(new File("user.json"), User.class);

Adnotările sunt metadate atașate elementelor din codul Java (clase, metode, câmpuri, parametri).

Ele nu modifică direct logica programului, ci oferă informații suplimentare care pot fi interpretate de:

• compilator
• JVM
• framework-uri
• tool-uri externe (JUnit, Jackson, Spring etc.)

Cu alte cuvinte, adnotările spun ce este codul, nu ce face.

Adnotările au apărut pentru a elimina:

• configurații externe (XML)
• cod repetitiv (boilerplate)
• convenții fragile bazate pe nume

Astăzi, ele sunt fundamentale în:

• serializare/deserializare (Jackson)
• testare (JUnit)
• dependency injection (Spring)
• validare
• ORM (Hibernate)

@AnnotationName
public class Example { }

Adnotările pot avea parametri:

@JsonProperty("user_name")
private String name;

sau mai mulți:

@MyAnnotation(value = "test", enabled = true)

Prin @Target putem controla unde este permisă adnotarea:

• TYPE – clase, interfețe
• FIELD – câmpuri
• METHOD – metode
• PARAMETER – parametri
• CONSTRUCTOR
• LOCAL_VARIABLE

Exemplu:

@Target(ElementType.FIELD)

@Retention definește cât timp există adnotarea:

@Retention(RetentionPolicy.RUNTIME)

Tipuri:

• SOURCE – doar la compilare (ex: @Override)
• CLASS – în bytecode, dar nu la runtime
• RUNTIME – disponibilă prin reflection (cea mai importantă)

@Override
public String toString() { ... }

• verifică dacă metoda chiar suprascrie una din părinte
• previne erori de semnătură

@Deprecated
public void oldMethod() { }

• marchează cod care nu mai trebuie folosit
• IDE-ul afișează warning

@SuppressWarnings("unchecked")

• dezactivează warning-uri ale compilatorului
• trebuie folosit cu atenție

Jackson folosește adnotări pentru a controla serializarea:

@JsonIgnore
private String password;

@JsonProperty("years")
private int age;

Aceste adnotări:

• sunt citite prin reflection
• influențează comportamentul ObjectMapper

1. Definirea adnotării

import java.lang.annotation.*;
 
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface Important {
    String value() default "";
}

2. Utilizarea adnotării

public class Person {
 
    @Important("primary identifier")
    private String name;
 
    private int age;
}

import java.lang.reflect.Field;
 
public class AnnotationDemo {
 
    public static void main(String[] args) throws Exception {
 
        Class<Person> clazz = Person.class;
 
        for (Field field : clazz.getDeclaredFields()) {
            if (field.isAnnotationPresent(Important.class)) {
                Important imp = field.getAnnotation(Important.class);
                System.out.println(field.getName() + " -> " + imp.value());
            }
        }
    }
}

name -> primary identifier

Java definește trei momente distincte în care adnotările pot fi citite sau folosite:

1. La compilare (compile-time)

Adnotările cu:

@Retention(RetentionPolicy.SOURCE)

sunt:

• disponibile doar în timpul compilării
• eliminate complet din bytecode
• folosite de compilator sau tool-uri

Exemplu:

@Override

Rol:

• verificare de corectitudine
• warning-uri / erori de compilare

2. După compilare, înainte de rulare (build-time / processing)

Unele adnotări sunt procesate prin Annotation Processors (APT – Annotation Processing Tool).

Acestea:

• rulează după compilare
• pot genera cod
• pot valida structura codului

Exemple reale:

• Lombok (@Getter, @Setter)
• MapStruct
• AutoValue

3. La runtime (execuție)

Adnotările cu:

@Retention(RetentionPolicy.RUNTIME)

sunt:

• păstrate în bytecode
• disponibile prin Reflection
• interpretate de framework-uri

Exemple:

• Jackson (@JsonProperty)
• JUnit (@Test)
• Spring (@Autowired)

Acesta este cel mai important caz pentru Java modern.

Reflection este mecanismul prin care un program Java poate:

• inspecta structura claselor la runtime
• accesa câmpuri, metode, constructori
• crea obiecte dinamic
• invoca metode fără a le cunoaște la compilare

Cu alte cuvinte, Reflection permite unui program să se auto-analizeze și să se auto-manipuleze în timpul execuției.

Reflection a fost introdus pentru a permite:

• framework-uri generice (Spring, Hibernate, Jackson, JUnit)
• extensibilitate fără modificarea codului
• comportament configurabil prin metadate (adnotări)

Fără Reflection:

• multe framework-uri moderne nu ar fi posibile
• codul ar fi rigid și greu de extins

Reflection nu înlocuiește programarea clasică. Este:

• mai lentă
• mai greu de citit
• mai periculoasă

De aceea este folosită:

• rar
• controlat
• în infrastructură, nu în logica de business

Orice operație de Reflection pornește de la un obiect de tip Class<?>.

Există trei modalități principale de a obține un Class:

Class<String> c1 = String.class;
Class<?> c2 = "hello".getClass();
Class<?> c3 = Class.forName("java.lang.String");

Toate cele trei referințe indică aceeași clasă la runtime.

Presupunem următoarea clasă:

public class Person {
    private String name;
    private int age;
 
    public Person(String name, int age) { }
 
    public String getName() { return name; }
}

Câmpuri

Field[] fields = Person.class.getDeclaredFields();
 
for (Field f : fields) {
    System.out.println(f.getName());
}

name
age

Metode

Method[] methods = Person.class.getDeclaredMethods();
 
for (Method m : methods) {
    System.out.println(m.getName());
}

Constructori

Constructor<?>[] constructors = Person.class.getDeclaredConstructors();
 
for (Constructor<?> c : constructors) {
    System.out.println(c);
}

Reflection permite accesarea membrilor private, ocolind encapsularea.

Person p = new Person("Ana", 30);
 
Field field = Person.class.getDeclaredField("name");
field.setAccessible(true);
 
String value = (String) field.get(p);
System.out.println(value);

Method m = Person.class.getDeclaredMethod("getName");
String result = (String) m.invoke(p);
 
System.out.println(result);

Reflection permite:

• apelarea metodelor necunoscute la compilare
• decuplarea codului

Constructor<Person> ctor =
    Person.class.getConstructor(String.class, int.class);
 
Person p = ctor.newInstance("Ion", 25);

Acesta este mecanismul folosit de:

• Jackson
• Hibernate
• Spring

Reflection este mecanismul prin care adnotările RUNTIME sunt citite.

Exemplu:

@Retention(RetentionPolicy.RUNTIME)
@interface Info {
    String value();
}

@Retention(RetentionPolicy.RUNTIME)
@interface Info {
    String value();
}

Citire la runtime:

Info info = Person.class.getAnnotation(Info.class);
System.out.println(info.value());

Reflection este folosit pentru:

• scanarea claselor
• identificarea adnotărilor
• apelarea metodelor automat

Exemple:

• JUnit → caută metode cu @Test
• Jackson → caută câmpuri și constructori
• Spring → injectează dependențe

Reflection:

• este mai lentă decât apelurile directe
• elimină verificările de tip la compilare
• poate produce erori doar la runtime

Assertions sunt afirmații folosite pentru a verifica ipoteze interne ale programului în timpul execuției. Ele exprimă condiții care ar trebui să fie mereu adevărate dacă programul funcționează corect.

Aserțiile nu sunt mecanisme de tratare a erorilor și nu înlocuiesc excepțiile.

Assertions sunt folosite pentru:

• detectarea bug-urilor logice
• validarea presupunerilor interne
• documentarea implicită a codului

assert condition;

Sau cu mesaj:

assert condition : "Mesaj de eroare";

public int divide(int a, int b) {
    assert b != 0 : "b must not be zero";
    return a / b;
}

Dacă b este 0, programul va eșua doar dacă assertions sunt activate.

Assertions sunt dezactivate implicit.

Se activează la rulare:

java -ea Main