|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.springframework.jdbc.core.support.SqlLobValue
public class SqlLobValue
Object to represent an SQL BLOB/CLOB value parameter. BLOBs can either be an InputStream or a byte array. CLOBs can be in the form of a Reader, InputStream or String. Each CLOB/BLOB value will be stored together with its length. The type is based on which constructor is used. Objects of this class are immutable except for the LobCreator reference. Use them and discard them.
This class holds a reference to a LocCreator that must be closed after the update has completed. This is done via a call to the closeLobCreator method. All handling of the LobCreator is done by the framework classes that use it - no need to set or close the LobCreator for end users of this class.
A usage example:
JdbcTemplate jdbcTemplate = new JdbcTemplate(dataSource); // reusable object LobHandler lobHandler = new DefaultLobHandler(); // reusable object jdbcTemplate.update( "INSERT INTO imagedb (image_name, content, description) VALUES (?, ?, ?)", new Object[] { name, new SqlLobValue(contentStream, contentLength, lobHandler), new SqlLobValue(description, lobHandler) }, new int[] {Types.VARCHAR, Types.BLOB, Types.CLOB});
LobHandler
,
LobCreator
,
JdbcTemplate.update(String, Object[], int[])
,
SqlUpdate.update(Object[])
,
StoredProcedure.execute(java.util.Map)
Field Summary |
---|
Fields inherited from interface org.springframework.jdbc.core.SqlTypeValue |
---|
TYPE_UNKNOWN |
Constructor Summary | |
---|---|
SqlLobValue(byte[] bytes)
Create a new BLOB value with the given byte array, using a DefaultLobHandler. |
|
SqlLobValue(byte[] bytes,
LobHandler lobHandler)
Create a new BLOB value with the given byte array. |
|
SqlLobValue(InputStream stream,
int length)
Create a new BLOB/CLOB value with the given stream, using a DefaultLobHandler. |
|
SqlLobValue(InputStream stream,
int length,
LobHandler lobHandler)
Create a new BLOB/CLOB value with the given stream. |
|
SqlLobValue(Reader reader,
int length)
Create a new CLOB value with the given character stream, using a DefaultLobHandler. |
|
SqlLobValue(Reader reader,
int length,
LobHandler lobHandler)
Create a new CLOB value with the given character stream. |
|
SqlLobValue(String content)
Create a new CLOB value with the given content string, using a DefaultLobHandler. |
|
SqlLobValue(String content,
LobHandler lobHandler)
Create a new CLOB value with the given content string. |
Method Summary | |
---|---|
void |
cleanup()
Close the LobCreator, if any. |
void |
setTypeValue(PreparedStatement ps,
int paramIndex,
int sqlType,
String typeName)
Set the specified content via the LobCreator. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public SqlLobValue(byte[] bytes)
bytes
- the byte array containing the BLOB valueDefaultLobHandler
public SqlLobValue(byte[] bytes, LobHandler lobHandler)
bytes
- the byte array containing the BLOB valuelobHandler
- the LobHandler to be usedpublic SqlLobValue(String content)
content
- the String containing the CLOB valueDefaultLobHandler
public SqlLobValue(String content, LobHandler lobHandler)
content
- the String containing the CLOB valuelobHandler
- the LobHandler to be usedpublic SqlLobValue(InputStream stream, int length)
stream
- the stream containing the LOB valuelength
- the length of the LOB valueDefaultLobHandler
public SqlLobValue(InputStream stream, int length, LobHandler lobHandler)
stream
- the stream containing the LOB valuelength
- the length of the LOB valuelobHandler
- the LobHandler to be usedpublic SqlLobValue(Reader reader, int length)
reader
- the character stream containing the CLOB valuelength
- the length of the CLOB valueDefaultLobHandler
public SqlLobValue(Reader reader, int length, LobHandler lobHandler)
reader
- the character stream containing the CLOB valuelength
- the length of the CLOB valuelobHandler
- the LobHandler to be usedMethod Detail |
---|
public void setTypeValue(PreparedStatement ps, int paramIndex, int sqlType, String typeName) throws SQLException
setTypeValue
in interface SqlTypeValue
ps
- the PreparedStatement to work onparamIndex
- the index of the parameter for which we need to set the valuesqlType
- SQL type of the parameter we are settingtypeName
- the type name of the parameter (optional)
SQLException
- if a SQLException is encountered setting parameter values
(that is, there's no need to catch SQLException)Types
,
PreparedStatement.setObject(int, java.lang.Object, int, int)
public void cleanup()
cleanup
in interface DisposableSqlTypeValue
cleanup()
|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |