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.

You can use the org.apache.derby.jdbc.ClientXADataSource class on all supported Java SE versions except Java SE 8 Compact Profile 2. On Java SE 8 Compact Profile 2, you must use the org.apache.derby.jdbc.BasicClientXADataSource40 class. For more information, see "JDBC support for Java SE 8 Compact Profiles" in the Derby Reference Manual.

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;

ClientXADataSource ds = new ClientXADataSource();

ds.setDatabaseName ("sample");
ds.setCreateDatabase("create");

ds.setServerName("localhost");
ds.setPortNumber(1527);

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

conn = xaConnection.getConnection();