1 package org.apache.ojb.otm; 2 3 /* Copyright 2003-2005 The Apache Software Foundation 4 * 5 * Licensed under the Apache License, Version 2.0 (the "License"); 6 * you may not use this file except in compliance with the License. 7 * You may obtain a copy of the License at 8 * 9 * 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.Identity; 19 import org.apache.ojb.broker.PBKey; 20 import org.apache.ojb.otm.copy.ObjectCopyStrategy; 21 import org.apache.ojb.otm.core.Transaction; 22 import org.apache.ojb.otm.lock.map.LockMap; 23 import org.apache.ojb.otm.lock.wait.LockWaitStrategy; 24 import org.apache.ojb.otm.swizzle.Swizzling; 25 26 /** 27 * The Kit provides the point of entry for any OTM client 28 * 29 * @author <a HREF="mailto:mattbaird@yahoo.com">Matthew Baird</a> 30 */ 31 public interface Kit 32 { 33 /** 34 * Acquire an open OTMConnection 35 * 36 * @param pbKey 37 * @return 38 */ 39 OTMConnection acquireConnection(PBKey pbKey); 40 41 /** 42 * Obtain the transaction this connection is bound to 43 */ 44 Transaction getTransaction(OTMConnection conn); 45 46 /** 47 * @todo document 48 */ 49 Swizzling getSwizzlingStrategy(); 50 51 /** 52 * @todo document 53 */ 54 LockWaitStrategy getLockWaitStrategy(); 55 56 /** 57 * @todo document 58 */ 59 LockMap getLockMap(); 60 61 /** 62 * @todo document 63 */ 64 ObjectCopyStrategy getCopyStrategy(Identity oid); 65 66 /** 67 * @todo document 68 */ 69 boolean isImplicitLockingUsed(); 70 71 } 72