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