01: package org.apache.ojb.otm.transaction;
02:
03: /* Copyright 2003-2005 The Apache Software Foundation
04: *
05: * Licensed under the Apache License, Version 2.0 (the "License");
06: * you may not use this file except in compliance with the License.
07: * You may obtain a copy of the License at
08: *
09: * 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: import org.apache.ojb.broker.PBKey;
19: import org.apache.ojb.otm.OTMConnection;
20: import org.apache.ojb.otm.core.Transaction;
21:
22: /**
23: *
24: * Factory to fetch current transaction. The various implementations will handle
25: * the different implementation sceanrios, like managed and unmanaged platforms.
26: *
27: * @author <a href="mailto:rraghuram@hotmail.com">Raghu Rajah</a>
28: *
29: */
30: public interface TransactionFactory {
31:
32: /**
33: *
34: * Get the current Transaction.
35: *
36: * @return the current Transaction
37: *
38: */
39: public Transaction getTransactionForConnection(
40: OTMConnection connection);
41:
42: /**
43: *
44: * Acquire new connection. Creates a new connection. Depending on the implementation of the
45: * factory the connection could be associated to an existing transaction, or not.
46: *
47: * @return new connection
48: *
49: */
50: public OTMConnection acquireConnection(PBKey pbKey);
51: }
|