org.springframework.remoting.rmi: abstract public class: RemoteInvocationSerializingExporter

org.springframework.remoting.rmi
abstract public class: RemoteInvocationSerializingExporter [javadoc | source]

java.lang.Object
   org.springframework.remoting.support.RemotingSupport
      org.springframework.remoting.support.RemoteExporter
         org.springframework.remoting.support.RemoteInvocationBasedExporter
            org.springframework.remoting.rmi.RemoteInvocationSerializingExporter

All Implemented Interfaces:
InitializingBean, BeanClassLoaderAware

Direct Known Subclasses:
SimpleHttpInvokerServiceExporter, HttpInvokerServiceExporter

Abstract base class for remote service exporters that explicitly deserialize org.springframework.remoting.support.RemoteInvocation objects and serialize org.springframework.remoting.support.RemoteInvocationResult objects, for example Spring's HTTP invoker.

Provides template methods for ObjectInputStream and ObjectOutputStream handling.

Also see:

java.io.ObjectInputStream

java.io.ObjectOutputStream

doReadRemoteInvocation

doWriteRemoteInvocationResult

author: Juergen - Hoeller

since: 2.5.1 -

Field Summary
public static final String	CONTENT_TYPE_SERIALIZED_OBJECT	Default content type: "application/x-java-serialized-object"

Fields inherited from org.springframework.remoting.support.RemotingSupport:
logger

Method from org.springframework.remoting.rmi.RemoteInvocationSerializingExporter Summary:
afterPropertiesSet, createObjectInputStream, createObjectOutputStream, doReadRemoteInvocation, doWriteRemoteInvocationResult, getContentType, getProxy, prepare, setContentType

Methods from org.springframework.remoting.support.RemoteInvocationBasedExporter:
getRemoteInvocationExecutor, invoke, invokeAndCreateResult, setRemoteInvocationExecutor

Methods from org.springframework.remoting.support.RemoteExporter:
checkService, checkServiceInterface, getExporterName, getProxyForService, getService, getServiceInterface, isRegisterTraceInterceptor, setRegisterTraceInterceptor, setService, setServiceInterface

Methods from org.springframework.remoting.support.RemotingSupport:
getBeanClassLoader, overrideThreadContextClassLoader, resetThreadContextClassLoader, setBeanClassLoader

Methods from java.lang.Object:
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from org.springframework.remoting.rmi.RemoteInvocationSerializingExporter Detail:
public void afterPropertiesSet() { prepare(); }
protected ObjectInputStream createObjectInputStream(InputStream is) throws IOException { return new CodebaseAwareObjectInputStream(is, getBeanClassLoader(), null); } Create an ObjectInputStream for the given InputStream. The default implementation creates a Spring CodebaseAwareObjectInputStream .
protected ObjectOutputStream createObjectOutputStream(OutputStream os) throws IOException { return new ObjectOutputStream(os); } Create an ObjectOutputStream for the given OutputStream. The default implementation creates a plain java.io.ObjectOutputStream .
protected RemoteInvocation doReadRemoteInvocation(ObjectInputStream ois) throws ClassNotFoundException, IOException { Object obj = ois.readObject(); if (!(obj instanceof RemoteInvocation)) { throw new RemoteException("Deserialized object needs to be assignable to type [" + RemoteInvocation.class.getName() + "]: " + obj); } return (RemoteInvocation) obj; } Perform the actual reading of an invocation result object from the given ObjectInputStream. The default implementation simply calls java.io.ObjectInputStream#readObject() . Can be overridden for deserialization of a custom wrapper object rather than the plain invocation, for example an encryption-aware holder.
protected void doWriteRemoteInvocationResult(RemoteInvocationResult result, ObjectOutputStream oos) throws IOException { oos.writeObject(result); } Perform the actual writing of the given invocation result object to the given ObjectOutputStream. The default implementation simply calls java.io.ObjectOutputStream#writeObject . Can be overridden for serialization of a custom wrapper object rather than the plain invocation, for example an encryption-aware holder.
public String getContentType() { return this.contentType; } Return the content type to use for sending remote invocation responses.
protected final Object getProxy() { Assert.notNull(this.proxy, ClassUtils.getShortName(getClass()) + " has not been initialized"); return this.proxy; }
public void prepare() { this.proxy = getProxyForService(); } Initialize this service exporter.
public void setContentType(String contentType) { Assert.notNull(contentType, "'contentType' must not be null"); this.contentType = contentType; } Specify the content type to use for sending remote invocation responses. Default is "application/x-java-serialized-object".

Method from org.springframework.remoting.rmi.RemoteInvocationSerializingExporter Detail:

 public  void afterPropertiesSet() {
		prepare();
}

 protected ObjectInputStream createObjectInputStream(InputStream is) throws IOException {
		return new CodebaseAwareObjectInputStream(is, getBeanClassLoader(), null);
}

The default implementation creates a Spring CodebaseAwareObjectInputStream .

 protected ObjectOutputStream createObjectOutputStream(OutputStream os) throws IOException {
		return new ObjectOutputStream(os);
}

The default implementation creates a plain java.io.ObjectOutputStream .

 protected RemoteInvocation doReadRemoteInvocation(ObjectInputStream ois) throws ClassNotFoundException, IOException {
		Object obj = ois.readObject();
		if (!(obj instanceof RemoteInvocation)) {
			throw new RemoteException("Deserialized object needs to be assignable to type [" +
					RemoteInvocation.class.getName() + "]: " + obj);
		}
		return (RemoteInvocation) obj;
}

The default implementation simply calls java.io.ObjectInputStream#readObject() . Can be overridden for deserialization of a custom wrapper object rather than the plain invocation, for example an encryption-aware holder.

 protected  void doWriteRemoteInvocationResult(RemoteInvocationResult result,
    ObjectOutputStream oos) throws IOException {
		oos.writeObject(result);
}

The default implementation simply calls java.io.ObjectOutputStream#writeObject . Can be overridden for serialization of a custom wrapper object rather than the plain invocation, for example an encryption-aware holder.

 public String getContentType() {
		return this.contentType;
}

Return the content type to use for sending remote invocation responses.

 protected final Object getProxy() {
		Assert.notNull(this.proxy, ClassUtils.getShortName(getClass()) + " has not been initialized");
		return this.proxy;
}

 public  void prepare() {
		this.proxy = getProxyForService();
}

Initialize this service exporter.

 public  void setContentType(String contentType) {
	              	 
		Assert.notNull(contentType, "'contentType' must not be null");
		this.contentType = contentType;
}

Default is "application/x-java-serialized-object".