type-adapter

Adaptadores de Tipo (@GlobalTypeAdapter) — Addon Studio 2.0

@GlobalTypeAdapter registra adaptadores customizados no SDK para converter tipos entre JSON, objetos Java e valores Jape (camada de persistencia). Aplicado automaticamente em todo marshal/unmarshal de DTOs.

---

1. Quando criar um adaptador global

Use @GlobalTypeAdapter quando o tipo nao possui suporte nativo no SDK nem no Gson, ou quando o comportamento nativo precisa ser sobrescrito.

Casos de uso comuns:

Situacao	Exemplo
Tipo java.time.* nao coberto pelos nativos	ZonedDateTime, YearMonth
Conversao customizada JSON ↔ Java	Formato de data proprietario
Sobrescrever adaptador nativo do SDK	BooleanAdapter com logica diferente
Tipo de dominio especifico do addon	Value Objects, tipos wrapper

Precedencia: global > nativo. Adaptador global sobrescreve o nativo equivalente.

---

2. Interfaces disponíveis

Classe anotada com @GlobalTypeAdapter pode implementar uma ou mais:

Interface	Responsabilidade
TypeAdapter<T>	Converte o tipo entre objeto Java e valor Jape (banco/VO)
JsonSerializer<T>	Define como o tipo e convertido para JSON
JsonDeserializer<T>	Define como o tipo e convertido a partir de JSON

Implemente somente as interfaces necessarias para o caso de uso.

---

3. Anatomia de um @GlobalTypeAdapter

import br.com.sankhya.studio.adapters.TypeAdapter;
import br.com.sankhya.studio.stereotypes.GlobalTypeAdapter;
import com.google.gson.JsonDeserializationContext;
import com.google.gson.JsonDeserializer;
import com.google.gson.JsonElement;
import com.google.gson.JsonParseException;
import com.google.gson.JsonPrimitive;
import com.google.gson.JsonSerializationContext;
import com.google.gson.JsonSerializer;
import java.lang.reflect.Type;

@GlobalTypeAdapter
public class MeuTipoAdapter
        implements TypeAdapter<MeuTipo>, JsonSerializer<MeuTipo>, JsonDeserializer<MeuTipo> {

    // TypeAdapter<T> — conversao Java ↔ Jape (banco)
    @Override
    public MeuTipo fromVO(Object o) {
        if (o == null) return null;
        // converter valor do banco -> MeuTipo
    }

    @Override
    public Object toVO(MeuTipo value) {
        if (value == null) return null;
        // converter MeuTipo -> valor para banco
    }

    @Override
    public void setType(Class<? extends MeuTipo> aClass) {}  // geralmente vazio

    // JsonSerializer<T> — conversao Java -> JSON
    @Override
    public JsonElement serialize(MeuTipo value, Type type, JsonSerializationContext ctx) {
        return new JsonPrimitive(value.toString());
    }

    // JsonDeserializer<T> — conversao JSON -> Java
    @Override
    public MeuTipo deserialize(JsonElement el, Type type, JsonDeserializationContext ctx)
            throws JsonParseException {
        try {
            return MeuTipo.parse(el.getAsString());
        } catch (Exception e) {
            throw new JsonParseException("Erro ao desserializar MeuTipo: " + el, e);
        }
    }
}