⚠️

Acesso Antecipado (Beta)

Esta documentação refere-se a uma versão em acesso antecipado do SDK Sankhya. As funcionalidades e APIs estão sujeitas a modificações. Para obter acesso, envie um e-mail para [email protected] informando a appkey do seu projeto.

🗺️ Adaptadores de Tipos

Visão Geral

Em alguns cenários, o desenvolvedor pode precisar manipular tipos de dados que não possuem suporte nativo no SDK Sankhya ou na biblioteca Gson (responsável pela serialização e deserialização de JSON).

Para resolver isso, é possível criar Adaptadores de Tipo — componentes responsáveis por converter valores entre:

• Formatos JSON
• Objetos Java
• Valores compatíveis com o Jape (camada de persistência)

Adaptadores Globais

Adaptadores globais são aplicados automaticamente pelo SDK durante a manipulação de dados. Para criar um adaptador global, basta anotar uma classe com:

@br.com.sankhya.studio.stereotypes.GlobalTypeAdapter

Interfaces Disponíveis

A classe anotada pode implementar uma ou mais das interfaces abaixo:

Exemplo: Adaptador para ZonedDateTime

O tipo java.time.ZonedDateTime não possui suporte nativo pelo Gson, sendo necessário um adaptador para manipulá-lo.

O exemplo abaixo realiza:

• Conversão VO ↔ Jape (fromVO / toVO)
• Serialização JSON
• Deserialização JSON

@GlobalTypeAdapter
public class ZonedDateTimeAdapter implements JsonSerializer<ZonedDateTime>, TypeAdapter<ZonedDateTime>, JsonDeserializer<ZonedDateTime> {

    private static final DateTimeFormatter FORMATTER = DateTimeFormatter.ISO_OFFSET_DATE_TIME;

    @Override // O tipo Jape é java.util.Timestamp
    public ZonedDateTime fromVO(Object o) {
        if (o == null) {
            return null;
        }

        Timestamp ts = (Timestamp) o;
        return ts.toInstant().atZone(ZoneId.systemDefault());
    }

    @Override // O tipo Jape é java.util.Timestamp
    public Object toVO(ZonedDateTime zonedDateTime) {
        if (zonedDateTime == null) {
            return null;
        }

        return Timestamp.from(zonedDateTime.toInstant());
    }

    @Override
    public void setType(Class<? extends ZonedDateTime> aClass) {}

    @Override
    public ZonedDateTime deserialize(JsonElement jsonElement, Type type, JsonDeserializationContext context) throws JsonParseException {
        try {
            return ZonedDateTime.parse(jsonElement.getAsString(), FORMATTER);
        } catch (Exception e) {
            throw new JsonParseException("Erro ao desserializar ZonedDateTime: " + jsonElement, e);
        }
    }

    @Override
    public JsonElement serialize(ZonedDateTime zonedDateTime, Type type, JsonSerializationContext context) {
        return new JsonPrimitive(FORMATTER.format(zonedDateTime));
    }
}

Adaptadores Nativos

Abaixo estão os adaptadores de tipo nativos disponibilizados pelo SDK Sankhya. Eles são aplicados automaticamente quando não há um adapter customizado registrado para o tipo alvo.

Observação: A resolução de adapters segue a ordem de precedência: global → nativos.
Isso signfica que um adaptador Global pode Sobrescrever um nativo.

Conclusão

Adaptadores globais permitem estender o suporte nativo de tipos no SDK Sankhya, garantindo compatibilidade e consistência entre a camada de dados, JSON e objetos Java.

Caso tenha dúvidas, participe da comunidade desenvolvedora no portal ou entre em contato pelo e-mail informado no início desta página.