1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22 package javax.jdo.datastore;
23
24 import javax.jdo.PersistenceManager;
25
26 /***
27 * The underlying connection that is being used by a
28 * {@link PersistenceManager}.
29 * @version 2.0
30 * @since 2.0
31 */
32 public interface JDOConnection {
33
34 /***
35 * Returns the native, datastore-specific connection that this
36 * connection wraps. In general, it is not recommended that this
37 * native connection be used directly, since the JDO
38 * implementation has no way to intercept calls to it, so it is
39 * quite possible to put the <code>PersistenceManager</code>'s
40 * connection into an invalid state.
41 * @return the native connection
42 * @since 2.0
43 */
44 Object getNativeConnection ();
45
46 /***
47 * Returns this connection to the JDO implementation.
48 * The object must be returned to the JDO implementation prior to
49 * calling any JDO method or performing any action on any persistent
50 * instance that might require the JDO implementation to use a
51 * connection. If the object has not been returned and the JDO
52 * implementation needs a connection, a <code>JDOUserException</code>
53 * is thrown.
54 * @since 2.0
55 */
56 void close();
57 }