Package com.amazon.carbonado.lob

Support for LOB property types, which are Large OBjects.

See: Description

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.