View Javadoc

1   /**
2    *
3    * Copyright 2003-2004 The Apache Software Foundation
4    *
5    *  Licensed under the Apache License, Version 2.0 (the "License");
6    *  you may not use this file except in compliance with the License.
7    *  You may obtain a copy of the License at
8    *
9    *     http://www.apache.org/licenses/LICENSE-2.0
10   *
11   *  Unless required by applicable law or agreed to in writing, software
12   *  distributed under the License is distributed on an "AS IS" BASIS,
13   *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14   *  See the License for the specific language governing permissions and
15   *  limitations under the License.
16   */
17  
18  //
19  // This source code implements specifications defined by the Java
20  // Community Process. In order to remain compliant with the specification
21  // DO NOT add / change / or delete method signatures!
22  //
23  
24  package javax.resource.spi;
25  
26  import java.io.PrintWriter;
27  import javax.resource.ResourceException;
28  import javax.security.auth.Subject;
29  import javax.transaction.xa.XAResource;
30  
31  /**
32   *
33   *
34   *
35   * @version $Rev: 46019 $ $Date: 2004-09-14 02:56:06 -0700 (Tue, 14 Sep 2004) $
36   */
37  public interface ManagedConnection {
38      public Object getConnection(Subject subject, ConnectionRequestInfo cxRequestInfo) throws ResourceException;
39  
40      public void destroy() throws ResourceException;
41  
42      public void cleanup() throws ResourceException;
43  
44      public void associateConnection(Object connection) throws ResourceException;
45  
46      public void addConnectionEventListener(ConnectionEventListener listener);
47  
48      public void removeConnectionEventListener(ConnectionEventListener listener);
49  
50      public XAResource getXAResource() throws ResourceException;
51  
52      public LocalTransaction getLocalTransaction() throws ResourceException;
53  
54      public ManagedConnectionMetaData getMetaData() throws ResourceException;
55  
56      public void setLogWriter(PrintWriter out) throws ResourceException;
57  
58      public PrintWriter getLogWriter() throws ResourceException;
59  }