View Javadoc

1   /*
2    * $Id: ExternalTransactionAwareTransactionFactory.java 19191 2010-08-25 21:05:23Z tcarlson $
3    * --------------------------------------------------------------------------------------
4    * Copyright (c) MuleSoft, Inc.  All rights reserved.  http://www.mulesoft.com
5    *
6    * The software in this package is published under the terms of the CPAL v1.0
7    * license, a copy of which has been included with this distribution in the
8    * LICENSE.txt file.
9    */
10  
11  package org.mule.api.transaction;
12  
13  import org.mule.api.MuleContext;
14  
15  
16  /**
17   * <code>ExternalTransactionAwareTransactionFactory</code> creates a transaction, possibly representing a transaction
18   * started outside Mule.
19   *
20   */
21  public interface ExternalTransactionAwareTransactionFactory extends TransactionFactory
22  {
23      /**
24       * Create and begins a new transaction
25       *
26       * @return a new Transaction representing an existing external transaction
27       * @throws org.mule.api.transaction.TransactionException if the transaction cannot be created or begun
28       * @param muleContext
29       */
30      Transaction joinExternalTransaction(MuleContext muleContext) throws TransactionException;
31  }