org.springframework.jndi
Class JndiLocatorSupport

java.lang.Object
  extended by org.springframework.jndi.JndiAccessor
      extended by org.springframework.jndi.JndiLocatorSupport
Direct Known Subclasses:
ContextJndiBeanFactoryLocator, JndiDataSourceLookup, JndiDestinationResolver, JndiObjectLocator, PersistenceAnnotationBeanPostProcessor, SimpleJndiBeanFactory, TimerManagerFactoryBean, WorkManagerTaskExecutor, WorkManagerTaskExecutor

public abstract class JndiLocatorSupport
extends JndiAccessor

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.

Since:
1.1
Author:
Juergen Hoeller
See Also:
JndiAccessor.setJndiTemplate(org.springframework.jndi.JndiTemplate), JndiAccessor.setJndiEnvironment(java.util.Properties), setResourceRef(boolean)

Field Summary
static java.lang.String CONTAINER_PREFIX
          JNDI prefix used in a J2EE container
 
Fields inherited from class org.springframework.jndi.JndiAccessor
logger
 
Constructor Summary
JndiLocatorSupport()
           
 
Method Summary
protected  java.lang.String convertJndiName(java.lang.String jndiName)
          Convert the given JNDI name into the actual JNDI name to use.
 boolean isResourceRef()
          Return whether the lookup occurs in a J2EE container.
protected  java.lang.Object lookup(java.lang.String jndiName)
          Perform an actual JNDI lookup for the given name via the JndiTemplate.
protected
<T> T
lookup(java.lang.String jndiName, java.lang.Class<T> requiredType)
          Perform an actual JNDI lookup for the given name via the JndiTemplate.
 void setResourceRef(boolean resourceRef)
          Set whether the lookup occurs in a J2EE container, i.e.
 
Methods inherited from class org.springframework.jndi.JndiAccessor
getJndiEnvironment, getJndiTemplate, setJndiEnvironment, setJndiTemplate
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

CONTAINER_PREFIX

public static final java.lang.String CONTAINER_PREFIX
JNDI prefix used in a J2EE container

See Also:
Constant Field Values
Constructor Detail

JndiLocatorSupport

public JndiLocatorSupport()
Method Detail

setResourceRef

public void setResourceRef(boolean resourceRef)
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.


isResourceRef

public boolean isResourceRef()
Return whether the lookup occurs in a J2EE container.


lookup

protected java.lang.Object lookup(java.lang.String jndiName)
                           throws javax.naming.NamingException
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".

Parameters:
jndiName - the JNDI name to look up
Returns:
the obtained object
Throws:
javax.naming.NamingException - if the JNDI lookup failed
See Also:
setResourceRef(boolean)

lookup

protected <T> T lookup(java.lang.String jndiName,
                       java.lang.Class<T> requiredType)
            throws javax.naming.NamingException
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".

Parameters:
jndiName - the JNDI name to look up
requiredType - the required type of the object
Returns:
the obtained object
Throws:
javax.naming.NamingException - if the JNDI lookup failed
See Also:
setResourceRef(boolean)

convertJndiName

protected java.lang.String convertJndiName(java.lang.String jndiName)
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.

Parameters:
jndiName - the original JNDI name
Returns:
the JNDI name to use
See Also:
CONTAINER_PREFIX, setResourceRef(boolean)