|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.springframework.remoting.support.RemotingSupport org.springframework.remoting.support.RemoteExporter org.springframework.remoting.support.RemoteInvocationBasedExporter org.springframework.remoting.rmi.RemoteInvocationSerializingExporter org.springframework.remoting.httpinvoker.SimpleHttpInvokerServiceExporter
public class SimpleHttpInvokerServiceExporter
HTTP request handler that exports the specified service bean as
HTTP invoker service endpoint, accessible via an HTTP invoker proxy.
Designed for Sun's JRE 1.6 HTTP server, implementing the
HttpHandler
interface.
Deserializes remote invocation objects and serializes 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.
HttpInvokerClientInterceptor
,
HttpInvokerProxyFactoryBean
,
SimpleHessianServiceExporter
,
SimpleBurlapServiceExporter
Field Summary |
---|
Fields inherited from class org.springframework.remoting.rmi.RemoteInvocationSerializingExporter |
---|
CONTENT_TYPE_SERIALIZED_OBJECT |
Fields inherited from class org.springframework.remoting.support.RemotingSupport |
---|
logger |
Constructor Summary | |
---|---|
SimpleHttpInvokerServiceExporter()
|
Method Summary | |
---|---|
protected InputStream |
decorateInputStream(HttpExchange exchange,
InputStream is)
Return the InputStream to use for reading remote invocations, potentially decorating the given original InputStream. |
protected OutputStream |
decorateOutputStream(HttpExchange exchange,
OutputStream os)
Return the OutputStream to use for writing remote invocation results, potentially decorating the given original OutputStream. |
void |
handle(HttpExchange exchange)
Reads a remote invocation from the request, executes it, and writes the remote invocation result to the response. |
protected RemoteInvocation |
readRemoteInvocation(HttpExchange exchange)
Read a RemoteInvocation from the given HTTP request. |
protected RemoteInvocation |
readRemoteInvocation(HttpExchange exchange,
InputStream is)
Deserialize a RemoteInvocation object from the given InputStream. |
protected void |
writeRemoteInvocationResult(HttpExchange exchange,
RemoteInvocationResult result)
Write the given RemoteInvocationResult to the given HTTP response. |
protected void |
writeRemoteInvocationResult(HttpExchange exchange,
RemoteInvocationResult result,
OutputStream os)
Serialize the given RemoteInvocation to the given OutputStream. |
Methods inherited from class org.springframework.remoting.rmi.RemoteInvocationSerializingExporter |
---|
afterPropertiesSet, createObjectInputStream, createObjectOutputStream, doReadRemoteInvocation, doWriteRemoteInvocationResult, getContentType, getProxy, prepare, setContentType |
Methods inherited from class org.springframework.remoting.support.RemoteInvocationBasedExporter |
---|
getRemoteInvocationExecutor, invoke, invokeAndCreateResult, setRemoteInvocationExecutor |
Methods inherited from class org.springframework.remoting.support.RemoteExporter |
---|
checkService, checkServiceInterface, getExporterName, getProxyForService, getService, getServiceInterface, setInterceptors, setRegisterTraceInterceptor, setService, 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 |
---|
public SimpleHttpInvokerServiceExporter()
Method Detail |
---|
public void handle(HttpExchange exchange) throws IOException
handle
in interface HttpHandler
IOException
readRemoteInvocation(com.sun.net.httpserver.HttpExchange)
,
RemoteInvocationBasedExporter.invokeAndCreateResult(org.springframework.remoting.support.RemoteInvocation, Object)
,
writeRemoteInvocationResult(com.sun.net.httpserver.HttpExchange, org.springframework.remoting.support.RemoteInvocationResult)
protected RemoteInvocation readRemoteInvocation(HttpExchange exchange) throws IOException, ClassNotFoundException
Delegates to
readRemoteInvocation(com.sun.net.httpserver.HttpExchange, java.io.InputStream)
with the
HttpExchange.getRequestBody()
request's input stream}.
exchange
- current HTTP request/response
IOException
- in case of I/O failure
ClassNotFoundException
- if thrown by deserializationprotected RemoteInvocation readRemoteInvocation(HttpExchange exchange, InputStream is) throws IOException, ClassNotFoundException
Gives decorateInputStream(com.sun.net.httpserver.HttpExchange, java.io.InputStream)
a chance to decorate the stream
first (for example, for custom encryption or compression). Creates a
CodebaseAwareObjectInputStream
and calls RemoteInvocationSerializingExporter.doReadRemoteInvocation(java.io.ObjectInputStream)
to actually read the object.
Can be overridden for custom serialization of the invocation.
exchange
- current HTTP request/responseis
- the InputStream to read from
IOException
- in case of I/O failure
ClassNotFoundException
- if thrown during deserializationprotected InputStream decorateInputStream(HttpExchange exchange, InputStream is) throws IOException
The default implementation returns the given stream as-is. Can be overridden, for example, for custom encryption or compression.
exchange
- current HTTP request/responseis
- the original InputStream
IOException
- in case of I/O failureprotected void writeRemoteInvocationResult(HttpExchange exchange, RemoteInvocationResult result) throws IOException
exchange
- current HTTP request/responseresult
- the RemoteInvocationResult object
IOException
- in case of I/O failureprotected void writeRemoteInvocationResult(HttpExchange exchange, RemoteInvocationResult result, OutputStream os) throws IOException
The default implementation gives decorateOutputStream(com.sun.net.httpserver.HttpExchange, java.io.OutputStream)
a chance
to decorate the stream first (for example, for custom encryption or compression).
Creates an ObjectOutputStream
for the final stream and calls
RemoteInvocationSerializingExporter.doWriteRemoteInvocationResult(org.springframework.remoting.support.RemoteInvocationResult, java.io.ObjectOutputStream)
to actually write the object.
Can be overridden for custom serialization of the invocation.
exchange
- current HTTP request/responseresult
- the RemoteInvocationResult objectos
- the OutputStream to write to
IOException
- in case of I/O failuredecorateOutputStream(com.sun.net.httpserver.HttpExchange, java.io.OutputStream)
,
RemoteInvocationSerializingExporter.doWriteRemoteInvocationResult(org.springframework.remoting.support.RemoteInvocationResult, java.io.ObjectOutputStream)
protected OutputStream decorateOutputStream(HttpExchange exchange, OutputStream os) throws IOException
The default implementation returns the given stream as-is. Can be overridden, for example, for custom encryption or compression.
exchange
- current HTTP request/responseos
- the original OutputStream
IOException
- in case of I/O failure
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |