bitronix.tm.jndi.BitronixInitialContextFactory Maven / Gradle / Ivy
/*
* Copyright (C) 2006-2013 Bitronix Software (http://www.bitronix.be)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package bitronix.tm.jndi;
import javax.naming.Context;
import javax.naming.spi.InitialContextFactory;
import java.util.Hashtable;
/**
* Implementation of {@link InitialContextFactory} that allows lookup of transaction manager
* and registered resources.
*
* The easiest way to use this provider is to create a jndi.properties file
* in your classpath with this content:
*
java.naming.factory.initial=bitronix.tm.jndi.BitronixInitialContextFactory
* Alternatively, you can create a {@link javax.naming.InitialContext} object with an environment
* pointing to this class:
*
* Hashtable env = new Hashtable();
* env.put(Context.INITIAL_CONTEXT_FACTORY, "bitronix.tm.jndi.BitronixInitialContextFactory");
* Context ctx = new InitialContext(env);
*
* The transaction manager can be looked up at the standard URL java:comp/UserTransaction
* while resources can be looked up using their unique name as set in
* {@link bitronix.tm.resource.common.ResourceBean#getUniqueName()}.
*
*
* @author Ludovic Orban
* @see bitronix.tm.jndi.BitronixContext
*/
public class BitronixInitialContextFactory
implements InitialContextFactory
{
/**
* Method getInitialContext ...
*
* @param hashtable
* of type Hashtable ?, ?
*
* @return Context
*/
@Override
public Context getInitialContext(Hashtable hashtable)
{
return new BitronixContext();
}
/**
* Method toString ...
*
* @return String
*/
@Override
public String toString()
{
return "a BitronixInitialContextFactory";
}
}