org.springframework.remoting.httpinvoker

Class HttpInvokerProxyFactoryBean

java.lang.Object

org.springframework.remoting.support.RemotingSupport

org.springframework.remoting.support.RemoteAccessor

org.springframework.remoting.support.UrlBasedRemoteAccessor

org.springframework.remoting.support.RemoteInvocationBasedAccessor

org.springframework.remoting.httpinvoker.HttpInvokerClientInterceptor

org.springframework.remoting.httpinvoker.HttpInvokerProxyFactoryBean

All Implemented Interfaces:

org.aopalliance.aop.Advice, org.aopalliance.intercept.Interceptor, org.aopalliance.intercept.MethodInterceptor, org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanClassLoaderAware, org.springframework.beans.factory.FactoryBean<Object>, org.springframework.beans.factory.InitializingBean, HttpInvokerClientConfiguration

public class HttpInvokerProxyFactoryBean
extends HttpInvokerClientInterceptor
implements org.springframework.beans.factory.FactoryBean<Object>

FactoryBean for HTTP invoker proxies. Exposes the proxied service for use as a bean reference, using the specified service interface.

The service URL must be an HTTP URL exposing an HTTP invoker service. Optionally, a codebase URL can be specified for on-demand dynamic code download from a remote location. For details, see HttpInvokerClientInterceptor docs.

Serializes remote invocation objects and deserializes remote invocation result objects. Uses Java serialization just like RMI, but provides the same ease of setup as Caucho's HTTP-based Hessian and Burlap protocols.

HTTP invoker is the recommended protocol for Java-to-Java remoting. It is more powerful and more extensible than Hessian and Burlap, at the expense of being tied to Java. Nevertheless, it is as easy to set up as Hessian and Burlap, which is its main advantage compared to RMI.

WARNING: Be aware of vulnerabilities due to unsafe Java deserialization: Manipulated input streams could lead to unwanted code execution on the server during the deserialization step. As a consequence, do not expose HTTP invoker endpoints to untrusted clients but rather just between your own services. In general, we strongly recommend any other message format (e.g. JSON) instead.

Since:

1.1

Author:

Juergen Hoeller

See Also:

RemoteAccessor.setServiceInterface(java.lang.Class<?>), UrlBasedRemoteAccessor.setServiceUrl(java.lang.String), HttpInvokerClientInterceptor.setCodebaseUrl(java.lang.String), HttpInvokerClientInterceptor, HttpInvokerServiceExporter, RmiProxyFactoryBean, HessianProxyFactoryBean, BurlapProxyFactoryBean

Field Summary

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

logger

Constructor Summary

Constructors

Constructor and Description
HttpInvokerProxyFactoryBean()

Method Summary

Modifier and Type	Method and Description
void	afterPropertiesSet()
Object	getObject()
Class<?>	getObjectType()
boolean	isSingleton()

Methods inherited from class org.springframework.remoting.httpinvoker.HttpInvokerClientInterceptor

convertHttpInvokerAccessException, executeRequest, executeRequest, getCodebaseUrl, getHttpInvokerRequestExecutor, invoke, setCodebaseUrl, setHttpInvokerRequestExecutor

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

createRemoteInvocation, getRemoteInvocationFactory, recreateRemoteInvocationResult, setRemoteInvocationFactory

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

Methods inherited from interface org.springframework.remoting.httpinvoker.HttpInvokerClientConfiguration

getServiceUrl

Constructor Detail

HttpInvokerProxyFactoryBean

public HttpInvokerProxyFactoryBean()

Method Detail

afterPropertiesSet

public void afterPropertiesSet()

Specified by:

afterPropertiesSet in interface org.springframework.beans.factory.InitializingBean

Overrides:

afterPropertiesSet in class HttpInvokerClientInterceptor

getObject

public Object getObject()

Specified by:

getObject in interface org.springframework.beans.factory.FactoryBean<Object>

getObjectType

public Class<?> getObjectType()

Specified by:

getObjectType in interface org.springframework.beans.factory.FactoryBean<Object>

isSingleton

public boolean isSingleton()

Specified by:

isSingleton in interface org.springframework.beans.factory.FactoryBean<Object>