Module litebridge.db.oracle

Package org.litebridge.db.oracle.convert

Class OracleOffsetDateTimeConverter

java.lang.Object

org.litebridge.convert.converter.OffsetDateTimeConverter

org.litebridge.db.oracle.convert.OracleOffsetDateTimeConverter

All Implemented Interfaces:

Converter<OffsetDateTime>, ConverterFunction<OffsetDateTime>, SqlConverter<OffsetDateTime>

public final class OracleOffsetDateTimeConverter
extends OffsetDateTimeConverter

A specialised converter for Oracle-specific OffsetDateTime SQL types.

This class extends OffsetDateTimeConverter to handle Oracle-specific TIMESTAMPTZ SQL types alongside the standard TIMESTAMP_WITH_TIMEZONE. It provides compatibility for Oracle's `TIMESTAMPTZ` type and ensures proper conversion to OffsetDateTime.

Key functionality includes:

• Conversion of Oracle-specific TIMESTAMPTZ objects to OffsetDateTime.
• Fallback handling to ZonedDateTime when direct conversion from TIMESTAMPTZ fails.
• Delegation to the parent class OffsetDateTimeConverter when the input value type is unsupported by this implementation.

The converter supports the following SQL types:

• Types.TIMESTAMP_WITH_TIMEZONE
• Oracle-specific OracleTypes.TIMESTAMPTZ

Thread safety: The class is immutable and thread-safe.

Constructor Summary

Constructors

Constructor	Description
OracleOffsetDateTimeConverter()

Method Summary

Modifier and Type	Method	Description
@Nullable OffsetDateTime	convert(@Nullable Object value)	Converts the given value to the target type.
int[]	sqlTypes()	Returns the SQL types associated with this converter.

Methods inherited from class org.litebridge.convert.converter.OffsetDateTimeConverter

type

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.litebridge.convert.converter.Converter

primitiveType

Constructor Details

OracleOffsetDateTimeConverter

public OracleOffsetDateTimeConverter()

Method Details

convert

public @Nullable OffsetDateTime convert(@Nullable Object value)

Description copied from interface: ConverterFunction

Converts the given value to the target type.

Specified by:

convert in interface ConverterFunction<OffsetDateTime>

Overrides:

convert in class OffsetDateTimeConverter

Parameters:

value - the value to convert, may be null

Returns:

the converted value, or null if the input was null or could not be converted

sqlTypes

public int[] sqlTypes()

Description copied from class: OffsetDateTimeConverter

Returns the SQL types associated with this converter.

Specified by:

sqlTypes in interface SqlConverter<OffsetDateTime>

Overrides:

sqlTypes in class OffsetDateTimeConverter

Returns:

an array containing Types.TIMESTAMP_WITH_TIMEZONE