org.springframework.jndi.support

Class SimpleJndiBeanFactory

java.lang.Object

org.springframework.jndi.JndiAccessor

org.springframework.jndi.JndiLocatorSupport

org.springframework.jndi.support.SimpleJndiBeanFactory

All Implemented Interfaces:

org.springframework.beans.factory.BeanFactory

public class SimpleJndiBeanFactory
extends JndiLocatorSupport
implements org.springframework.beans.factory.BeanFactory

Simple JNDI-based implementation of Spring's BeanFactory interface. Does not support enumerating bean definitions, hence doesn't implement the ListableBeanFactory interface.

This factory resolves given bean names as JNDI names within the Java EE application's "java:comp/env/" namespace. It caches the resolved types for all obtained objects, and optionally also caches shareable objects (if they are explicitly marked as shareable resource.

The main intent of this factory is usage in combination with Spring's CommonAnnotationBeanPostProcessor, configured as "resourceFactory" for resolving @Resource annotations as JNDI objects without intermediate bean definitions. It may be used for similar lookup scenarios as well, of course, in particular if BeanFactory-style type checking is required.

Since:

2.5

Author:

Juergen Hoeller

See Also:

DefaultListableBeanFactory, CommonAnnotationBeanPostProcessor

Field Summary

Fields inherited from class org.springframework.jndi.JndiLocatorSupport

CONTAINER_PREFIX

Fields inherited from class org.springframework.jndi.JndiAccessor

logger

Fields inherited from interface org.springframework.beans.factory.BeanFactory

FACTORY_BEAN_PREFIX

Constructor Summary

Constructors

Constructor and Description
SimpleJndiBeanFactory()

Method Summary

Modifier and Type	Method and Description
void	addShareableResource(java.lang.String shareableResource) Add the name of a shareable JNDI resource, which this factory is allowed to cache once obtained.
boolean	containsBean(java.lang.String name)
java.lang.String[]	getAliases(java.lang.String name)
<T> T	getBean(java.lang.Class<T> requiredType)
<T> T	getBean(java.lang.Class<T> requiredType, java.lang.Object... args)
java.lang.Object	getBean(java.lang.String name)
<T> T	getBean(java.lang.String name, java.lang.Class<T> requiredType)
java.lang.Object	getBean(java.lang.String name, java.lang.Object... args)
java.lang.Class<?>	getType(java.lang.String name)
boolean	isPrototype(java.lang.String name)
boolean	isSingleton(java.lang.String name)
boolean	isTypeMatch(java.lang.String name, java.lang.Class<?> typeToMatch)
boolean	isTypeMatch(java.lang.String name, org.springframework.core.ResolvableType typeToMatch)
void	setShareableResources(java.lang.String... shareableResources) Set a list of names of shareable JNDI resources, which this factory is allowed to cache once obtained.

Methods inherited from class org.springframework.jndi.JndiLocatorSupport

convertJndiName, isResourceRef, lookup, lookup, setResourceRef

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

Constructor Detail

SimpleJndiBeanFactory

public SimpleJndiBeanFactory()

Method Detail

addShareableResource

public void addShareableResource(java.lang.String shareableResource)

Add the name of a shareable JNDI resource, which this factory is allowed to cache once obtained.

Parameters:

shareableResource - the JNDI name (typically within the "java:comp/env/" namespace)

setShareableResources

public void setShareableResources(java.lang.String... shareableResources)

Set a list of names of shareable JNDI resources, which this factory is allowed to cache once obtained.

Parameters:

shareableResources - the JNDI names (typically within the "java:comp/env/" namespace)

getBean

public java.lang.Object getBean(java.lang.String name)
                         throws org.springframework.beans.BeansException

Specified by:

getBean in interface org.springframework.beans.factory.BeanFactory

Throws:

org.springframework.beans.BeansException

getBean

public <T> T getBean(java.lang.String name,
                     @Nullable
                     java.lang.Class<T> requiredType)
              throws org.springframework.beans.BeansException

Specified by:

getBean in interface org.springframework.beans.factory.BeanFactory

Throws:

org.springframework.beans.BeansException

getBean

public java.lang.Object getBean(java.lang.String name,
                                @Nullable
                                java.lang.Object... args)
                         throws org.springframework.beans.BeansException

Specified by:

getBean in interface org.springframework.beans.factory.BeanFactory

Throws:

org.springframework.beans.BeansException

getBean

public <T> T getBean(java.lang.Class<T> requiredType)
              throws org.springframework.beans.BeansException

Specified by:

getBean in interface org.springframework.beans.factory.BeanFactory

Throws:

org.springframework.beans.BeansException

getBean

public <T> T getBean(java.lang.Class<T> requiredType,
                     @Nullable
                     java.lang.Object... args)
              throws org.springframework.beans.BeansException

Specified by:

getBean in interface org.springframework.beans.factory.BeanFactory

Throws:

org.springframework.beans.BeansException

containsBean

public boolean containsBean(java.lang.String name)

Specified by:

containsBean in interface org.springframework.beans.factory.BeanFactory

isSingleton

public boolean isSingleton(java.lang.String name)
                    throws org.springframework.beans.factory.NoSuchBeanDefinitionException

Specified by:

isSingleton in interface org.springframework.beans.factory.BeanFactory

Throws:

org.springframework.beans.factory.NoSuchBeanDefinitionException

isPrototype

public boolean isPrototype(java.lang.String name)
                    throws org.springframework.beans.factory.NoSuchBeanDefinitionException

Specified by:

isPrototype in interface org.springframework.beans.factory.BeanFactory

Throws:

org.springframework.beans.factory.NoSuchBeanDefinitionException

isTypeMatch

public boolean isTypeMatch(java.lang.String name,
                           org.springframework.core.ResolvableType typeToMatch)
                    throws org.springframework.beans.factory.NoSuchBeanDefinitionException

Specified by:

isTypeMatch in interface org.springframework.beans.factory.BeanFactory

Throws:

org.springframework.beans.factory.NoSuchBeanDefinitionException

isTypeMatch

public boolean isTypeMatch(java.lang.String name,
                           @Nullable
                           java.lang.Class<?> typeToMatch)
                    throws org.springframework.beans.factory.NoSuchBeanDefinitionException

Specified by:

isTypeMatch in interface org.springframework.beans.factory.BeanFactory

Throws:

org.springframework.beans.factory.NoSuchBeanDefinitionException

getType

@Nullable
public java.lang.Class<?> getType(java.lang.String name)
                                     throws org.springframework.beans.factory.NoSuchBeanDefinitionException

Specified by:

getType in interface org.springframework.beans.factory.BeanFactory

Throws:

org.springframework.beans.factory.NoSuchBeanDefinitionException

getAliases

public java.lang.String[] getAliases(java.lang.String name)

Specified by:

getAliases in interface org.springframework.beans.factory.BeanFactory