ValueLobDb

java.lang.Object
- org.h2.value.VersionedValue
- - org.h2.value.Value
  - - org.h2.value.ValueLobDb

```
public class ValueLobDb
extends Value
```
A implementation of the BLOB and CLOB data types. Small objects are kept in memory and stored in the record. Large objects are either stored in the database, or in temporary files.

Field Summary
- Fields inherited from class org.h2.value.Value
  ARRAY, BLOB, BOOLEAN, BYTE, BYTES, CLOB, DATE, DECIMAL, DOUBLE, ENUM, FLOAT, GEOMETRY, INT, INTERVAL_DAY, INTERVAL_DAY_TO_HOUR, INTERVAL_DAY_TO_MINUTE, INTERVAL_DAY_TO_SECOND, INTERVAL_HOUR, INTERVAL_HOUR_TO_MINUTE, INTERVAL_HOUR_TO_SECOND, INTERVAL_MINUTE, INTERVAL_MINUTE_TO_SECOND, INTERVAL_MONTH, INTERVAL_SECOND, INTERVAL_YEAR, INTERVAL_YEAR_TO_MONTH, JAVA_OBJECT, JSON, LONG, MIN_LONG_DECIMAL, NULL, RESULT_SET, ROW, SHORT, STRING, STRING_FIXED, STRING_IGNORECASE, TIME, TIME_TZ, TIMESTAMP, TIMESTAMP_TZ, TYPE_COUNT, UNKNOWN, UUID
- Fields inherited from class org.h2.value.VersionedValue
  DUMMY

Method Summary

Methods
Modifier and Type	Method and Description
`int`	`compareTypeSafe(Value v, CompareMode mode, CastDataProvider provider)` Compare this value against another value given that the values are of the same data type.
`Value`	`convertPrecision(long precision)` Convert the precision to the requested value.
`protected Value`	`convertTo(int targetType, ExtTypeInfo extTypeInfo, CastDataProvider provider, boolean forComparison, java.lang.Object column)` Convert a lob to another data type.
`Value`	`copy(DataHandler database, int tableId)` Copy a large value, to be used in the given table.
`ValueLobDb`	`copyToResult()` Create an independent copy of this value, that will be bound to a result.
`ValueLobDb`	`copyToTemp()` Create an independent copy of this temporary value.
`static ValueLobDb`	`create(int type, DataHandler handler, int tableId, long id, byte[] hmac, long precision)` Create a LOB value.
`static ValueLobDb`	`createSmallLob(int type, byte[] small)` Create a LOB object that fits in memory.
`static ValueLobDb`	`createSmallLob(int type, byte[] small, long precision)` Create a LOB object that fits in memory.
`static ValueLobDb`	`createTempBlob(java.io.InputStream in, long length, DataHandler handler)` Create a temporary BLOB value from a stream.
`static ValueLobDb`	`createTempClob(java.io.Reader in, long length, DataHandler handler)` Create a temporary CLOB value from a stream.
`boolean`	`equals(java.lang.Object other)` Check if the two values have the same hash code.
`byte[]`	`getBytes()`
`byte[]`	`getBytesNoCopy()`
`java.io.InputStream`	`getInputStream()`
`java.io.InputStream`	`getInputStream(long oneBasedOffset, long length)` Get the input stream
`long`	`getLobId()`
`int`	`getMemory()` Get the memory used by this object.
`java.lang.Object`	`getObject()` Get the value as an object.
`java.io.Reader`	`getReader()`
`java.io.Reader`	`getReader(long oneBasedOffset, long length)` Get the reader
`byte[]`	`getSmall()` Get the data if this a small lob value.
`java.lang.StringBuilder`	`getSQL(java.lang.StringBuilder builder)` Appends the SQL expression for this value to the specified builder.
`java.lang.String`	`getString()` Get the value as a string.
`int`	`getTableId()` Get the current table id of this lob.
`java.lang.String`	`getTraceSQL()` Get a medium size SQL expression for debugging or tracing.
`TypeInfo`	`getType()` Returns the data type.
`int`	`getValueType()` Get the value type.
`int`	`hashCode()`
`boolean`	`isLinkedToTable()` Check if this value is linked to a specific table.
`boolean`	`isRecoveryReference()`
`boolean`	`isStored()`
`void`	`remove()` Remove the underlying resource, if any.
`void`	`set(java.sql.PreparedStatement prep, int parameterIndex)` Set the value as a parameter in a prepared statement.
`void`	`setRecoveryReference(boolean isRecoveryReference)`
`java.lang.String`	`toString()`

Methods inherited from class org.h2.value.Value
add, checkPrecision, clearCache, compareTo, compareWithNull, containsNull, convertScale, convertTo, convertTo, convertTo, convertToInt, divide, getBigDecimal, getBoolean, getByte, getDataHandler, getDate, getDouble, getFloat, getHigherOrder, getHigherType, getInt, getLong, getResult, getShort, getSignum, getSQL, getTime, getTimestamp, getUnsupportedExceptionForOperation, modulus, multiply, negate, subtract

