J2EE Compliance: Java Transaction API and javax.sql Extensions,
Page 4 of 4


[top]
[prev]
[next]
Documentation Top
Global Index
Reference Manual
TOC Index
Grammar index
Developer's Guide
TOC Index
Tuning Cloudscape
TOC Index

javax.sql: JDBC Extensions

This section documents the JDBC extensions that Cloudscape implements for J2EE compliance.

NEW: Support for these JDBC extensions is new in Version 3.0.

  • javax.sql.DataSource
    Cloudscape’s implementation of DataSource means that it supports JNDI; as a resource manager, it allows a database to be named and registered within a JNDI server. This allows the calling application to access the database by a name (as a data source) instead of through a database connection URL.

NOTE: Support for remote (client/server) data sources is provided through RmiJdbc. (XADataSources are local only.)

  • javax.sql.ConnectionPoolDataSource
    Support of this interface allows a connection pool server to maintain a set of connections to the resource manager (Cloudscape). Such a connection pool is useful in client/server environments because establishing a connection is relatively expensive. In an embedded environment, connections are much cheaper.
  • javax.sql.PooledConnection
    Support of this interface allows a connection pool server to maintain a set of connections to the resource manager (Cloudscape). Such a connection pool is useful in client/server environments because establishing a connection is relatively expensive. In an embedded environment, connections are much cheaper.
  • javax.sql.XAConnection
    An XAConnection produces an XAResource, and, over its lifetime, many Connections. It allows for distributed transactions.
  • javax.sql.XADataSource
    An XADataSource is simply a ConnectionPoolDataSource that produces XAConnections.

In addition, Cloudscape provides three methods for XADataSource, DataSource, and ConnectionPoolDataSource that are not part of the standard API:

  • setCreateDatabase(String create)
    Sets a property to create a database at the next connection. The string argument must be “create”.
  • setShutdownDatabase(String shutdown)
    Sets a property to shut down a database. Shuts down the database at the next connection. The string argument must be “shutdown”.
  • setRemoteDataSourceProtocol(String rmi)
    Sets a property to enable the correct protocol for working with data sources in a client/server environment using RmiJdbc. The string must be “rmi”. Not valid for XADataSources.

NOTE: Set these properties before getting the connection.

[top]
[prev]
[next]


Cloudscape Version 3.0
For technical support, go to: www.cloudscape.com and click Support.
Copyright © 1998 and 1999 Cloudscape, Inc. All rights reserved.