1 /* 2 * JBoss, Home of Professional Open Source 3 * Copyright 2005, JBoss Inc., and individual contributors as indicated 4 * by the @authors tag. See the copyright.txt in the distribution for a 5 * full listing of individual contributors. 6 * 7 * This is free software; you can redistribute it and/or modify it 8 * under the terms of the GNU Lesser General Public License as 9 * published by the Free Software Foundation; either version 2.1 of 10 * the License, or (at your option) any later version. 11 * 12 * This software is distributed in the hope that it will be useful, 13 * but WITHOUT ANY WARRANTY; without even the implied warranty of 14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 15 * Lesser General Public License for more details. 16 * 17 * You should have received a copy of the GNU Lesser General Public 18 * License along with this software; if not, write to the Free 19 * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 20 * 02110-1301 USA, or see the FSF site: http://www.fsf.org. 21 */ 22 package org.jboss.tm; 23 24 import javax.transaction.Transaction; 25 26 27 /** 28 * Implementations of this interface are used for getting 29 * a transaction propagation context at the client-side. 30 * We need a specific implementation of this interface for 31 * each kind of DTM we are going to interoperate with. (So 32 * we may have 20 new classes if we are going to interoperate 33 * with 20 different kinds of distributed transaction 34 * managers.) 35 * The reason for having the methods in this interface return 36 * Object is that we do not really know what kind of transaction 37 * propagation context is returned. 38 * 39 * @see TransactionPropagationContextImporter 40 * @author <a HREF="mailto:osh@sparre.dk">Ole Husgaard</a> 41 * @version $Revision: 37459 $ 42 */ 43 public interface TransactionPropagationContextFactory 44 { 45 /** 46 * Return a transaction propagation context for the transaction 47 * currently associated with the invoking thread, or <code>null</code> 48 * if the invoking thread is not associated with a transaction. 49 */ 50 public Object getTransactionPropagationContext(); 51 52 /** 53 * Return a transaction propagation context for the transaction 54 * given as an argument, or <code>null</code> 55 * if the argument is <code>null</code> or of a type unknown to 56 * this factory. 57 */ 58 public Object getTransactionPropagationContext(Transaction tx); 59 60 } 61 62