KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > openejb > spi > OpenEJBConnectionManager


1 /**
2  * Redistribution and use of this software and associated documentation
3  * ("Software"), with or without modification, are permitted provided
4  * that the following conditions are met:
5  *
6  * 1. Redistributions of source code must retain copyright
7  * statements and notices. Redistributions must also contain a
8  * copy of this document.
9  *
10  * 2. Redistributions in binary form must reproduce the
11  * above copyright notice, this list of conditions and the
12  * following disclaimer in the documentation and/or other
13  * materials provided with the distribution.
14  *
15  * 3. The name "Exolab" must not be used to endorse or promote
16  * products derived from this Software without prior written
17  * permission of Exoffice Technologies. For written permission,
18  * please contact info@exolab.org.
19  *
20  * 4. Products derived from this Software may not be called "Exolab"
21  * nor may "Exolab" appear in their names without prior written
22  * permission of Exoffice Technologies. Exolab is a registered
23  * trademark of Exoffice Technologies.
24  *
25  * 5. Due credit should be given to the Exolab Project
26  * (http://www.exolab.org/).
27  *
28  * THIS SOFTWARE IS PROVIDED BY EXOFFICE TECHNOLOGIES AND CONTRIBUTORS
29  * ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT
30  * NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
31  * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
32  * EXOFFICE TECHNOLOGIES OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
33  * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
34  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
35  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
36  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
37  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
38  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
39  * OF THE POSSIBILITY OF SUCH DAMAGE.
40  *
41  * Copyright 1999 (C) Exoffice Technologies Inc. All Rights Reserved.
42  *
43  * $Id: OpenEJBConnectionManager.java 1096 2004-03-26 21:41:16Z dblevins $
44  */

45 package org.openejb.spi;
46
47 import javax.resource.ResourceException JavaDoc;
48 import javax.resource.spi.ConnectionManager JavaDoc;
49
50 /**
51  * OpenEJB extensions to J2EE Connector ConnectionManager. This allows the
52  * container to act on connections that a bean is using across multiple
53  * transactions. It can add connections to the current transaction, or
54  * indicate that connections can be closed (because the bean instance was
55  * released).
56  *
57  * @author Aaron Mulder (ammulder@alumni.princeton.edu)
58  * @version $Revision: 1096 $
59  */

60 public interface OpenEJBConnectionManager extends ConnectionManager JavaDoc {
61     /**
62      * Add the specified connections to the current transaction.
63      */

64     public void associateConnections(Object JavaDoc[] connections) throws ResourceException JavaDoc;
65
66     /**
67      * Close the specified connections. This method can only mark the
68      * specified connection handles as closed, and return the ManagedConnection
69      * to the pool if appropriate. It cannot actually close the connection
70      * handle, because the ConnectionManager does not know what the connection
71      * implementation is, and how to close it properly.
72      */

73     public void disposeConnections(Object JavaDoc[] connections) throws ResourceException JavaDoc;
74 }
Popular Tags