borland Packages borland Class Hierarchy
Package borland.datastore
About borland.datastore
The datastore package collects the functionality for persistent row storage and caching for
JBuilder DataSet objects, Java Objects, and arbitrary files. The file storage is a single
file (within a hierarchical directory structure) that supports all JDBC data types including Java
Object. It features a small footprint and a portable implementation.
This package provides an alternative form of data storage. By default, once data is loaded into a JBuilder component the storage mechanism is in-memory storage (through the use of the MemoryStore). This
is still the default row storage, however, the classes in this package allow for alternate storage
systems such as the DataStore, by setting the StorageDataSet object's
store property.
Whether the data's storage is MemoryStore or DataStore does not affect how you
work with a DataSet or other data-aware controls connected to the DataSet.
Persistence, however, does require use of Java serialization
(java.io.Serializable).
If this is not possible, you cannot use datastore components and should use the default
storage mechanism of in-memory.
The functionality provided by this package is suited to:
- Developers of embedded applications who require a lightweight single-user database.
- Remote applications where data is downloaded, accessed and updated, then resolved back
to the data source.
The developer who creates an application that handles persistent data is interested
in the following classes in this package:
- DataStore
- DataStoreException
- FileOutStream
- FileStream
- StreamProperties
- StreamVerifier
The remaining classes and interfaces in this package are used internally by classes in
this and other packages in the JBCL. Such classes are not intended for general use and are
therefore not documented. Do not use such classes directly in your application.
See also:
Interfaces
Classes and components
Overview of classes in the datastore package
- DataStore - The basic access point to the persistent data storage functionaltiy in JBuilder.
- DataStoreException - Extends
the DataSetException class with error and other notification messages that are specific to persistent data storage.
- FileOutStream - Provides read, write, and seek access for (output) file streams stored in a DataStore.
- FileStream - Provides read, write, and seek access for (input) file streams stored in a DataStore.
- StreamProperties - Collects properties for a DataStore stream.
- StreamVerifier - Used to verify the integrity of a file stream.