BSON codecs JSR-310

BSON codecs for Java 8 Date and Time API (JSR-310).

License	Apache License 2.0
GroupId	io.github.cbartosiak
ArtifactId	bson-codecs-jsr310
Last Version	3.5.4
Release Date	Sep 3, 2019
Type	jar
Description	BSON codecs JSR-310 BSON codecs for Java 8 Date and Time API (JSR-310).
Project URL	https://github.com/cbartosiak/bson-codecs-jsr310
Source Code Management	https://github.com/cbartosiak/bson-codecs-jsr310

Download bson-codecs-jsr310

Filename	Size
bson-codecs-jsr310-3.5.4.pom
bson-codecs-jsr310-3.5.4.jar	72 KB
bson-codecs-jsr310-3.5.4-sources.jar	67 KB
bson-codecs-jsr310-3.5.4-javadoc.jar	691 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/io.github.cbartosiak/bson-codecs-jsr310/ -->
<dependency>
    <groupId>io.github.cbartosiak</groupId>
    <artifactId>bson-codecs-jsr310</artifactId>
    <version>3.5.4</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/io.github.cbartosiak/bson-codecs-jsr310/
implementation 'io.github.cbartosiak:bson-codecs-jsr310:3.5.4'

Gradle Kotlin

// https://jarcasting.com/artifacts/io.github.cbartosiak/bson-codecs-jsr310/
implementation ("io.github.cbartosiak:bson-codecs-jsr310:3.5.4")

Apache Buildr

'io.github.cbartosiak:bson-codecs-jsr310:jar:3.5.4'

Apache Ivy

<dependency org="io.github.cbartosiak" name="bson-codecs-jsr310" rev="3.5.4">
  <artifact name="bson-codecs-jsr310" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='io.github.cbartosiak', module='bson-codecs-jsr310', version='3.5.4')
)

Scala SBT

libraryDependencies += "io.github.cbartosiak" % "bson-codecs-jsr310" % "3.5.4"

Leiningen

[io.github.cbartosiak/bson-codecs-jsr310 "3.5.4"]

Dependencies

compile (1)

Group / Artifact	Type	Version
org.mongodb : bson	jar	3.11.0

test (2)

Group / Artifact	Type	Version
org.junit.jupiter : junit-jupiter-api	jar	5.5.1
org.junit.jupiter : junit-jupiter-engine	jar	5.5.1

Project Modules

There are no modules declared in this project.

BSON codecs for Java 8 Date and Time API (JSR-310)

The library provides codecs for the following JSR-310 classes:

• java.time.DayOfWeek
• java.time.Duration
• java.time.Instant
• java.time.LocalDate
• java.time.LocalDateTime
• java.time.LocalTime
• java.time.Month
• java.time.MonthDay
• java.time.OffsetDateTime
• java.time.OffsetTime
• java.time.Period
• java.time.Year
• java.time.YearMonth
• java.time.ZonedDateTime
• java.time.ZoneId
• java.time.ZoneOffset

Usage

In order to utilize the codecs one can use CodecRegistries helper, for example in case of Mongo synchronous client:

MongoClient mongoClient = MongoClients.create();

CodecRegistry codecRegistry = CodecRegistries.fromRegistries(
        MongoClientSettings.getDefaultCodecRegistry(),
        CodecRegistries.fromCodecs(new DurationAsDecimal128Codec())
);

MongoDatabase database = client
        .getDatabase(...)
        .withCodecRegistry(codecRegistry);

Note that depending on a context a different set of codecs might be necessary. There are three main factors to consider when choosing codecs:

• queryability - how much stored values are capable of being searched;
• sortability - how much stored values are capable of being ordered;
• readability - how much stored values are readable for human.

The table below presents the recommendations for all the factors. The more + signs a cell contains the better a row codec is in terms of a column factor:

Codec	Queryability	Sortability	Readability
DayOfWeekAsInt32Codec	++	++	+
DayOfWeekAsStringCodec	+		++
DurationAsDecimal128Codec	+	++
DurationAsDocumentCodec	++	+	+
DurationAsStringCodec			++
InstantAsDateTimeCodec	+	++	+
InstantAsDocumentCodec	++	+	+
InstantAsStringCodec			++
LocalDateAsDateTimeCodec	+	++	+
LocalDateAsDocumentCodec	++	+	+
LocalDateAsStringCodec			++
LocalDateTimeAsDateTimeCodec	+	++	+
LocalDateTimeAsDocumentCodec	++	+	+
LocalDateTimeAsStringCodec			++
LocalTimeAsDateTimeCodec	+	++	+
LocalTimeAsDocumentCodec	++	+	+
LocalTimeAsInt64Codec	++	++
LocalTimeAsStringCodec			++
MonthAsInt32Codec	++	++	+
MonthAsStringCodec	+		++
MonthDayAsDecimal128Codec	+	++	++
MonthDayAsDocumentCodec	++	+	+
MonthDayAsStringCodec			++
OffsetDateTimeAsDocumentCodec	++	+	+
OffsetDateTimeAsStringCodec			++
OffsetTimeAsDocumentCodec	++	+	+
OffsetTimeAsStringCodec			++
PeriodAsDocumentCodec	+		+
PeriodAsStringCodec			++
YearAsInt32Codec	++	++	++
YearMonthAsDecimal128Codec	+	++	++
YearMonthAsDocumentCodec	++	+	+
YearMonthAsStringCodec			++
ZonedDateTimeAsDocumentCodec	++	+	+
ZonedDateTimeAsStringCodec			++
ZoneIdAsStringCodec	+		++
ZoneOffsetAsInt32Codec	++	++
ZoneOffsetAsStringCodec	+		++

Versions

Version
3.5.4 Sep 3, 2019
3.4.0 Nov 23, 2018
3.3.0 Oct 26, 2018
3.2.0 Oct 23, 2018
3.1.3 Jun 15, 2018
3.1.2 May 24, 2018
3.1.1 May 21, 2018
3.1.0 May 21, 2018
3.0.4 Mar 8, 2018
3.0.3 Mar 7, 2018
3.0.2 Mar 7, 2018
3.0.1 Feb 26, 2018
3.0.0 Feb 26, 2018
2.0.1 Feb 14, 2018
2.0.0 Feb 14, 2018
1.3.6 Jan 24, 2018
1.3.5 Jan 18, 2018
1.3.4 Jan 14, 2018
1.3.3 Jan 14, 2018
1.3.2 Dec 30, 2017
1.3.1 Dec 30, 2017
1.3.0 Dec 21, 2017
1.2.2 Dec 16, 2017
1.2.1 Dec 16, 2017
1.2.0 Dec 10, 2017
1.1.0 Nov 14, 2017
1.0.3 Oct 29, 2017
1.0.2 Oct 28, 2017
1.0.1 Oct 28, 2017
1.0.0 Oct 28, 2017