Class Hierarchy    Previous  Next  Index

Class COM.cloudscape.core.XaDataSource

java.lang.Object
    |
    +----COM.cloudscape.core.AbstractDataSource
            |
            +----COM.cloudscape.core.XaDataSource

public class XaDataSource
extends AbstractDataSource
implements javax.sql.XADataSource, javax.naming.Referenceable, java.io.Serializable
Copyright © 1998-2000, Informix Software, Inc. All rights reserved.

An XaDataSource is an implementation of the javax.sql.XADataSource interface. An XaDataSource object can be obtained via a DataSourceFactory.

An XADataSource is a factory for XAConnection objects. It represents a RM in a DTP environment. An object that implements the XADataSource interface is typically registered with a JNDI service provider.

XaDataSource object only works on a local database. There is no client/server support. An XaDataSource object must live in the same jvm as the database.

XaDataSource is serializable and referenceable.

See AbstractDataSource for DataSource properties.

See Also:
DataSourceFactory

Constructor Index

 o XaDataSource()
no-arg constructor

Method Index

 o getXAConnection()

Attempt to establish a database connection.

 o getXAConnection(String, String)

Attempt to establish a database connection.

Constructor Detail

 o XaDataSource
public XaDataSource()
          no-arg constructor

Method Detail

 o getXAConnection
public javax.sql.XAConnection getXAConnection() throws java.sql.SQLException
          

Attempt to establish a database connection.

Returns:
a Connection to the database
Throws:
java.sql.SQLException - if a database-access error occurs.
 o getXAConnection
public javax.sql.XAConnection getXAConnection(java.lang.String user,
                                    java.lang.String password) throws java.sql.SQLException
          

Attempt to establish a database connection.

Parameters:
user - the database user on whose behalf the Connection is being made
password - the user's password
Returns:
a Connection to the database
Throws:
java.sql.SQLException - if a database-access error occurs.

  Class Hierarchy    Previous  Next  Index