org.springframework.remoting.caucho

Class BurlapClientInterceptor

java.lang.Object

org.springframework.remoting.support.RemotingSupport

org.springframework.remoting.support.RemoteAccessor

org.springframework.remoting.support.UrlBasedRemoteAccessor

org.springframework.remoting.caucho.BurlapClientInterceptor

All Implemented Interfaces:

Advice, Interceptor, MethodInterceptor, Aware, BeanClassLoaderAware, InitializingBean

Direct Known Subclasses:

BurlapProxyFactoryBean

Deprecated.

as of Spring 4.0, since Burlap hasn't evolved in years and is effectively retired (in contrast to its sibling Hessian)

@Deprecated
public class BurlapClientInterceptor
extends UrlBasedRemoteAccessor
implements MethodInterceptor

MethodInterceptor for accessing a Burlap service. Supports authentication via username and password. The service URL must be an HTTP URL exposing a Burlap service.

Burlap is a slim, XML-based RPC protocol. For information on Burlap, see the Burlap website

Note: There is no requirement for services accessed with this proxy factory to have been exported using Spring's BurlapServiceExporter, as there is no special handling involved. As a consequence, you can also access services that have been exported using Caucho's BurlapServlet.

Since:

29.09.2003

Author:

Juergen Hoeller

See Also:

RemoteAccessor.setServiceInterface(java.lang.Class<?>), UrlBasedRemoteAccessor.setServiceUrl(java.lang.String), setUsername(java.lang.String), setPassword(java.lang.String), BurlapServiceExporter, BurlapProxyFactoryBean, BurlapProxyFactory, BurlapServlet

Field Summary

Fields inherited from class org.springframework.remoting.support.RemotingSupport

logger

Constructor Summary

Constructors

Constructor and Description
BurlapClientInterceptor() Deprecated.

Method Summary

Modifier and Type	Method and Description
void	afterPropertiesSet() Deprecated. Invoked by the containing BeanFactory after it has set all bean properties and satisfied BeanFactoryAware, ApplicationContextAware etc.
protected RemoteAccessException	convertBurlapAccessException(java.lang.Throwable ex) Deprecated. Convert the given Burlap access exception to an appropriate Spring RemoteAccessException.
protected java.lang.Object	createBurlapProxy(com.caucho.burlap.client.BurlapProxyFactory proxyFactory) Deprecated. Create the Burlap proxy that is wrapped by this interceptor.
java.lang.Object	invoke(MethodInvocation invocation) Deprecated. Implement this method to perform extra treatments before and after the invocation.
void	prepare() Deprecated. Initialize the Burlap proxy for this interceptor.
void	setOverloadEnabled(boolean overloadEnabled) Deprecated. Set whether overloaded methods should be enabled for remote invocations.
void	setPassword(java.lang.String password) Deprecated. Set the password that this factory should use to access the remote service.
void	setProxyFactory(com.caucho.burlap.client.BurlapProxyFactory proxyFactory) Deprecated. Set the BurlapProxyFactory instance to use.
void	setUsername(java.lang.String username) Deprecated. Set the username that this factory should use to access the remote service.

Methods inherited from class org.springframework.remoting.support.UrlBasedRemoteAccessor

getServiceUrl, setServiceUrl

Methods inherited from class org.springframework.remoting.support.RemoteAccessor

getServiceInterface, setServiceInterface

Methods inherited from class org.springframework.remoting.support.RemotingSupport

getBeanClassLoader, overrideThreadContextClassLoader, resetThreadContextClassLoader, setBeanClassLoader

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BurlapClientInterceptor

public BurlapClientInterceptor()

Deprecated.

Method Detail

setProxyFactory

public void setProxyFactory(com.caucho.burlap.client.BurlapProxyFactory proxyFactory)

Deprecated.

Set the BurlapProxyFactory instance to use. If not specified, a default BurlapProxyFactory will be created.

Allows to use an externally configured factory instance, in particular a custom BurlapProxyFactory subclass.

setUsername

public void setUsername(java.lang.String username)

Deprecated.

Set the username that this factory should use to access the remote service. Default is none.

The username will be sent by Burlap via HTTP Basic Authentication.

See Also:

BurlapProxyFactory.setUser(java.lang.String)

setPassword

public void setPassword(java.lang.String password)

Deprecated.

Set the password that this factory should use to access the remote service. Default is none.

The password will be sent by Burlap via HTTP Basic Authentication.

See Also:

BurlapProxyFactory.setPassword(java.lang.String)

setOverloadEnabled

public void setOverloadEnabled(boolean overloadEnabled)

Deprecated.

Set whether overloaded methods should be enabled for remote invocations. Default is "false".

See Also:

BurlapProxyFactory.setOverloadEnabled(boolean)

afterPropertiesSet

public void afterPropertiesSet()

Deprecated.

Description copied from interface: InitializingBean

Invoked by the containing BeanFactory after it has set all bean properties and satisfied BeanFactoryAware, ApplicationContextAware etc.

This method allows the bean instance to perform validation of its overall configuration and final initialization when all bean properties have been set.

Specified by:

afterPropertiesSet in interface InitializingBean

Overrides:

afterPropertiesSet in class UrlBasedRemoteAccessor

prepare

public void prepare()
             throws RemoteLookupFailureException

Deprecated.

Initialize the Burlap proxy for this interceptor.

Throws:

RemoteLookupFailureException - if the service URL is invalid

createBurlapProxy

protected java.lang.Object createBurlapProxy(com.caucho.burlap.client.BurlapProxyFactory proxyFactory)
                                      throws java.net.MalformedURLException

Deprecated.

Create the Burlap proxy that is wrapped by this interceptor.

Parameters:

proxyFactory - the proxy factory to use

Returns:

the Burlap proxy

Throws:

java.net.MalformedURLException - if thrown by the proxy factory

See Also:

BurlapProxyFactory.create(java.lang.String)

invoke

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

Deprecated.

Description copied from interface: MethodInterceptor

Implement this method to perform extra treatments before and after the invocation. Polite implementations would certainly like to invoke Joinpoint.proceed().

Specified by:

invoke in interface MethodInterceptor

Parameters:

invocation - the method invocation joinpoint

Returns:

the result of the call to Joinpoint.proceed(); might be intercepted by the interceptor

Throws:

java.lang.Throwable - if the interceptors or the target object throws an exception

convertBurlapAccessException

protected RemoteAccessException convertBurlapAccessException(java.lang.Throwable ex)

Deprecated.

Convert the given Burlap access exception to an appropriate Spring RemoteAccessException.

Parameters:

ex - the exception to convert

Returns:

the RemoteAccessException to throw