org.jdbi.v3.postgres

Class PostgresPlugin

java.lang.Object

org.jdbi.v3.postgres.PostgresPlugin

All Implemented Interfaces:

JdbiPlugin

public class PostgresPlugin
extends Object
implements JdbiPlugin

Postgres plugin. Adds support for binding and mapping the following data types:

• InetAddress (including Inet4Address and Inet6Address)
• LocalDate
• LocalTime
• LocalDateTime
• OffsetDateTime
• Duration (see notes below)
• Period (see notes below)
• Map<String, String> (for HSTORE columns)
• UUID

The following qualified types have Beta support for binding and mapping:

• @MacAddr java.lang.String (for MACADDR columns)
• @HStore Map<String, String> (for HSTORE columns)

Also sets up SQL array support for the following types:

• double
• float
• int
• long
• Double
• Float
• Integer
• Long
• String
• UUID

A note about the mapping between the Postgres interval type and the Java Period and Duration types: The Java library authors are much more strict about the temporal amounts representable by Periods and Durations than Postgres is with its interval type. The argument factories and column mapper factories implemented in this package respect this spirit of unambiguous strictness. Consequently:

• All Periods can be mapped to intervals.
• Not all Durations can be mapped to intervals.
• Not all intervals can be mapped to Periods.
• Not all intervals can be mapped to Durations.

For more specific detail, see the caveats in the documentation for DurationArgumentFactory, PeriodColumnMapperFactory, and DurationColumnMapperFactory.

In addition, some potentially unexpected implicit conversions can occur by virtue of the Postgres server logic. For example, at the time of writing, storing a Period of -3 years, 2 months, and -1 days results in an interval (and consequently, a column-mapped Period) of -2 years, -10 months, and -1 days.

Constructor Summary

Constructors

Constructor and Description
PostgresPlugin()

Method Summary

Modifier and Type	Method and Description
Handle	customizeHandle(Handle handle)
void	customizeJdbi(Jdbi jdbi)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.jdbi.v3.core.spi.JdbiPlugin

customizeConnection

Constructor Detail

PostgresPlugin

public PostgresPlugin()

Method Detail

customizeJdbi

public void customizeJdbi(Jdbi jdbi)

Specified by:

customizeJdbi in interface JdbiPlugin

customizeHandle

public Handle customizeHandle(Handle handle)

Specified by:

customizeHandle in interface JdbiPlugin