guava-gson-serializers

Serialization support with GSON for Guava immutable collections

License	Apache License 2.0
Categories	Gson Data JSON Guava General Purpose Libraries Utility
GroupId	com.github.mike10004
ArtifactId	guava-gson-serializers
Last Version	0.6
Release Date	Jul 29, 2020
Type	jar
Description	guava-gson-serializers Serialization support with GSON for Guava immutable collections
Project URL	https://github.com/mike10004/guava-gson-serializers
Source Code Management	https://github.com/mike10004/guava-gson-serializers

Download guava-gson-serializers

Filename	Size
guava-gson-serializers-0.6.pom
guava-gson-serializers-0.6.jar	20 KB
guava-gson-serializers-0.6-sources.jar	10 KB
guava-gson-serializers-0.6-javadoc.jar	445 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.mike10004/guava-gson-serializers/ -->
<dependency>
    <groupId>com.github.mike10004</groupId>
    <artifactId>guava-gson-serializers</artifactId>
    <version>0.6</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.mike10004/guava-gson-serializers/
implementation 'com.github.mike10004:guava-gson-serializers:0.6'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.mike10004/guava-gson-serializers/
implementation ("com.github.mike10004:guava-gson-serializers:0.6")

Apache Buildr

'com.github.mike10004:guava-gson-serializers:jar:0.6'

Apache Ivy

<dependency org="com.github.mike10004" name="guava-gson-serializers" rev="0.6">
  <artifact name="guava-gson-serializers" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.mike10004', module='guava-gson-serializers', version='0.6')
)

Scala SBT

libraryDependencies += "com.github.mike10004" % "guava-gson-serializers" % "0.6"

Leiningen

[com.github.mike10004/guava-gson-serializers "0.6"]

Dependencies

compile (2)

Group / Artifact	Type	Version
com.google.guava : guava	jar	28.1-jre
com.google.code.gson : gson	jar	2.8.6

test (4)

Group / Artifact	Type	Version
org.junit.jupiter : junit-jupiter-params	jar	5.4.2
org.junit.jupiter : junit-jupiter-api	jar	5.4.2
org.junit.jupiter : junit-jupiter-engine	jar	5.4.2
org.assertj : assertj-core	jar	3.14.0

Project Modules

There are no modules declared in this project.

guava-gson-serializers

Expanded Gson serialization for Guava ImmutableCollections, ImmutableMaps, and Optionals.

I originally included a TypeFactory for both Optional (java.util and Guava) but that was a long time ago and I think most people have switched over to java.util.Optional.

There are a lot of libraries that handle serialization of the Java 8 classes (Optional, Instant, etc) so I'll deprecate java.util.Optional factory and keep the original Guava factory and keep this library more Guava-centric.

Why?

Re-writing serializers is tedious!

How?

A few ways.

For a specific class..

Gson gson = new GsonBuilder().registerTypeAdapter(ImmutableList.class, new ImmutableListDeserializer()).create();

or, if the mood grabs you.. (but really don't do this)

Gson gson = new GsonBuilder().registerTypeAdapter(List.class, new ImmutableListDeserializer()).create();

or, the easiest way

public Gson getGson() {
  return ImmutableTypeAdapters.withImmutableCollectionSerializers(new GsonBuilder())
    .registerTypeAdapterFactory(OptionalTypeFactory.forJDK()) // you probably dont need this
    .create();
}

Optionals

JDK (deprecated)

Gson gson = new GsonBuilder().registerTypeAdapterFactory(OptionalTypeFactory.forJDK()).create();

Guava

Gson gson = new GsonBuilder().registerTypeAdapterFactory(OptionalTypeFactory.forGuava()).create();

What?

Currently supported

• ImmutableList
• ImmutableSet
• ImmutableSortedSet
• ImmutableBiMap
• ImmutableMap
• ImmutableBiMap
• ImmutableSortedMap
• Optionals (java.util and guava)

Future support (maybe)

• ImmutableList/SetMultimap
• Whatever anyone asks me to do

Where?

Github packages registry! https://maven.pkg.github.com/acebaggins/guava-gson-serializers

Who?

Built by me for the wonderful Guava and Gson libraries.

Versions

Version
0.6 Jul 29, 2020