LocalSlsbInvokerInterceptor

Class Overview

Invoker for a local Stateless Session Bean. Designed for EJB 2.x, but works for EJB 3 Session Beans as well.

Caches the home object, since a local EJB home can never go stale. See JndiObjectLocator for info on how to specify the JNDI location of the target EJB.

In a bean container, this class is normally best used as a singleton. However, if that bean container pre-instantiates singletons (as do the XML ApplicationContext variants) you may have a problem if the bean container is loaded before the EJB container loads the target EJB. That is because by default the JNDI lookup will be performed in the init method of this class and cached, but the EJB will not have been bound at the target location yet. The best solution is to set the lookupHomeOnStartup property to false, in which case the home will be fetched on first access to the EJB. (This flag is only true by default for backwards compatibility reasons).

Summary

[Expand] Inherited Constants
From class org.springframework.jndi.JndiLocatorSupport String CONTAINER_PREFIX JNDI prefix used in a J2EE container

[Expand] Inherited Fields
From class org.springframework.jndi.JndiAccessor protected final Log logger Logger, available to subclasses.

[Expand] Inherited Methods
From class org.springframework.ejb.access.AbstractSlsbInvokerInterceptor void afterPropertiesSet() Fetches EJB home on startup, if necessary. Object create() Invokes the create() method on the cached EJB home object. Method getCreateMethod(Object home) Determine the create method of the given EJB home object. Object getHome() Return the EJB home object to use. Object invoke(MethodInvocation invocation) Prepares the thread context if necessar, and delegates to invokeInContext(MethodInvocation). abstract Object invokeInContext(MethodInvocation invocation) Perform the given invocation on the current EJB home, within the thread context being prepared accordingly. boolean isHomeRefreshable() Return whether the cached EJB home object is potentially subject to on-demand refreshing. void refreshHome() Refresh the cached home object, if applicable. void setCacheHome(boolean cacheHome) Set whether to cache the EJB home object once it has been located. void setExposeAccessContext(boolean exposeAccessContext) Set whether to expose the JNDI environment context for all access to the target EJB, i.e. void setLookupHomeOnStartup(boolean lookupHomeOnStartup) Set whether to look up the EJB home object on startup.
From class org.springframework.jndi.JndiObjectLocator void afterPropertiesSet() Invoked by a BeanFactory after it has set all bean properties supplied (and satisfied BeanFactoryAware and ApplicationContextAware). Class<?> getExpectedType() Return the type that the located JNDI object is supposed to be assignable to, if any. String getJndiName() Return the JNDI name to look up. Object lookup() Perform the actual JNDI lookup for this locator's target resource. void setExpectedType(Class<?> expectedType) Specify the type that the located JNDI object is supposed to be assignable to, if any. void setJndiName(String jndiName) Specify the JNDI name to look up.
From class org.springframework.jndi.JndiLocatorSupport String convertJndiName(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. <T> T lookup(String jndiName, Class<T> requiredType) Perform an actual JNDI lookup for the given name via the JndiTemplate. Object lookup(String jndiName) 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.
From class org.springframework.jndi.JndiAccessor Properties getJndiEnvironment() Return the JNDI environment to use for JNDI lookups. JndiTemplate getJndiTemplate() Return the JNDI template to use for JNDI lookups. void setJndiEnvironment(Properties jndiEnvironment) Set the JNDI environment to use for JNDI lookups. void setJndiTemplate(JndiTemplate jndiTemplate) Set the JNDI template to use for JNDI lookups.
From class java.lang.Object Object clone() boolean equals(Object arg0) void finalize() final Class<?> getClass() int hashCode() final void notify() final void notifyAll() String toString() final void wait() final void wait(long arg0, int arg1) final void wait(long arg0)
From interface org.springframework.beans.factory.InitializingBean abstract void afterPropertiesSet() Invoked by a BeanFactory after it has set all bean properties supplied (and satisfied BeanFactoryAware and ApplicationContextAware).