001    package org.apache.ojb.otm.transaction;
002    
003    /* Copyright 2003-2005 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    import org.apache.ojb.broker.PBKey;
019    import org.apache.ojb.otm.OTMConnection;
020    import org.apache.ojb.otm.core.Transaction;
021    
022    
023    /**
024     *
025     * Factory to fetch current transaction. The various implementations will handle
026     * the different implementation sceanrios, like managed and unmanaged platforms. 
027     * 
028     * @author <a href="mailto:rraghuram@hotmail.com">Raghu Rajah</a>
029     * 
030     */
031    public interface TransactionFactory
032    {
033        
034        /**
035         * 
036         *  Get the current Transaction.
037         * 
038         *  @return     the current Transaction
039         * 
040         */
041        public Transaction getTransactionForConnection (OTMConnection connection);
042        
043        /**
044         * 
045         *  Acquire new connection. Creates a new connection. Depending on the implementation of the
046         *  factory the connection could be associated to an existing transaction, or not.
047         * 
048         *  @return     new connection
049         * 
050         */
051        public OTMConnection acquireConnection (PBKey pbKey);
052    }