Package org.hibernate.engine.jdbc.env.internal

Class BlobAndClobCreator

java.lang.Object

org.hibernate.engine.jdbc.env.internal.AbstractLobCreator

org.hibernate.engine.jdbc.env.internal.BlobAndClobCreator

All Implemented Interfaces:

LobCreator

Direct Known Subclasses:

StandardLobCreator

public class BlobAndClobCreator
extends AbstractLobCreator
implements LobCreator

LobCreator which can use Connection.createBlob() and Connection.createClob(), but NClob references are created locally.

See Also:

• NClobProxy

Field Summary

Fields

Modifier and Type	Field	Description
static final LobCreationContext.Callback<Blob>	CREATE_BLOB_CALLBACK	Callback for performing contextual BLOB creation
static final LobCreationContext.Callback<Clob>	CREATE_CLOB_CALLBACK	Callback for performing contextual CLOB creation
static final LobCreationContext.Callback<NClob>	CREATE_NCLOB_CALLBACK	Callback for performing contextual NCLOB creation
protected final LobCreationContext	lobCreationContext
protected final boolean	useConnectionToCreateLob

Method Summary

Modifier and Type	Method	Description
Blob	createBlob(byte[] bytes)	Create a Blob object after reading a byte[] array from a JDBC ResultSet.
Blob	createBlob(InputStream stream, long length)	Create a Blob object after reading an InputStream from a JDBC ResultSet.
Clob	createClob(Reader reader, long length)	Create a Clob object after reading an InputStream from a JDBC ResultSet.
Clob	createClob(String string)	Create a Clob object after reading a String from a JDBC ResultSet.
NClob	createNClob(Reader reader, long length)	Create a NCLOB reference encapsulating the given character data.
NClob	createNClob(String string)	Create a NCLOB reference encapsulating the given String data.
Blob	toJdbcBlob(Blob blob)	Obtain a Blob instance which can be written to a JDBC PreparedStatement using PreparedStatement.setBlob(int, Blob).
Clob	toJdbcClob(Clob clob)	Obtain a Clob instance which can be written to a JDBC PreparedStatement using PreparedStatement.setClob(int, Clob).
NClob	toJdbcNClob(NClob clob)	Obtain an NClob instance which can be written to a JDBC PreparedStatement using PreparedStatement.setNClob(int, NClob).

Methods inherited from class org.hibernate.engine.jdbc.env.internal.AbstractLobCreator

wrap, wrap, wrap

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.hibernate.engine.jdbc.LobCreator

wrap, wrap, wrap

Field Details

CREATE_BLOB_CALLBACK

public static final LobCreationContext.Callback<Blob> CREATE_BLOB_CALLBACK

Callback for performing contextual BLOB creation

CREATE_CLOB_CALLBACK

public static final LobCreationContext.Callback<Clob> CREATE_CLOB_CALLBACK

Callback for performing contextual CLOB creation

CREATE_NCLOB_CALLBACK

public static final LobCreationContext.Callback<NClob> CREATE_NCLOB_CALLBACK

Callback for performing contextual NCLOB creation

lobCreationContext

protected final LobCreationContext lobCreationContext

useConnectionToCreateLob

protected final boolean useConnectionToCreateLob

Method Details

createBlob

public Blob createBlob(byte[] bytes)

Create a Blob object after reading a byte[] array from a JDBC ResultSet.

Specified by:

createBlob in interface LobCreator

Parameters:

bytes - The byte array to wrap as a blob.

Returns:

The created blob, castable to Blob as well as BlobImplementer

createBlob

public Blob createBlob(InputStream stream,
 long length)

Create a Blob object after reading an InputStream from a JDBC ResultSet.

Specified by:

createBlob in interface LobCreator

Parameters:

stream - The binary stream to wrap as a blob.

length - The length of the stream.

Returns:

The created blob, castable to Blob as well as BlobImplementer

Implementation Note:

It's very inefficient to use JDBC LOB locator creation to create a LOB with the contents of the given stream, since that requires reading the whole stream. So instead just wrap the given stream, just like what NonContextualLobCreator does.

createClob

public Clob createClob(String string)

Create a Clob object after reading a String from a JDBC ResultSet.

Specified by:

createClob in interface LobCreator

Parameters:

string - The String to wrap as a clob.

Returns:

The created clob, castable to Clob as well as ClobImplementer

createClob

public Clob createClob(Reader reader,
 long length)

Create a Clob object after reading an InputStream from a JDBC ResultSet.

Specified by:

createClob in interface LobCreator

Parameters:

reader - The character data reader.

length - The length of the reader data.

Returns:

The created clob, castable to Clob as well as ClobImplementer

Implementation Note:

It's very inefficient to use JDBC LOB locator creation to create a LOB with the contents of the given stream, since that requires reading the whole stream. So instead just wrap the given stream, just like what NonContextualLobCreator does.

createNClob

public NClob createNClob(String string)

Description copied from interface: LobCreator

Create a NCLOB reference encapsulating the given String data.

Specified by:

createNClob in interface LobCreator

Parameters:

string - The String to wrap as a NCLOB.

Returns:

The created NCLOB, castable as Clob as well as NClobImplementer. In JDK 1.6 environments, also castable to java.sql.NClob

createNClob

public NClob createNClob(Reader reader,
 long length)

Description copied from interface: LobCreator

Create a NCLOB reference encapsulating the given character data.

Specified by:

createNClob in interface LobCreator

Parameters:

reader - The character data reader.

length - The length of the reader data.

Returns:

The created NCLOB, castable as Clob as well as NClobImplementer. In JDK 1.6 environments, also castable to java.sql.NClob

toJdbcBlob

public Blob toJdbcBlob(Blob blob)

Obtain a Blob instance which can be written to a JDBC PreparedStatement using PreparedStatement.setBlob(int, Blob).

Specified by:

toJdbcBlob in interface LobCreator

Overrides:

toJdbcBlob in class AbstractLobCreator

See Also:

• PreparedStatement.setBlob(int, Blob)
• Dialect.useConnectionToCreateLob()

toJdbcClob

public Clob toJdbcClob(Clob clob)

Obtain a Clob instance which can be written to a JDBC PreparedStatement using PreparedStatement.setClob(int, Clob).

Specified by:

toJdbcClob in interface LobCreator

Overrides:

toJdbcClob in class AbstractLobCreator

See Also:

• PreparedStatement.setClob(int, Clob)
• Dialect.useConnectionToCreateLob()

toJdbcNClob

public NClob toJdbcNClob(NClob clob)

Obtain an NClob instance which can be written to a JDBC PreparedStatement using PreparedStatement.setNClob(int, NClob).

Specified by:

toJdbcNClob in interface LobCreator

Overrides:

toJdbcNClob in class AbstractLobCreator

See Also:

• PreparedStatement.setNClob(int, NClob)
• Dialect.useConnectionToCreateLob()