All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.springframework.jndi.JndiLocatorSupport Maven / Gradle / Ivy

The newest version!
/*
 * Copyright 2002-2010 the original author or authors.
 *
 * 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 org.springframework.jndi;

import javax.naming.NamingException;

import org.springframework.util.Assert;

/**
 * Convenient superclass for classes that can locate any number of JNDI objects.
 * Derives from JndiAccessor to inherit the "jndiTemplate" and "jndiEnvironment"
 * bean properties.
 *
 * 

JNDI names may or may not include the "java:comp/env/" prefix expected * by J2EE applications when accessing a locally mapped (ENC - Environmental * Naming Context) resource. If it doesn't, the "java:comp/env/" prefix will * be prepended if the "resourceRef" property is true (the default is * false) and no other scheme (e.g. "java:") is given. * * @author Juergen Hoeller * @since 1.1 * @see #setJndiTemplate * @see #setJndiEnvironment * @see #setResourceRef */ public abstract class JndiLocatorSupport extends JndiAccessor { /** JNDI prefix used in a J2EE container */ public static final String CONTAINER_PREFIX = "java:comp/env/"; private boolean resourceRef = false; /** * Set whether the lookup occurs in a J2EE container, i.e. if the prefix * "java:comp/env/" needs to be added if the JNDI name doesn't already * contain it. Default is "false". *

Note: Will only get applied if no other scheme (e.g. "java:") is given. */ public void setResourceRef(boolean resourceRef) { this.resourceRef = resourceRef; } /** * Return whether the lookup occurs in a J2EE container. */ public boolean isResourceRef() { return this.resourceRef; } /** * Perform an actual JNDI lookup for the given name via the JndiTemplate. *

If the name doesn't begin with "java:comp/env/", this prefix is added * if "resourceRef" is set to "true". * @param jndiName the JNDI name to look up * @return the obtained object * @throws NamingException if the JNDI lookup failed * @see #setResourceRef */ protected Object lookup(String jndiName) throws NamingException { return lookup(jndiName, null); } /** * Perform an actual JNDI lookup for the given name via the JndiTemplate. *

If the name doesn't begin with "java:comp/env/", this prefix is added * if "resourceRef" is set to "true". * @param jndiName the JNDI name to look up * @param requiredType the required type of the object * @return the obtained object * @throws NamingException if the JNDI lookup failed * @see #setResourceRef */ protected T lookup(String jndiName, Class requiredType) throws NamingException { Assert.notNull(jndiName, "'jndiName' must not be null"); String convertedName = convertJndiName(jndiName); T jndiObject; try { jndiObject = getJndiTemplate().lookup(convertedName, requiredType); } catch (NamingException ex) { if (!convertedName.equals(jndiName)) { // Try fallback to originally specified name... if (logger.isDebugEnabled()) { logger.debug("Converted JNDI name [" + convertedName + "] not found - trying original name [" + jndiName + "]. " + ex); } jndiObject = getJndiTemplate().lookup(jndiName, requiredType); } else { throw ex; } } if (logger.isDebugEnabled()) { logger.debug("Located object with JNDI name [" + convertedName + "]"); } return jndiObject; } /** * Convert the given JNDI name into the actual JNDI name to use. *

The default implementation applies the "java:comp/env/" prefix if * "resourceRef" is "true" and no other scheme (e.g. "java:") is given. * @param jndiName the original JNDI name * @return the JNDI name to use * @see #CONTAINER_PREFIX * @see #setResourceRef */ protected String convertJndiName(String jndiName) { // Prepend container prefix if not already specified and no other scheme given. if (isResourceRef() && !jndiName.startsWith(CONTAINER_PREFIX) && jndiName.indexOf(':') == -1) { jndiName = CONTAINER_PREFIX + jndiName; } return jndiName; } }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy