Class ArrayEncoding.NumberArrayEncoder<N extends Number>

java.lang.Object

org.postgresql.jdbc.ArrayEncoding.AbstractArrayEncoder<N[]>

org.postgresql.jdbc.ArrayEncoding.NumberArrayEncoder<N>

Type Parameters:

N - The base type of array.

All Implemented Interfaces:

ArrayEncoding.ArrayEncoder<N[]>

Enclosing class:

ArrayEncoding

private abstract static class ArrayEncoding.NumberArrayEncoder<N extends Number>
extends ArrayEncoding.AbstractArrayEncoder<N[]>

Base class to provide support for Number based arrays.

Field Summary

Fields

Modifier and Type	Field	Description
private final int	fieldSize

Fields inherited from class ArrayEncoding.AbstractArrayEncoder

arrayOid

Constructor Summary

Constructors

Constructor	Description
NumberArrayEncoder(int fieldSize, int oid, int arrayOid)

Method Summary

Modifier and Type	Method	Description
final void	appendArray(StringBuilder sb, char delim, N[] array)	Append String representation of array to sb.
(package private) final int	countNulls(N[] array)	Counts the number of null elements in array.
final byte[]	toBinaryRepresentation(BaseConnection connection, N[] array, int oid)	Creates binary representation of the array.
(package private) final byte[]	toSingleDimensionBinaryRepresentation(BaseConnection connection, N[] array)	Creates byte[] of just the raw data (no metadata).
protected abstract void	write(N number, byte[] bytes, int offset)	Write single value (number) to bytes beginning at offset.
private byte[]	writeBytes(N[] array, int nullCount, int offset)

Methods inherited from class ArrayEncoding.AbstractArrayEncoder

getDefaultArrayTypeOid, getTypeOID, supportBinaryRepresentation, toArrayString

Methods inherited from class Object

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

Field Details

fieldSize

private final int fieldSize

Constructor Details

NumberArrayEncoder

NumberArrayEncoder(int fieldSize,
 int oid,
 int arrayOid)

Parameters:

fieldSize - The fixed size to represent each value in binary.

oid - The base type oid.

arrayOid - The array type oid.

Method Details

countNulls

final int countNulls(N[] array)

Counts the number of null elements in array.

Overrides:

countNulls in class ArrayEncoding.AbstractArrayEncoder<N extends Number[]>

Parameters:

array - The array to count null elements in.

Returns:

The number of null elements in array.

toBinaryRepresentation

public final byte[] toBinaryRepresentation(BaseConnection connection,
 N[] array,
 int oid)
                                    throws SQLException,
SQLFeatureNotSupportedException

Creates binary representation of the array.

Parameters:

connection - The connection the binary representation will be used on. Attributes from the connection might impact how values are translated to binary.

array - The array to binary encode. Must not be null, but may contain null elements.

oid - The array type oid to use. Calls to ArrayEncoding.ArrayEncoder.supportBinaryRepresentation(int) must have returned true.

Returns:

The binary representation of array.

Throws:

SQLFeatureNotSupportedException - If ArrayEncoding.ArrayEncoder.supportBinaryRepresentation(int) is false for oid.

SQLException

toSingleDimensionBinaryRepresentation

final byte[] toSingleDimensionBinaryRepresentation(BaseConnection connection,
 N[] array)
                                            throws SQLException,
SQLFeatureNotSupportedException

Creates byte[] of just the raw data (no metadata).

Specified by:

toSingleDimensionBinaryRepresentation in class ArrayEncoding.AbstractArrayEncoder<N extends Number[]>

Parameters:

connection - The connection the binary representation will be used on.

array - The array to create binary representation of. Will not be null, but may contain null elements.

Returns:

byte[] of just the raw data (no metadata).

Throws:

SQLFeatureNotSupportedException - If ArrayEncoding.AbstractArrayEncoder.supportBinaryRepresentation(int) is false for oid.

SQLException

writeBytes

private byte[] writeBytes(N[] array,
 int nullCount,
 int offset)

write

protected abstract void write(N number,
 byte[] bytes,
 int offset)

Write single value (number) to bytes beginning at offset.

Parameters:

number - The value to write to bytes. This will never be null.

bytes - The byte[] to write to.

offset - The offset into bytes to write the number value.

appendArray

public final void appendArray(StringBuilder sb,
 char delim,
 N[] array)

Append String representation of array to sb.

Parameters:

sb - The StringBuilder to append to.

delim - The delimiter between elements.

array - The array to represent. Will not be null, but may contain null elements.