Methods inherited from class org.h2.value.VersionedValue
getCommittedValue, getCurrentValue, getOperationId, isCommitted

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Method Detail
  - create
```
public static ValueLobDb create(int type,
                DataHandler handler,
                int tableId,
                long id,
                byte[] hmac,
                long precision)
```
    Create a LOB value.
    
    Parameters:
    type - the type (Value.BLOB or CLOB)
    handler - the data handler
    tableId - the table id
    id - the lob id
    hmac - the message authentication code
    precision - the precision (number of bytes / characters)
    
    Returns:
    the value
  - convertTo
```
protected Value convertTo(int targetType,
              ExtTypeInfo extTypeInfo,
              CastDataProvider provider,
              boolean forComparison,
              java.lang.Object column)
```
    Convert a lob to another data type. The data is fully read in memory except when converting to BLOB or CLOB.
    
    Overrides:
    
    convertTo in class Value
    
    Parameters:
    targetType - the new type
    extTypeInfo - the extended data type information, or null
    provider - the cast information provider
    forComparison - if true, perform cast for comparison operation
    column - the column (if any), used for to improve the error message if conversion fails
    
    Returns:
    the converted value
  - isLinkedToTable
```
public boolean isLinkedToTable()
```
    Description copied from class: Value
    
    Check if this value is linked to a specific table. For values that are kept fully in memory, this method returns false.
    
    Overrides:
    
    isLinkedToTable in class Value
    
    Returns:
    true if it is
  - isStored
```
public boolean isStored()
```
  - remove
```
public void remove()
```
    Description copied from class: Value
    
    Remove the underlying resource, if any. For values that are kept fully in memory this method has no effect.
    
    Overrides:
    
    remove in class Value
  - copy
```
public Value copy(DataHandler database,
         int tableId)
```
    Description copied from class: Value
    
    Copy a large value, to be used in the given table. For values that are kept fully in memory this method has no effect.
    
    Overrides:
    
    copy in class Value
    
    Parameters:
    database - the data handler
    tableId - the table where this object is used
    
    Returns:
    the new value or itself
  - getTableId
```
public int getTableId()
```
    Get the current table id of this lob.
    
    Overrides:
    
    getTableId in class Value
    
    Returns:
    the table id
  - getType
```
public TypeInfo getType()
```
    Description copied from class: Value
    
    Returns the data type.
    
    Specified by:
    
    getType in class Value
    
    Returns:
    the data type
  - getValueType
```
public int getValueType()
```
    Description copied from class: Value
    
    Get the value type.
    
    Specified by:
    
    getValueType in class Value
    
    Returns:
    the value type
  - getString
```
public java.lang.String getString()
```
    Description copied from class: Value
    
    Get the value as a string.
    
    Specified by:
    
    getString in class Value
    
    Returns:
    the string
  - getBytes
```
public byte[] getBytes()
```
    Overrides:
    
    getBytes in class Value
  - getBytesNoCopy
```
public byte[] getBytesNoCopy()
```
    Overrides:
    
    getBytesNoCopy in class Value
  - hashCode
```
public int hashCode()
```
    Specified by:
    
    hashCode in class Value
  - compareTypeSafe
```
public int compareTypeSafe(Value v,
                  CompareMode mode,
                  CastDataProvider provider)
```
    Description copied from class: Value
    
    Compare this value against another value given that the values are of the same data type.
    
    Specified by:
    
    compareTypeSafe in class Value
    
    Parameters:
    v - the other value
    mode - the compare mode
    provider - the cast information provider
    
    Returns:
    0 if both values are equal, -1 if the other value is smaller, and 1 otherwise
  - getObject
```
public java.lang.Object getObject()
```
    Description copied from class: Value
    
    Get the value as an object.
    
    Specified by:
    
    getObject in class Value
    
    Returns:
    the object
  - getReader
```
public java.io.Reader getReader()
```
    Overrides:
    
    getReader in class Value
  - getReader
```
public java.io.Reader getReader(long oneBasedOffset,
                       long length)
```
    Description copied from class: Value
    
    Get the reader
    
    Overrides:
    
    getReader in class Value
    
    Parameters:
    oneBasedOffset - the offset (1 means no offset)
    length - the requested length
    
    Returns:
    the new reader
  - getInputStream
```
public java.io.InputStream getInputStream()
```
    Overrides:
    
    getInputStream in class Value
  - getInputStream
```
public java.io.InputStream getInputStream(long oneBasedOffset,
                                 long length)
```
    Description copied from class: Value
    
    Get the input stream
    
    Overrides:
    
    getInputStream in class Value
    
    Parameters:
    oneBasedOffset - the offset (1 means no offset)
    length - the requested length
    
    Returns:
    the new input stream
  - set
