com.mockrunner.mock.ejb.EJBMockObjectFactory Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of mockrunner-ejb Show documentation
Mock classes for enterprise java beans
There is a newer version: 2.0.7
package com.mockrunner.mock.ejb;

import javax.naming.Context;
import javax.naming.NameNotFoundException;
import javax.naming.NamingException;
import javax.transaction.UserTransaction;

import org.mockejb.MockContainer;

import com.mockrunner.ejb.Configuration;
import com.mockrunner.ejb.JNDIUtil;

/**
 * Used to create all types of EJB mock objects. 
 * Maintains the necessary dependencies between the mock objects.
 * If you use the mock objects returned by this factory in your tests 
 * you can be sure that they are all up to date.
 * This factory takes the UserTransaction from the JNDI context. 
 * If there's no transaction bound to the  context, the factory will create a
 * {@link com.mockrunner.mock.ejb.MockUserTransaction} and bind it to the context.
 * If the bound transaction is no
 * {@link com.mockrunner.mock.ejb.MockUserTransaction},
 * the method {@link #getMockUserTransaction} returns null.
 * Use {@link #getUserTransaction} instead in this case.
 * You can configure the JNDI name of the UserTransaction and
 * the JNDI Context with the class 
 * {@link com.mockrunner.ejb.Configuration}.
 */
public class EJBMockObjectFactory
{
    private Configuration configuration;
    private UserTransaction transaction;
    private MockContainer container;
    private Context context;
    
    /**
     * Creates a new set of mock objects.
     */
    public EJBMockObjectFactory()
    { 
        this(new Configuration());
    }
    
    /**
     * Creates a new set of mock objects based on the specified configuration.
     */
    public EJBMockObjectFactory(Configuration configuration)
    { 
        this.configuration = configuration;
        initializeContext();
        initializeEJBContainer();
        initializeUserTransaction();
    }

    private void initializeContext()
    {
        context = JNDIUtil.getContext(configuration);
    }
    
    private void initializeUserTransaction()
    {
        try
        {
            try
            {
                transaction = (UserTransaction)context.lookup(configuration.getUserTransactionJNDIName());
            }
            catch(NameNotFoundException nameExc)
            {
                transaction = createMockUserTransaction();
                JNDIUtil.bindUserTransaction(configuration, context, transaction);
            }
        }
        catch(Exception exc)
        {
            transaction = createMockUserTransaction();
        }
        if(transaction instanceof MockUserTransaction)
        {
            ((MockUserTransaction)transaction).reset();
        }
    }
    
    private void initializeEJBContainer()
    {
        container = new MockContainer(context); 
    }

    /**
     * Creates the {@link com.mockrunner.mock.ejb.MockUserTransaction} using new.
     * This method can be overridden to return a subclass of {@link com.mockrunner.mock.ejb.MockUserTransaction}.
     * @return the {@link com.mockrunner.mock.ejb.MockUserTransaction}
     */
    public MockUserTransaction createMockUserTransaction()
    {
        return new MockUserTransaction();
    }
    
    /**
     * Calls MockContextFactory.setAsInitial(), if 
     * MockContextFactory is not already the current
     * context factory.
     */
    public void initMockContextFactory() throws NamingException
    {
        JNDIUtil.initMockContextFactory();
    }
    
    /**
     * Calls MockContextFactory.revertSetAsInitial(), if 
     * MockContextFactory is the current context factory.
     */
    public void resetMockContextFactory()
    {
        JNDIUtil.resetMockContextFactory();
    }
    
    /**
     * Returns the {@link com.mockrunner.mock.ejb.MockUserTransaction}.
     * If the bound transaction is no {@link com.mockrunner.mock.ejb.MockUserTransaction},
     * this method returns null.
     * @return the {@link com.mockrunner.mock.ejb.MockUserTransaction}
     */
    public MockUserTransaction getMockUserTransaction()
    {
        if(!(transaction instanceof MockUserTransaction)) return null;
        return (MockUserTransaction)transaction;
    }

    /**
     * Returns the UserTransaction.
     * @return the UserTransaction
     */
    public UserTransaction getUserTransaction()
    {
        return transaction;
    }
    
    /**
     * Returns the MockEJB MockContainer.
     * @return the MockContainer
     */
    public MockContainer getMockContainer()
    {
        return container;
    }
    
    /**
     * Returns the JNDI context that is used by this factory. If you do not set
     * a Context using {@link com.mockrunner.ejb.Configuration#setContext}}, 
     * the JNDI implementation of MockEJB is used.
     * @return the JNDI context
     */
    public Context getContext()
    {
        return context;
    }
}