Repolode
Enviar
google

google/gson

Una biblioteca Java para convertir objetos Java a JSON y viceversa, incluso si no tienes el código fuente de esos objetos.

Ver en GitHub
Estrellas
24,238
Forks
4,491
Issues abiertos
340
Último commit
hace 10 días

¿Qué es?

Gson convierte objetos Java en cadenas JSON mediante los métodos sencillos toJson() y fromJson(), y puede analizar JSON para reconstruir objetos Java equivalentes. A diferencia de muchas alternativas, no requiere anotaciones Java en tus clases, por lo que funciona con objetos existentes o que no se pueden modificar, cuyo código fuente no puedes cambiar.

La biblioteca pone especial énfasis en Java Generics y busca admitir objetos profundamente anidados, jerarquías de herencia profundas y tipos genéricos. Los desarrolladores también pueden definir representaciones personalizadas para los objetos cuando la asignación predeterminada no resulta adecuada.

Gson se encuentra actualmente en modo de mantenimiento: se corrigen los errores existentes, pero es poco probable que se añadan funciones nuevas de gran alcance. El proyecto se centra en Java; no se recomienda para aplicaciones de lanzamiento en Android porque su runtime basado en reflexión entra en conflicto con la reducción de código y la ofuscación.

Funciones clave

  • 01Convierte objetos Java a JSON con toJson() y viceversa con fromJson()
  • 02Funciona con clases sin código fuente o sin anotaciones
  • 03Compatibilidad amplia con Java Generics
  • 04Permite definir representaciones personalizadas para la serialización de objetos
  • 05Admite jerarquías de herencia profundas y objetos complejos y anidados

Casos de uso

  • Analizar respuestas JSON de API y convertirlas en clases de modelo Java
  • Serializar a JSON objetos Java de terceros o que no se pueden modificar
  • Guardar el estado de objetos Java en archivos JSON
  • Crear backends Java que intercambian datos JSON

Inicio rápido

  1. 1

    Añade la dependencia de Gson a tu compilación de Gradle

    implementation 'com.google.code.gson:gson:2.14.0'
  2. 2

    O añade la dependencia de Gson al archivo pom.xml de Maven

  3. 3

    Compila el proyecto desde el código fuente con Maven

    mvn clean verify

Antes de usarlo

  • Gson está en modo de mantenimiento, por lo que es poco probable que se añadan nuevas funciones importantes.
  • No se recomienda usar Gson para gestionar JSON en Android, ya que la reflexión puede dejar de funcionar al aplicar reducción y ofuscación.
  • Para compilar desde el código fuente se necesita JDK 17 o posterior, y no se admiten versiones más recientes de JDK para la compilación.

Temas

#java#json#serialization#deserialization#generics#library

Preguntas frecuentes

¿Qué es gson?
Una biblioteca Java para convertir objetos Java a JSON y viceversa, incluso si no tienes el código fuente de esos objetos. Gson convierte objetos Java en cadenas JSON mediante los métodos sencillos toJson() y fromJson(), y puede analizar JSON para reconstruir objetos Java equivalentes. A diferencia de muchas alternativas, no requiere anotaciones Java en tus clases, por lo que funciona con objetos existentes o que no se pueden modificar, cuyo código fuente no puedes cambiar.
¿gson es gratuito? ¿Qué licencia tiene?
gson es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿gson sigue mantenido?
Mantenimiento activo. El último commit de gson fue el 11 oct 2026.
¿Para qué puedo usar gson?
Analizar respuestas JSON de API y convertirlas en clases de modelo Java Serializar a JSON objetos Java de terceros o que no se pueden modificar Guardar el estado de objetos Java en archivos JSON Crear backends Java que intercambian datos JSON
¿Cómo se instala gson?
Añade la dependencia de Gson a tu compilación de Gradle: implementation 'com.google.code.gson:gson:2.14.0' O añade la dependencia de Gson al archivo pom.xml de Maven Compila el proyecto desde el código fuente con Maven: mvn clean verify
¿Dónde consigo gson?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/google/gson

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados