Go to file
Jake Wharton a270c6b19d Merge pull request #745 from mbrukman/docs-code-formatting
Added code formatting; removed HTML tags.
2015-11-27 16:27:25 -05:00
codegen Followup to r1175. Use the same copyright holder for all files. 2012-09-30 17:19:12 +00:00
examples/android-proguard-example Updated proguard.cfg example to Gson only settings 2015-10-18 10:21:32 -07:00
extras fix #680 - make RuntimeTypeAdapterFactory null-safe 2015-08-05 16:27:18 -07:00
gson [maven-release-plugin] prepare for next development iteration 2015-11-23 19:32:33 -08:00
lib moved lib at the top-level to share eclipse styles. 2008-09-01 03:27:34 +00:00
metrics Replace switch with if/else when processing whitespace. If/else is faster! 2012-08-27 04:17:29 +00:00
proto Thread safe method cache 2015-10-28 17:41:56 -04:00
.gitignore fixed pom and .gitignore 2015-10-03 17:27:25 -07:00
.travis.yml Add Travis CI build. 2015-06-17 22:20:00 -04:00
CHANGELOG.md Update CHANGELOG.md 2015-11-26 09:48:58 -08:00
GsonDesignDocument.md Imported Gson design document from 2015-11-24 17:49:04 -08:00
LICENSE added license 2015-04-13 10:03:52 -07:00
README.md Added code formatting; removed HTML tags. 2015-11-27 15:45:21 -05:00
ReleaseProcess.md Update ReleaseProcess.md 2015-11-24 17:39:47 -08:00
UserGuide.md Added code formatting; removed HTML tags. 2015-11-27 15:45:21 -05:00
pom.xml [maven-release-plugin] prepare for next development iteration 2015-11-23 19:32:33 -08:00

README.md

google-gson

Gson is a Java library that can be used to convert Java Objects into their JSON representation. It can also be used to convert a JSON string to an equivalent Java object. Gson can work with arbitrary Java objects including pre-existing objects that you do not have source-code of.

There are a few open-source projects that can convert Java objects to JSON. However, most of them require that you place Java annotations in your classes; something that you can not do if you do not have access to the source-code. Most also do not fully support the use of Java Generics. Gson considers both of these as very important design goals.

Gson Goals

  • Provide simple toJson() and fromJson() methods to convert Java objects to JSON and vice-versa
  • Allow pre-existing unmodifiable objects to be converted to and from JSON
  • Extensive support of Java Generics
  • Allow custom representations for objects
  • Support arbitrarily complex objects (with deep inheritance hierarchies and extensive use of generic types)

Gson Downloads

Gson Documentation

  • Gson API: Javadocs for the current Gson release
  • Gson user guide: This guide contains examples on how to use Gson in your code.
  • Gson Roadmap: Details of changes in the recent versions
  • Gson design document: This document discusses issues we faced while designing Gson. It also include a comparison of Gson with other Java libraries that can be used for Json conversion

Please use the google-gson Google group to discuss Gson, or to post questions.

Gson-related Content Created by Third Parties