001    /**
002     *
003     * Copyright 2003-2004 The Apache Software Foundation
004     *
005     *  Licensed under the Apache License, Version 2.0 (the "License");
006     *  you may not use this file except in compliance with the License.
007     *  You may obtain a copy of the License at
008     *
009     *     http://www.apache.org/licenses/LICENSE-2.0
010     *
011     *  Unless required by applicable law or agreed to in writing, software
012     *  distributed under the License is distributed on an "AS IS" BASIS,
013     *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
014     *  See the License for the specific language governing permissions and
015     *  limitations under the License.
016     */
017    
018    //
019    // This source code implements specifications defined by the Java
020    // Community Process. In order to remain compliant with the specification
021    // DO NOT add / change / or delete method signatures!
022    //
023    
024    package javax.resource.spi;
025    
026    import java.io.PrintWriter;
027    import javax.resource.ResourceException;
028    import javax.security.auth.Subject;
029    import javax.transaction.xa.XAResource;
030    
031    /**
032     *
033     *
034     *
035     * @version $Rev: 46019 $ $Date: 2004-09-14 02:56:06 -0700 (Tue, 14 Sep 2004) $
036     */
037    public interface ManagedConnection {
038        public Object getConnection(Subject subject, ConnectionRequestInfo cxRequestInfo) throws ResourceException;
039    
040        public void destroy() throws ResourceException;
041    
042        public void cleanup() throws ResourceException;
043    
044        public void associateConnection(Object connection) throws ResourceException;
045    
046        public void addConnectionEventListener(ConnectionEventListener listener);
047    
048        public void removeConnectionEventListener(ConnectionEventListener listener);
049    
050        public XAResource getXAResource() throws ResourceException;
051    
052        public LocalTransaction getLocalTransaction() throws ResourceException;
053    
054        public ManagedConnectionMetaData getMetaData() throws ResourceException;
055    
056        public void setLogWriter(PrintWriter out) throws ResourceException;
057    
058        public PrintWriter getLogWriter() throws ResourceException;
059    }