diff -r 836adbf7a2cd -r 3317bb8137f4 jdk/src/java.sql/share/classes/javax/sql/XADataSource.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/jdk/src/java.sql/share/classes/javax/sql/XADataSource.java Sun Aug 17 15:54:13 2014 +0100 @@ -0,0 +1,83 @@ +/* + * Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved. + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * This code is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License version 2 only, as + * published by the Free Software Foundation. Oracle designates this + * particular file as subject to the "Classpath" exception as provided + * by Oracle in the LICENSE file that accompanied this code. + * + * This code is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License + * version 2 for more details (a copy is included in the LICENSE file that + * accompanied this code). + * + * You should have received a copy of the GNU General Public License version + * 2 along with this work; if not, write to the Free Software Foundation, + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. + * + * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA + * or visit www.oracle.com if you need additional information or have any + * questions. + */ + +package javax.sql; + +import java.sql.*; + +/** + * A factory for {@code XAConnection} objects that is used internally. + * An object that implements the {@code XADataSource} interface is + * typically registered with a naming service that uses the + * Java Naming and Directory Interface™ + * (JNDI). + *

+ * An implementation of {@code XADataSource} must include a public no-arg + * constructor. + * @since 1.4 + */ + +public interface XADataSource extends CommonDataSource { + + /** + * Attempts to establish a physical database connection that can be + * used in a distributed transaction. + * + * @return an {@code XAConnection} object, which represents a + * physical connection to a data source, that can be used in + * a distributed transaction + * @exception SQLException if a database access error occurs + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * @throws SQLTimeoutException when the driver has determined that the + * timeout value specified by the {@code setLoginTimeout} method + * has been exceeded and has at least tried to cancel the + * current database connection attempt + * @since 1.4 + */ + XAConnection getXAConnection() throws SQLException; + + /** + * Attempts to establish a physical database connection, using the given + * user name and password. The connection that is returned is one that + * can be used in a distributed transaction. + * + * @param user the database user on whose behalf the connection is being made + * @param password the user's password + * @return an {@code XAConnection} object, which represents a + * physical connection to a data source, that can be used in + * a distributed transaction + * @exception SQLException if a database access error occurs + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * @throws SQLTimeoutException when the driver has determined that the + * timeout value specified by the {@code setLoginTimeout} method + * has been exceeded and has at least tried to cancel the + * current database connection attempt + * @since 1.4 + */ + XAConnection getXAConnection(String user, String password) + throws SQLException; + }