// This Source Code is in the Public Domain per: http://litesoft.org/License.txt
package org.litesoft.orsup.transact;

import java.util.*;

import org.litesoft.orsup.nonpublic.*;

public interface SucceededTransactionCommitListener
{
    public static final SucceededTransactionCommitListener[] EMPTY_ARRAY = new SucceededTransactionCommitListener[0];

    /**
     * Look at the pCommitParticipants and if you are interested in any create a
     * TransactionSuccessfulCommitCallBack return value with any data that you need to update your state.
     * <p/>
     * If the transaction is successfully commited, then the commitSucceeded() method on your
     * TransactionSuccessfulCommitCallBack will be called.
     *
     * @return !null means you want to be notified that the Transaction Commit Succeeded!
     */
    void successfulCommitBeforeClear( String pTransactionsSourceId, Set<TransCommitEntry> pEntries, TransParticipantsManager pTransParticipantsManager );
}