com.amazon.carbonado.lob (Carbonado 1.2.3 API)

+ + + + + + + + + + + + + + + + + + + + +

Interface Summary
Interface	Description
Blob	+ Provides access to BLOBs, which are Binary Large OBjects. +
Clob	+ Provides access to CLOBs, which are Character Large OBjects. +
Lob	+ Marker interface for `Blobs` and `Clobs`. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Class Summary
Class	Description
AbstractBlob	+ AbstractBlob implements a small set of common Blob methods. +
AbstractClob	+ AbstractClob implements a small set of common Clob methods. +
BlobClob	+ A Clob implementation which is backed by a Blob. +
ByteArrayBlob	+ Implementation of a Blob which is backed by a growable in-memory byte array. +
CharArrayClob	+ Implementation of a Clob which is backed by a growable in-memory character + array. +
FileBlob	+ Implementation of a Blob which is backed by a File. +
StringClob	+ Implementation of a Clob which is backed by a read-only String. +

+ + + +

Package com.amazon.carbonado.lob Description

Support for LOB property types, which are Large OBjects. Properties declared + as Blob or Clob are treated differently than regular + properties. In particular: + +

Repository typically stores LOB data external from enclosing storable +
LOBs are accessed in a manner similar to how files are accessed +
LOB data is often read/written in chunks, so consider accessing in a transaction scope +
LOBs cannot be annotated with PrimaryKey, Key, Index, Join, + Version, or Sequence +
LOBs cannot be used in a query filter +

+ +

Also, setting a LOB property does not dirty that property unless the new + LOB is unequal. Updating a LOB property typically involves operating on the + LOB itself. Setting the LOB property again is useful only when completely + replacing the data, which can be a relatively expensive operation. + +

Some repositories require that large text data be stored as a LOB. If the + text property is intended to fit entirely in memory, consider defining the + property as a String instead of a LOB. This allows the repository to decide + if it is appropriate to store it as a LOB. If explicit control over charset + encoding is required, add a TextAdapter annotation.