{"id":1618,"date":"2014-06-13T12:40:25","date_gmt":"2014-06-13T17:40:25","guid":{"rendered":"http:\/\/alejandroayala.solmedia.ec\/?p=1618"},"modified":"2014-06-13T12:41:46","modified_gmt":"2014-06-13T17:41:46","slug":"jpa-2-1-como-implementar-un-convertidor-de-tipo","status":"publish","type":"post","link":"https:\/\/alejandroayala.solmedia.ec\/?p=1618","title":{"rendered":"JPA 2.1 \u00bfC\u00f3mo implementar un Convertidor de Tipo?"},"content":{"rendered":"

JPA 2.1 viene con muchas mejoras. Una de estas es el Convertidor de Tipo<\/em><\/strong>. Permite al desarrollador especificar m\u00e9todos para convertir atributos \u00abmapeados\u00bb entre la base de datos y la representaci\u00f3n java.<\/p>\n

\u00bfQu\u00e9 puede ser convertido?<\/h2>\n

Un Convertidor<\/em> soporta conversiones de tipo de todas los atributos b\u00e1sicos definidos en las clases de entidad<\/strong>, clases \u00absuper\u00bb o clases embebidas. La \u00fanica excepci\u00f3n<\/strong> son los atributos \u00abId\u00bb, atributos de versi\u00f3n, atributos relacionados y atributos anotados con Temporal<\/em> o Enumarted<\/em>.<\/p>\n

<\/p>\n

\u00bfC\u00f3mo implementar un Convertidor?<\/h2>\n

Un convertidor deber\u00eda implementar la interfaz javax.persistence.AttributeConverter<X, Y><\/strong><\/em>, donde X<\/strong> es la clase que representa a la entidad y Y<\/strong> la clase de la representaci\u00f3n de base de datos del atributo. Adicionalmente un Convertidor<\/em> tiene que ser anotada con javax.persistence.Converter<\/strong><\/em>.
\nEl siguiente ejemplo muestra como la implementaci\u00f3n de un Convertidor<\/em> puede ser usado para almacenar en la base de datos un objeto java.awt.Color<\/strong><\/em> como un String<\/em> con el formato red|green|blue|alpha<\/em>. Cuando se lee la entidad desde la base de datos, el String<\/em> ser\u00e1 usado para instanciar un nuevo objeto Color<\/strong><\/em>.<\/p>\n

[java]
\npackage blog.thoughts.on.java.jpa21.converter;<\/p>\n

import java.awt.Color;<\/p>\n

import javax.persistence.AttributeConverter;
\nimport javax.persistence.Converter;<\/p>\n

@Converter
\npublic class ColorConverter implements AttributeConverter {<\/p>\n

private static final String SEPARATOR = "|";<\/p>\n

\/**
\n * Convert Color object to a String
\n * with format red|green|blue|alpha
\n *\/
\n @Override
\n public String convertToDatabaseColumn(Color color) {
\n StringBuilder sb = new StringBuilder();
\n sb.append(color.getRed()).append(SEPARATOR)
\n .append(color.getGreen())
\n .append(SEPARATOR)
\n .append(color.getBlue())
\n .append(SEPARATOR)
\n .append(color.getAlpha());
\n return sb.toString();
\n }<\/p>\n

\/**
\n * Convert a String with format red|green|blue|alpha
\n * to a Color object
\n *\/
\n @Override
\n public Color convertToEntityAttribute(String colorString) {
\n String[] rgb = colorString.split(SEPARATOR);
\n return new Color(Integer.parseInt(rgb[0]),
\n Integer.parseInt(rgb[1]),
\n Integer.parseInt(rgb[2]),
\n Integer.parseInt(rgb[3]));
\n }<\/p>\n

}<\/p>\n

[\/java]<\/p>\n

Como se puede ver la implementaci\u00f3n es simple y sencilla. Se necesita implementar un m\u00e9todo por cada conversi\u00f3n.<\/p>\n

\u00bfC\u00f3mo usar un Convertidor?<\/h2>\n

Hay dos opciones para definir el uso de un Convertidor<\/em>. La primera es configurar en la anotaci\u00f3n @Converter<\/strong><\/em> el atributo autoapply=true<\/em><\/strong>. En este caso el \u00abprovider<\/em> JPA<\/em>\u00bb usar\u00e1 este convertidor para convertir todas los atributos de entidad del tipo dado.
\nSi autoapply<\/em> es configurada como false<\/strong><\/em>, necesitas agregar la anotaci\u00f3n javax.persistence.Convert<\/strong><\/em> a todos los atributos que se quieran(puedan) convertir y especificar la clase Converter<\/strong><\/em>. El siguiente fragmento de c\u00f3digo muestra un ejemplo de este enfoque:<\/p>\n

[java]
\n@Entity
\npublic class RectangleEntity
\n{<\/p>\n

@Id
\n @GeneratedValue(strategy = GenerationType.IDENTITY)
\n private Integer id;<\/p>\n

@Column
\n private Integer x;<\/p>\n

@Column
\n private Integer y;<\/p>\n

@Column
\n @Convert(converter = ColorConverter.class)
\n private Color color;<\/p>\n

…
\n}
\n[\/java]<\/p>\n

Esto es todo lo que se necesita para realizar la implementaci\u00f3n de un simple Convertidor<\/em> de Tipo. Para mas caracter\u00edsticas avanzadas de conversiones, revisar la especificaci\u00f3n o los Java Doc<\/em> . Si quieres intentar hacerlo tu mismo, puedes usar Hibernate 4.3.0.Beta4<\/strong><\/em>, que es parte de la nueva versi\u00f3n Wildfly 8.0.0.Beta1.<\/strong><\/em><\/p>\n

Links<\/h3>\n

JPA 2.1 Specification<\/a>
\n Java Doc javax.persistence<\/a><\/p>\n

Traducci\u00f3n del art\u00edculo original:<\/strong> http:\/\/www.thoughts-on-java.org\/2013\/10\/jpa-21-how-to-implement-type-converter.html<\/a><\/p>\n\n

Twittear<\/a><\/div>\n","protected":false},"excerpt":{"rendered":"

JPA 2.1 viene con muchas mejoras. Una de estas es el Convertidor de Tipo. Permite al desarrollador especificar m\u00e9todos para convertir atributos \u00abmapeados\u00bb entre la base de datos y la representaci\u00f3n java. \u00bfQu\u00e9 puede ser convertido? Un Convertidor soporta conversiones de tipo de todas los atributos b\u00e1sicos definidos en las clases de entidad, clases \u00absuper\u00bb\u2026 Leer m\u00e1s »<\/a><\/span><\/p>\n","protected":false},"author":1,"featured_media":690,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0},"categories":[4],"tags":[445,173,506,203],"_links":{"self":[{"href":"https:\/\/alejandroayala.solmedia.ec\/index.php?rest_route=\/wp\/v2\/posts\/1618"}],"collection":[{"href":"https:\/\/alejandroayala.solmedia.ec\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/alejandroayala.solmedia.ec\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/alejandroayala.solmedia.ec\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/alejandroayala.solmedia.ec\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1618"}],"version-history":[{"count":3,"href":"https:\/\/alejandroayala.solmedia.ec\/index.php?rest_route=\/wp\/v2\/posts\/1618\/revisions"}],"predecessor-version":[{"id":1621,"href":"https:\/\/alejandroayala.solmedia.ec\/index.php?rest_route=\/wp\/v2\/posts\/1618\/revisions\/1621"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/alejandroayala.solmedia.ec\/index.php?rest_route=\/wp\/v2\/media\/690"}],"wp:attachment":[{"href":"https:\/\/alejandroayala.solmedia.ec\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1618"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/alejandroayala.solmedia.ec\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1618"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/alejandroayala.solmedia.ec\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1618"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}