ThreeTen-Extra JPA
This project contains utilities for persisting objects from the ThreeTen-Extra library using the Java Persistence API (JPA).
Getting Started
Prerequisites
ThreeTen-Extra JPA requires Java 8+ and JPA. The first two portions of this project's version number correspond to the JPA version that is required (e.g. 2.2.0 requires JPA 2.2).
Installation
To include ThreeTen-Extra JPA in a Maven project, add the following dependency:
<dependencies>
...
<dependency>
<groupId>com.stevenpaligo</groupId>
<artifactId>threeten-extra-jpa</artifactId>
<version>${threeten-extra-jpa.version}</version>
</dependency>
...
</dependencies>
For non-Maven projects, download the JAR from Maven's Central Repository. The list of dependencies can be found in the pom.xml file (see the source on GitHub)
Usage
Simply add this project as a Maven dependency or as a JAR on the classpath. The JPA converters will be discovered automatically.
The following table lists the valid combinations of ThreeTen-Extra classes and the database types:
ThreeTen-Extra Class | JPA-Supported Type | Database Type(s) | Comments |
---|---|---|---|
TaiInstant | BigDecimal | DECIMAL, NUMERIC | To correctly store the value, the database field must have a precision of 28 and a scale of 9 |
TaiInstant | String | CHAR, VARCHAR | To correctly store the value, the database field must have a length of at least 35 characters |
UtcInstant | String | CHAR, VARCHAR | To correctly store the value, the database field must have a length of at least 30 characters |
See the JavaDoc for more information.
Contributions
Contributions (bug reports, feature requests, etc.) are always welcome and should be coordinated through the GitHub Issues system.
Authors
- Steven Paligo - stevenpaligo.com
See also the list of contributors who participated in this project.
License
This project is licensed under the Apache License Version 2.0. See the license file file for details.