amoscatelli/yasson

Eclipse Yasson project

Eclipse Yasson

Yasson is a Java framework which provides a standard binding layer between Java classes and JSON documents. This is similar to what JAXB is doing in the XML world. Yasson is an official reference implementation of JSON Binding (JSR-367).

It defines a default mapping algorithm for converting existing Java classes to JSON suitable for the most cases:

Jsonb jsonb = JsonbBuilder.create();
String result = jsonb.toJson(someObject);

For whom it's not enough it provides rich customization abilities through a set of annotations and rich programmatic API:

// Create custom configuration
JsonbConfig config = new JsonbConfig()
  .withNullValues(true)
  .withFormatting(true);

// Create Jsonb with custom configuration
Jsonb jsonb = JsonbBuilder.create(config);

// Use it!
String result = jsonb.toJson(someObject);

Questions?

Something not working right? Have an idea for an enhancement? Get in touch with the Yasson community in the following ways:

• Gitter: a free instant-messaging platform (similar to Slack) that anyone can join.
• Stackoverflow: As a question tagged [jsonb-api] and [yasson]
• Github Issues: Open issues for enhancement ideas or bug reports

Licenses

• Eclipse Distribution License 1.0 (BSD)
• Eclipse Public License 2.0

Links

• Yasson home page: https://projects.eclipse.org/projects/ee4j.yasson
• JSON-B official web site: https://eclipse-ee4j.github.io/jsonb-api/
• JSON-B API & spec project: https://github.com/eclipse-ee4j/jsonb-api
• JSR-367 page on JCP site: https://jcp.org/en/jsr/detail?id=367