Class PGbytea

java.lang.Object

org.postgresql.util.PGbytea

public class PGbytea
extends Object

Converts to and from the postgresql bytea datatype used by the backend.

Field Summary

Fields

Modifier and Type	Field	Description
private static final int[]	HEX_VALS	Lookup table for each of the valid ascii code points (offset by '0') to the 4 bit numeric value.
private static final int	MAX_3_BUFF_SIZE

Constructor Summary

Constructors

Constructor	Description
PGbytea()

Method Summary

Modifier and Type	Method	Description
static void	appendHexString(StringBuilder sb, byte[] buf, int offset, int length)	Appends given byte array as hex string.
private static int	getHex(byte b)
static byte[]	toBytes(byte[] s)
private static byte[]	toBytesHexEscaped(byte[] s)
private static byte[]	toBytesOctalEscaped(byte[] s)
static String	toPGLiteral(Object value)	Deprecated. prefer toPGLiteral(Object, SqlSerializationContext) to clarify the behaviour regarding InputStream objects
static String	toPGLiteral(Object value, SqlSerializationContext context)	Formats input object as bytea literal like '\xcafebabe'::bytea.
static String	toPGString(byte[] buf)

Methods inherited from class Object

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

Field Details

MAX_3_BUFF_SIZE

private static final int MAX_3_BUFF_SIZE

See Also:

• Constant Field Values

HEX_VALS

private static final int[] HEX_VALS

Lookup table for each of the valid ascii code points (offset by '0') to the 4 bit numeric value.

Constructor Details

PGbytea

public PGbytea()

Method Details

toBytes

public static byte[] toBytes(byte[] s)
                      throws SQLException

Throws:

SQLException

toBytesHexEscaped

private static byte[] toBytesHexEscaped(byte[] s)

getHex

private static int getHex(byte b)

toBytesOctalEscaped

private static byte[] toBytesOctalEscaped(byte[] s)

toPGString

public static String toPGString(byte[] buf)

appendHexString

public static void appendHexString(StringBuilder sb,
 byte[] buf,
 int offset,
 int length)

Appends given byte array as hex string. See HexEncodingBenchmark for the benchmark.

Parameters:

sb - output builder

buf - buffer to append

offset - offset within the buffer

length - the length of sequence to append

toPGLiteral

@Deprecated
public static String toPGLiteral(Object value)
                          throws IOException

Deprecated.

prefer toPGLiteral(Object, SqlSerializationContext) to clarify the behaviour regarding InputStream objects

Formats input object as bytea literal like '\xcafebabe'::bytea. The following inputs are supported: byte[], StreamWrapper, and ByteStreamWriter.

Parameters:

value - input value to format

Returns:

formatted value

Throws:

IOException - in case there's underflow in the input value

toPGLiteral

public static String toPGLiteral(Object value,
 SqlSerializationContext context)
                          throws IOException

Formats input object as bytea literal like '\xcafebabe'::bytea. The following inputs are supported: byte[], StreamWrapper, and ByteStreamWriter.

Parameters:

value - input value to format

context - specifies configuration for converting the parameters to string

Returns:

formatted value

Throws:

IOException - in case there's underflow in the input value