01: /*
02: * Copyright (c) 1998-2003 Caucho Technology -- all rights reserved
03: *
04: * This file is part of Resin(R) Open Source
05: *
06: * Each copy or derived work must preserve the copyright notice and this
07: * notice unmodified.
08: *
09: * Resin Open Source is free software; you can redistribute it and/or modify
10: * it under the terms of the GNU General Public License as published by
11: * the Free Software Foundation; either version 2 of the License, or
12: * (at your option) any later version.
13: *
14: * Resin Open Source is distributed in the hope that it will be useful,
15: * but WITHOUT ANY WARRANTY; without even the implied warranty of
16: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE, or any warranty
17: * of NON-INFRINGEMENT. See the GNU General Public License for more
18: * details.
19: *
20: * You should have received a copy of the GNU General Public License
21: * along with Resin Open Source; if not, write to the
22: * Free SoftwareFoundation, Inc.
23: * 59 Temple Place, Suite 330
24: * Boston, MA 02111-1307 USA
25: *
26: * @author Scott Ferguson
27: */
28:
29: package javax.resource.cci;
30:
31: import javax.resource.ResourceException;
32:
33: /**
34: * Represents an application handle for the client. The physical
35: * connection is implemented by a ManagedConnection.
36: */
37: public interface Connection {
38: /**
39: * Creates an Interaction for the Connection. The Interaction is
40: * like the JDBC Statement and actually does the work.
41: */
42: public Interaction createInteraction() throws ResourceException;
43:
44: /**
45: * Returns a LocalTransaction instance to allow the resource manager
46: * to manage local transactions.
47: */
48: public LocalTransaction getLocalTransaction()
49: throws ResourceException;
50:
51: /**
52: * Returns information on the underlying resource represented by
53: * the connection.
54: */
55: public ConnectionMetaData getMetaData() throws ResourceException;
56:
57: /**
58: * Returns metadata on the ResultSet capabitilities supported by the
59: * connection.
60: */
61: public ResultSetInfo getResultSetInfo() throws ResourceException;
62:
63: /**
64: * Closes the connection at the application level.
65: */
66: public void close() throws ResourceException;
67: }
|