```
public void set(java.sql.PreparedStatement prep,
       int parameterIndex)
         throws java.sql.SQLException
```
    Description copied from class: Value
    
    Set the value as a parameter in a prepared statement.
    
    Specified by:
    
    set in class Value
    
    Parameters:
    prep - the prepared statement
    parameterIndex - the parameter index
    
    Throws:
    
    java.sql.SQLException
  - getSQL
```
public java.lang.StringBuilder getSQL(java.lang.StringBuilder builder)
```
    Description copied from class: Value
    
    Appends the SQL expression for this value to the specified builder.
    
    Specified by:
    
    getSQL in class Value
    
    Parameters:
    builder - string builder
    
    Returns:
    the specified string builder
  - getTraceSQL
```
public java.lang.String getTraceSQL()
```
    Description copied from class: Value
    
    Get a medium size SQL expression for debugging or tracing. If the precision is too large, only a subset of the value is returned.
    
    Overrides:
    
    getTraceSQL in class Value
    
    Returns:
    the SQL expression
  - getSmall
```
public byte[] getSmall()
```
    Get the data if this a small lob value.
    
    Overrides:
    
    getSmall in class Value
    
    Returns:
    the data
  - equals
```
public boolean equals(java.lang.Object other)
```
    Description copied from class: Value
    
    Check if the two values have the same hash code. No data conversion is made; this method returns false if the other object is not of the same class. For some values, compareTo may return 0 even if equals return false. Example: ValueDecimal 0.0 and 0.00.
    
    Specified by:
    
    equals in class Value
    
    Parameters:
    other - the other value
    
    Returns:
    true if they are equal
  - getMemory
```
public int getMemory()
```
    Description copied from class: Value
    
    Get the memory used by this object.
    
    Overrides:
    
    getMemory in class Value
    
    Returns:
    the memory used in bytes
  - copyToTemp
```
public ValueLobDb copyToTemp()
```
    Create an independent copy of this temporary value. The file will not be deleted automatically.
    
    Overrides:
    
    copyToTemp in class Value
    
    Returns:
    the value
  - copyToResult
```
public ValueLobDb copyToResult()
```
    Create an independent copy of this value, that will be bound to a result.
    
    Overrides:
    
    copyToResult in class Value
    
    Returns:
    the value (this for small objects)
  - getLobId
```
public long getLobId()
```
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class Value
  - createTempClob
```
public static ValueLobDb createTempClob(java.io.Reader in,
                        long length,
                        DataHandler handler)
```
    Create a temporary CLOB value from a stream.
    
    Parameters:
    in - the reader
    length - the number of characters to read, or -1 for no limit
    handler - the data handler
    
    Returns:
    the lob value
  - createTempBlob
```
public static ValueLobDb createTempBlob(java.io.InputStream in,
                        long length,
                        DataHandler handler)
```
    Create a temporary BLOB value from a stream.
    
    Parameters:
    in - the input stream
    length - the number of characters to read, or -1 for no limit
    handler - the data handler
    
    Returns:
    the lob value
  - convertPrecision
```
public Value convertPrecision(long precision)
```
    Description copied from class: Value
    
    Convert the precision to the requested value. The precision of the returned value may be somewhat larger than requested, because values with a fixed precision are not truncated.
    
    Overrides:
    
    convertPrecision in class Value
    
    Parameters:
    precision - the new precision
    
    Returns:
    the new value
  - createSmallLob
```
public static ValueLobDb createSmallLob(int type,
                        byte[] small)
```
    Create a LOB object that fits in memory.
    
    Parameters:
    type - the type (Value.BLOB or CLOB)
    small - the byte array
    
    Returns:
    the LOB
  - createSmallLob
```
public static ValueLobDb createSmallLob(int type,
                        byte[] small,
                        long precision)
```
    Create a LOB object that fits in memory.
    
    Parameters:
    type - the type (Value.BLOB or CLOB)
    small - the byte array
    precision - the precision
    
    Returns:
    the LOB
  - setRecoveryReference
```
public void setRecoveryReference(boolean isRecoveryReference)
```
  - isRecoveryReference
```
public boolean isRecoveryReference()
```

Class ValueLobDb

Field Summary

Fields inherited from class org.h2.value.Value

Fields inherited from class org.h2.value.VersionedValue

Method Summary

Methods inherited from class org.h2.value.Value

Methods inherited from class org.h2.value.VersionedValue

Methods inherited from class java.lang.Object

Method Detail

create

convertTo

isLinkedToTable

isStored

remove

copy

getTableId

getType

getValueType

getString

getBytes

getBytesNoCopy

hashCode

compareTypeSafe

getObject

getReader

getReader

getInputStream

getInputStream

set

getSQL

getTraceSQL

getSmall

equals

getMemory

copyToTemp

copyToResult

getLobId

toString

createTempClob

createTempBlob

convertPrecision

createSmallLob

createSmallLob

setRecoveryReference

isRecoveryReference