org.springframework.ejb.access
Class AbstractRemoteSlsbInvokerInterceptor

java.lang.Object
  org.springframework.jndi.JndiAccessor
      org.springframework.jndi.JndiLocatorSupport
          org.springframework.jndi.JndiObjectLocator
              org.springframework.ejb.access.AbstractSlsbInvokerInterceptor
                  org.springframework.ejb.access.AbstractRemoteSlsbInvokerInterceptor

All Implemented Interfaces:

org.aopalliance.aop.Advice, InitializingBean, org.aopalliance.intercept.Interceptor, org.aopalliance.intercept.MethodInterceptor

Direct Known Subclasses:

SimpleRemoteSlsbInvokerInterceptor

public abstract class AbstractRemoteSlsbInvokerInterceptor

extends AbstractSlsbInvokerInterceptor

Superclass for interceptors proxying remote Stateless Session Beans.

Such an interceptor must be the last interceptor in the advice chain. In this case, there is no target object.

Author:

Rod Johnson, Juergen Hoeller

Field Summary

Fields inherited from class org.springframework.jndi.JndiLocatorSupport

CONTAINER_PREFIX

Fields inherited from class org.springframework.jndi.JndiAccessor

logger

Constructor Summary

AbstractRemoteSlsbInvokerInterceptor()

Method Summary

protected abstract java.lang.Object	doInvoke(org.aopalliance.intercept.MethodInvocation invocation) Perform the given invocation on the current EJB home.
java.lang.Object	invoke(org.aopalliance.intercept.MethodInvocation invocation) Fetches an EJB home object and delegates to doInvoke.
protected boolean	isHomeRefreshable() Return whether the cached EJB home object is potentially subject to on-demand refreshing.
protected javax.ejb.EJBObject	newSessionBeanInstance() Return a new instance of the stateless session bean.
protected java.lang.Object	refreshAndRetry(org.aopalliance.intercept.MethodInvocation invocation) Refresh the EJB home object and retry the given invocation.
protected void	removeSessionBeanInstance(javax.ejb.EJBObject ejb) Remove the given EJB instance.
void	setRefreshHomeOnConnectFailure(boolean refreshHomeOnConnectFailure) Set whether to refresh the EJB home on connect failure.

Methods inherited from class org.springframework.ejb.access.AbstractSlsbInvokerInterceptor

afterPropertiesSet, create, getCreateMethod, getHome, refreshHome, setCacheHome, setLookupHomeOnStartup

Methods inherited from class org.springframework.jndi.JndiObjectLocator

getJndiName, lookup, setJndiName

Methods inherited from class org.springframework.jndi.JndiLocatorSupport

convertJndiName, isResourceRef, 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

AbstractRemoteSlsbInvokerInterceptor

public AbstractRemoteSlsbInvokerInterceptor()

Method Detail

setRefreshHomeOnConnectFailure

public void setRefreshHomeOnConnectFailure(boolean refreshHomeOnConnectFailure)

Set whether to refresh the EJB home on connect failure. Default is false.

Can be turned on to allow for hot restart of the EJB server. If a cached EJB home throws a ConnectException, a fresh home will be fetched and the invocation will be retried.

See Also:

ConnectException

isHomeRefreshable

protected boolean isHomeRefreshable()

Description copied from class: AbstractSlsbInvokerInterceptor

Return whether the cached EJB home object is potentially subject to on-demand refreshing. Default is false.

Overrides:

isHomeRefreshable in class AbstractSlsbInvokerInterceptor

invoke

public java.lang.Object invoke(org.aopalliance.intercept.MethodInvocation invocation)
                        throws java.lang.Throwable

Fetches an EJB home object and delegates to doInvoke. If configured to refresh on connect failure, it will call refreshAndRetry on ConnectException.

Throws:

java.lang.Throwable

See Also:

AbstractSlsbInvokerInterceptor.getHome(), doInvoke(org.aopalliance.intercept.MethodInvocation), refreshAndRetry(org.aopalliance.intercept.MethodInvocation), ConnectException

refreshAndRetry

protected java.lang.Object refreshAndRetry(org.aopalliance.intercept.MethodInvocation invocation)
                                    throws java.lang.Throwable

Refresh the EJB home object and retry the given invocation. Called by invoke on connect failure.

Parameters:

invocation - the AOP method invocation

Returns:

the invocation result, if any

Throws:

java.lang.Throwable - in case of invocation failure

See Also:

invoke(org.aopalliance.intercept.MethodInvocation)

doInvoke

protected abstract java.lang.Object doInvoke(org.aopalliance.intercept.MethodInvocation invocation)
                                      throws java.lang.Throwable

Perform the given invocation on the current EJB home. Template method to be implemented by a subclass.

Parameters:

invocation - the AOP method invocation

Returns:

the invocation result, if any

Throws:

java.lang.Throwable - in case of invocation failure

See Also:

AbstractSlsbInvokerInterceptor.getHome(), newSessionBeanInstance()

newSessionBeanInstance

protected javax.ejb.EJBObject newSessionBeanInstance()
                                              throws javax.naming.NamingException,
                                                     java.lang.reflect.InvocationTargetException

Return a new instance of the stateless session bean. Can be overridden to change the algorithm.

Throws:

javax.naming.NamingException - if thrown by JNDI

java.lang.reflect.InvocationTargetException - if thrown by the create method

See Also:

AbstractSlsbInvokerInterceptor.create()

removeSessionBeanInstance

protected void removeSessionBeanInstance(javax.ejb.EJBObject ejb)

Remove the given EJB instance.

Parameters:

ejb - the EJB instance to remove

See Also:

EJBObject.remove()