Class CDOClob

An identifiable character large object with streaming support.

CDOClobs are immutable. Once created, their ID and size do not change. The ID is a digest of the content of the clob, SHA-1 by default (see CDOLobStoreImpl.DEFAULT_DIGEST_ALGORITHM).

CDOClobs can be created from a Reader, or a String. On the client side, CDOClobs are created with a reference to a CDOLobStore, which is used to store and retrieve the clob's content. On the server side, CDOClobs are created without a store reference and are always retrieved from the repository's IStore.

The default CDOLobStore implementation is CDOLobStoreImpl.INSTANCE, which stores clobs in the local file system. But on the client side, it's often more efficient to use a dedicated CDOLobStore instance that stores clobs in a CDOSession-specific cache location. See CDOSession.Options.setLobCache(CDOLobStore) for details. See also CDOSession.newClob(Reader) and CDOSession.newClob(String) for convenient ways to create CDOClobs.