Top Description Inners Fields Constructors Methods

org.postgresql.jdbc

pack-priv final Class ArrayEncoding

Class Inheritance

extends Object

java.lang.Object
org.postgresql.jdbc.ArrayEncoding

Imports

org.postgresql.core.BaseConnection, .Encoding, .Oid, org.postgresql.util.ByteConverter, .GT, .PSQLException, .PSQLState, org.checkerframework.checker.index.qual.Positive, java.io.ByteArrayOutputStream, .IOException, java.lang.reflect.Array, java.sql.SQLException, .SQLFeatureNotSupportedException, java.util.HashMap, .Map

Utility for using arrays in requests.

Binary format:

4 bytes with number of dimensions
4 bytes, boolean indicating nulls present or not
4 bytes type oid
8 bytes describing the length of each dimension (repeated for each dimension)

4 bytes for length
4 bytes for lower bound on length to check for overflow (it appears this value can always be 0)

data in depth first element order corresponding number and length of dimensions

4 bytes describing length of element, 0xFFFFFFFF (-1) means null
binary representation of element (iff not null).

Author: Brett Okken

Nested and Inner Type Summary

Modifier and Type	Class and Description
private abstract static class	ArrayEncoding.AbstractArrayEncoder< Base array type supported. A> Base class to implement `ArrayEncoding.ArrayEncoder` and provide multi-dimensional support.
pack-priv static interface	ArrayEncoding.ArrayEncoder<A>
private abstract static class	ArrayEncoding.FixedSizePrimitiveArrayEncoder< The primitive array to support. A> Base support for primitive arrays.
private abstract static class	ArrayEncoding.NumberArrayEncoder< The base type of array. N extends Number> Base class to provide support for `Number` based arrays.
private static class	ArrayEncoding.RecursiveArrayEncoder Wraps an `AbstractArrayEncoder` implementation and provides support for 2 or more dimensions using recursion.
private static class	ArrayEncoding.TwoDimensionPrimitiveArrayEncoder<A> Wraps an `AbstractArrayEncoder` implementation and provides optimized support for 2 dimensions.

Field Summary

Modifier and Type	Field and Description
private static final Map<Class<T>, ArrayEncoding.AbstractArrayEncoder<A>>	ARRAY_CLASS_TO_ENCODER
private static final ArrayEncoding.AbstractArrayEncoder<boolean[]>	BOOLEAN_ARRAY
private static final ArrayEncoding.AbstractArrayEncoder<Boolean[]>	BOOLEAN_OBJ_ARRAY
private static final ArrayEncoding.AbstractArrayEncoder<byte[][]>	BYTEA_ARRAY
private static final ArrayEncoding.AbstractArrayEncoder<double[]>	DOUBLE_ARRAY
private static final ArrayEncoding.AbstractArrayEncoder<Double[]>	DOUBLE_OBJ_ARRAY
private static final ArrayEncoding.AbstractArrayEncoder<float[]>	FLOAT_ARRAY
private static final ArrayEncoding.AbstractArrayEncoder<Float[]>	FLOAT_OBJ_ARRAY
private static final ArrayEncoding.AbstractArrayEncoder<int[]>	INT_ARRAY
private static final ArrayEncoding.AbstractArrayEncoder<Integer[]>	INT_OBJ_ARRAY
private static final ArrayEncoding.AbstractArrayEncoder<long[]>	LONG_ARRAY
private static final ArrayEncoding.AbstractArrayEncoder<Long[]>	LONG_OBJ_ARRAY
private static final ArrayEncoding.AbstractArrayEncoder<Object[]>	OBJECT_ARRAY
private static final ArrayEncoding.AbstractArrayEncoder<short[]>	SHORT_ARRAY
private static final ArrayEncoding.AbstractArrayEncoder<Short[]>	SHORT_OBJ_ARRAY
private static final ArrayEncoding.AbstractArrayEncoder<String[]>	STRING_ARRAY

Constructor Summary

Access	Constructor and Description
pack-priv	ArrayEncoding()

Method Summary

Modifier and Type	Method and Description
public static <A> ArrayEncoding.ArrayEncoder<A>	Returns: An instance capable of encoding array as a `String` at minimum. Some types may support binary encoding. getArrayEncoder(A The array to encode. Must not be `null`. array) Returns support for encoding array.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait