01: /*
02: * Copyright (c) 1998-2008 Caucho Technology -- all rights reserved
03: *
04: * This file is part of Resin(R) Open Source
05: *
06: * Each copy or derived work must preserve the copyright notice and this
07: * notice unmodified.
08: *
09: * Resin Open Source is free software; you can redistribute it and/or modify
10: * it under the terms of the GNU General Public License as published by
11: * the Free Software Foundation; either version 2 of the License, or
12: * (at your option) any later version.
13: *
14: * Resin Open Source is distributed in the hope that it will be useful,
15: * but WITHOUT ANY WARRANTY; without even the implied warranty of
16: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE, or any warranty
17: * of NON-INFRINGEMENT. See the GNU General Public License for more
18: * details.
19: *
20: * You should have received a copy of the GNU General Public License
21: * along with Resin Open Source; if not, write to the
22: *
23: * Free Software Foundation, Inc.
24: * 59 Temple Place, Suite 330
25: * Boston, MA 02111-1307 USA
26: *
27: * @author Scott Ferguson
28: */
29:
30: package javax.resource.spi;
31:
32: import javax.resource.ResourceException;
33: import javax.security.auth.Subject;
34: import java.io.PrintWriter;
35: import java.util.Set;
36:
37: /**
38: * Interface for the resource adapter's connection factory.
39: */
40: public interface ManagedConnectionFactory extends java.io.Serializable {
41: /**
42: * Creates a Connection Factory instance. The ConnectionFactory
43: * instance is initialized with the ConnectionManager.
44: */
45: public Object createConnectionFactory(ConnectionManager manager)
46: throws ResourceException;
47:
48: /**
49: * Creates a Connection Factory instance, using a default
50: * ConnectionManager from the resource adapter.
51: * instance is initialized with the ConnectionManager.
52: */
53: public Object createConnectionFactory() throws ResourceException;
54:
55: /**
56: * Creates physical connection to the EIS resource manager.
57: */
58: public ManagedConnection createManagedConnection(Subject subject,
59: ConnectionRequestInfo info) throws ResourceException;
60:
61: /**
62: * Returns a matched connection.
63: */
64: public ManagedConnection matchManagedConnections(Set connectionSet,
65: Subject subject, ConnectionRequestInfo info)
66: throws ResourceException;
67:
68: /**
69: * Sets the log writer for the ManagedConnectionFactory.
70: */
71: public void setLogWriter(PrintWriter out) throws ResourceException;
72:
73: /**
74: * Gets the log writer for the ManagedConnectionFactory.
75: */
76: public PrintWriter getLogWriter() throws ResourceException;
77: }
|