Keywords: XA, Using with the network client driver

# Using XA with the network client driver

You can access XA support for the Network Server by using the network client driver's XA DataSource interface.

The interface `org.apache.derby.jdbc.ClientXADataSource` is available on all supported Java SE platforms. If your client runs on the Java SE 6 platform, and if you want to use XA DataSource methods specific to the JDBC 4 API, use the DataSource named `org.apache.derby.jdbc.ClientXADataSource40`.

If your client is running on the Java SE 6 platform, all connection objects returned from the DataSource will be JDBC 4 connection objects, whether or not you are using the DataSource whose name ends in "40".

The following example illustrates how to obtain an XA connection with the network client driver:

    import org.apache.derby.jdbc.ClientXADataSource;
    import javax.sql.XAConnection;
    ...

    XAConnection xaConnection = null;
    Connection conn = null;

    String driver = "org.apache.derby.jdbc.ClientDataSource";
    ClientXADataSource ds = new ClientXADataSource();

    ds.setDatabaseName ("sample;create=true");

    ds.setServerName("localhost");

    ds.setPortNumber(1527);

    Class.forName(driver);

    xaConnection = ds.getXAConnection("auser", "shhhh");

    conn = xaConnection.getConnection();

Parent topic: XA and the Network Server