Usa el Convertir JSON a Clases Java gratuito abajo: tus datos nunca salen de tu navegador, todo el trabajo ocurre en tu dispositivo y no se sube a ningún servidor.
De JSON a Clases Java Sin Escribir Todo a Mano
Cuando una API devuelve JSON, el siguiente paso casi siempre es el mismo: crear clases Java que representen esos datos. Hacerlo a mano significa leer el documento campo por campo, decidir el tipo de cada uno y escribir getters y setters para todos. Es un trabajo lento y, además, propenso a errores pequeños que luego aparecen como valores nulos o fallos al convertir los datos. Esta herramienta hace esa parte mecánica por ti: pega el JSON, elige el nombre de la clase principal y pulsa Convertir.
El resultado es un conjunto de clases listas para copiar. Cada objeto del JSON se convierte en una clase. Cada arreglo de objetos se convierte en una lista de la clase correspondiente. Los textos se convierten en String, los números enteros en int, los decimales en double y los valores verdadero o falso en boolean. Todo ocurre en tu navegador, sin subir el JSON a ningún servidor.
Cómo Se Deciden los Tipos
La herramienta deduce cada tipo a partir del valor de ejemplo. Un número como 1024 es int. Un número como 87.5 es double. Un texto siempre es String, incluso cuando parece un número, porque el JSON no distingue entre un texto numérico y un texto normal. Si tu API envÃa un identificador entre comillas, como “1024”, la herramienta lo mantiene como String, y esa es la decisión segura.
Los arreglos siguen la misma lógica. La herramienta mira el primer elemento que no sea nulo y usa su tipo para toda la lista. Un arreglo de textos se convierte en una lista de String. Un arreglo de objetos se convierte en una lista de una clase nueva, con el nombre en singular: un arreglo llamado orders produce la clase Order. Un arreglo vacÃo no tiene elementos de los que aprender, asà que se convierte en una lista de Object. La herramienta no inventa un tipo cuando no tiene información, y eso es preferible a un tipo incorrecto.
Los valores nulos reciben el mismo trato honesto: un campo con valor nulo se convierte en Object. Cámbialo por el tipo real cuando lo sepas, ya que las respuestas de ejemplo suelen mostrar nulos en campos que normalmente tienen valor, como un código de descuento.
Objetos Anidados y Nombres de Clase
Las respuestas reales casi nunca son planas. Un usuario tiene una dirección. Un pedido tiene artÃculos. Cada objeto anidado se convierte en su propia clase, con un nombre derivado del campo que lo contiene. La dirección se convierte en la clase Address y los pedidos en la clase Order. Si dos campos dieran lugar al mismo nombre de clase, la herramienta numera el segundo para que el código siga compilando.
Los nombres de campo se adaptan al estilo Java. Una clave como zip_code se convierte en zipCode, y una clave como ZIP code también. Los getters y setters siguen el patrón habitual, con la primera letra en mayúscula: zipCode recibe getZipCode y setZipCode. Con Jackson o Gson, estas clases funcionan con la configuración por defecto en la mayorÃa de los casos, porque los nombres de campo coinciden con las claves del JSON tras las reglas habituales de nombres.
Cómo Usar el Resultado en tu Proyecto
Empieza con la respuesta más completa que tengas, no con un ejemplo mÃnimo. Copia el JSON completo desde tu cliente de API o desde la pestaña de red del navegador, con todas sus partes anidadas. Pega, convierte y lee el resultado de principio a fin. Presta atención a las clases de los objetos anidados y a los campos que salieron de valores nulos o arreglos vacÃos. Cambia el nombre de la clase principal por algo con significado, como RespuestaApi o PerfilUsuario, en lugar de dejar Root.
Después, añade las anotaciones que tu proyecto necesite: JsonProperty con Jackson en los campos cuyo nombre difiere de la clave original, o nada con Gson, donde el comportamiento por defecto suele bastar. Si tu API a veces envÃa un número como texto, cambia ese campo a String y conviértelo en tu propio código.
Prueba el modelo con una respuesta real antes de confiar en él, y comprueba que todos los campos se llenan. FÃjate en especial en los números: un identificador que hoy cabe en un int puede superarlo mañana, y un precio como 49.99 necesita un double.
Errores Frecuentes
El error más frecuente es convertir una muestra demasiado pequeña. Una muestra con un solo pedido no muestra si el arreglo de pedidos puede tener formas distintas. Una muestra sin dirección no genera la clase Address. Convierte siempre la respuesta más grande y completa que tengas. El segundo error es confiar ciegamente en los tipos deducidos. La herramienta lee un solo documento, y tu API puede enviar variaciones. Revisa el resultado como revisarÃas el código de un compañero.
El tercer error es olvidar que las claves JSON pueden contener caracteres que Java no admite en identificadores. Las claves con espacios o guiones se convierten aquà a camelCase, pero tu conversor aún necesita relacionar la clave original con el nombre nuevo, con JsonProperty en Jackson o SerializedName en Gson. Sin esa relación, el campo quedará nulo.
Privacidad
Todo funciona en tu navegador: tu JSON nunca sale de tu dispositivo ni se guarda. Puedes convertir respuestas con datos reales, aunque conviene no pegar secretos como tokens o contraseñas. La herramienta es gratuita y no necesita cuenta.