JDataStore is a feature of JBuilder Professional and Enterprise, and the Inprise Application Server.
JDataStore is a high-performance, small-footprint, 100% Pure JavaTM multifaceted data storage solution. JDataStore provides:
An object store for storing serialized objects, tables, and other file streams.
Embed SQL-92-compliant database functionality directly into your application without the need for an external database engine. You can access databases through the JDataStore JDBC driver or through the DataExpress components. JDataStore supports most JDBC data types including Java Object.
Serialize all your application's objects and file streams into a single physical file for convenience and portability.
Enable mobile and off-line applications. Using DataExpress JavaBean components, JDataStore asynchronously replicates and caches data from a data source, allows access and updates, and resolves changes back into the data source. The data might come from a database server, a CORBA application server, SAP, BAAN, or some other data source.
Increase the performance of online DataExpress applications with large datasets by using a DataStore
instead of the default MemoryStore
for caching data.
The JDataStore Developer's Guide consists of general guide and tutorial to using JDataStore followed by reference material. It contains these chapters:
"JDataStore as an embedded database" explains how to make a JDataStore transactional and use it as an embedded database with a sample GUI application.
"JDataStore Security describes the user authentication, user authorization, and encryption that JDataStore provides.
"Multi-user and remote access to JDataStores" introduces the JDataStore Server used for remote access. It also discusses multi-user transactional issues.
"Persisting data in a JDataStore" explains how to use the JDataStore as a persistent data cache for off-line computing.
"Using the JDataStore Explorer" describes the JDataStore Explorer.
"Optimizing JDataStore applications" contains a variety of tips on optimizing the performance, reliability, and size of JDataStore applications.
"Troubleshooting" explains how to debug JDataStore applications and fix common problems.
"Specifications" lists the specifications for the JDataStore file format.
"Changes from previous versions" highlights the major changes since the previous version.
"SQL reference" is a reference guide for the SQL-92 dialect supported by the JDataStore JDBC driver.
Before you can use JDataStore, you must enter your development license information. Please note that the JDataStore development license key is separate from any license key you may have for JBuilder.
Reminder: JDataStore comes with one free development license. When you are ready to deploy JDataStore, you will need to purchase additional deployment license(s). Please contact Borland Customer Service for more information.
The first step is to find your JDataStore development license key. The location could vary, depending on how you purchased JDataStore.
If you received JDataStore on a JBuilder CD, it will be in the setup folder on the CD. The file will be named setup_<platform>.html. Select the appropriate file for your platform, and click the "Run JDataStore" link.
If you purchased JDataStore standalone, you will need to register your product to receive your development license key from Borland Customer Service.
After you have located your key(s):
Start the JDataStore Explorer. You can do this in JBuilder by going to Tools | JDataStore Explorer. Another way to start JDataStore Explorer is via a shortcut or command line.
Now select File | License Manager. Click Add. Enter your serial number and key and click OK. Click OK on the JDataStore License Manager. The License manager creates the license file jdatastore.license
which you will need to run JDataStore. This file needs to be in the classpath whenever you are running JDataStore.
The JDataStore Explorer provides visual tools for performing many maintenance tasks. The Developer's Guide explains the fundamentals using the basic JDataStore API. You could begin by going to the JDataStore Explorer chapter first, however.
Throughout the JDataStore Developer's Guide, you'll see the following notation, which indicates some task that can be performed visually with the JDataStore Explorer:
DSX: This notation is accompanied by a reference to that task in the JDataStore Explorer.
Reminder: JDataStore is provided with a license for development only. For deployment, you must purchase additional licenses. Contact Borland Customer Service for more information.
For more information about Borland's developer support services, see our Web site at http://www.borland.com/devsupport, call Borland Assist at (800) 523-7070, or contact our Sales Department at (831) 431-1064.
When contacting support, be prepared to provide complete information about your environment, the version of the product you are using, and a detailed description of the problem.
jpgpubs@inprise.com
Copyright © 2000, Inprise Corporation. All rights reserved.