org.apache.xmlrpc.server

Class XmlRpcStreamServer

java.lang.Object

org.apache.xmlrpc.common.XmlRpcController

org.apache.xmlrpc.server.XmlRpcServer

org.apache.xmlrpc.server.XmlRpcStreamServer

All Implemented Interfaces:

XmlRpcRequestProcessor, XmlRpcStreamRequestProcessor

Direct Known Subclasses:

XmlRpcHttpServer, XmlRpcLocalStreamServer

public abstract class XmlRpcStreamServer
extends XmlRpcServer
implements XmlRpcStreamRequestProcessor

Extension of XmlRpcServer with support for reading requests from a stream and writing the response to another stream.

Constructor Summary

Constructors

Constructor and Description
XmlRpcStreamServer()

Method Summary

Modifier and Type	Method and Description
protected Throwable	convertThrowable(Throwable pError) This method allows to convert the error into another error.
void	execute(XmlRpcStreamRequestConfig pConfig, ServerStreamConnection pConnection) Returns, whether the /** Processes a "connection".
XmlRpcErrorLogger	getErrorLogger() Returns the error logger.
protected InputStream	getInputStream(XmlRpcStreamRequestConfig pConfig, ServerStreamConnection pConnection)
protected OutputStream	getOutputStream(ServerStreamConnection pConnection, XmlRpcStreamRequestConfig pConfig, OutputStream pStream) Called to prepare the output stream.
protected OutputStream	getOutputStream(XmlRpcStreamRequestConfig pConfig, ServerStreamConnection pConnection, int pSize) Called to prepare the output stream, if content length is required.
protected XmlRpcRequest	getRequest(XmlRpcStreamRequestConfig pConfig, InputStream pStream)
protected XmlRpcWriter	getXmlRpcWriter(XmlRpcStreamRequestConfig pConfig, OutputStream pStream)
XmlWriterFactory	getXMLWriterFactory() Returns the XML Writer factory.
protected boolean	isContentLengthRequired(XmlRpcStreamRequestConfig pConfig) Returns, whether the requests content length is required.
protected void	logError(Throwable t)
void	setErrorLogger(XmlRpcErrorLogger pErrorLogger) Sets the error logger.
void	setXMLWriterFactory(XmlWriterFactory pFactory) Sets the XML Writer factory.
protected void	writeError(XmlRpcStreamRequestConfig pConfig, OutputStream pStream, Throwable pError)
protected void	writeResponse(XmlRpcStreamRequestConfig pConfig, OutputStream pStream, Object pResult)

Methods inherited from class org.apache.xmlrpc.server.XmlRpcServer

execute, getConfig, getDefaultXmlRpcWorkerFactory, getHandlerMapping, getTypeConverterFactory, setConfig, setHandlerMapping, setTypeConverterFactory

Methods inherited from class org.apache.xmlrpc.common.XmlRpcController

getMaxThreads, getTypeFactory, getWorkerFactory, setMaxThreads, setTypeFactory, setWorkerFactory

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.xmlrpc.common.XmlRpcRequestProcessor

execute, getTypeConverterFactory

Constructor Detail

XmlRpcStreamServer

public XmlRpcStreamServer()

Method Detail

getRequest

protected XmlRpcRequest getRequest(XmlRpcStreamRequestConfig pConfig,
                                   InputStream pStream)
                            throws XmlRpcException

Throws:

XmlRpcException

getXmlRpcWriter

protected XmlRpcWriter getXmlRpcWriter(XmlRpcStreamRequestConfig pConfig,
                                       OutputStream pStream)
                                throws XmlRpcException

Throws:

XmlRpcException

writeResponse

protected void writeResponse(XmlRpcStreamRequestConfig pConfig,
                             OutputStream pStream,
                             Object pResult)
                      throws XmlRpcException

Throws:

XmlRpcException

convertThrowable

protected Throwable convertThrowable(Throwable pError)

This method allows to convert the error into another error. For example, this may be an error, which could be deserialized by the client.

writeError

protected void writeError(XmlRpcStreamRequestConfig pConfig,
                          OutputStream pStream,
                          Throwable pError)
                   throws XmlRpcException

Throws:

XmlRpcException

setXMLWriterFactory

public void setXMLWriterFactory(XmlWriterFactory pFactory)

Sets the XML Writer factory.

Parameters:

pFactory - The XML Writer factory.

getXMLWriterFactory

public XmlWriterFactory getXMLWriterFactory()

Returns the XML Writer factory.

Returns:

The XML Writer factory.

getInputStream

protected InputStream getInputStream(XmlRpcStreamRequestConfig pConfig,
                                     ServerStreamConnection pConnection)
                              throws IOException

Throws:

IOException

getOutputStream

protected OutputStream getOutputStream(ServerStreamConnection pConnection,
                                       XmlRpcStreamRequestConfig pConfig,
                                       OutputStream pStream)
                                throws IOException

Called to prepare the output stream. Typically used for enabling compression, or similar filters.

Parameters:

pConnection - The connection object.

Throws:

IOException

getOutputStream

protected OutputStream getOutputStream(XmlRpcStreamRequestConfig pConfig,
                                       ServerStreamConnection pConnection,
                                       int pSize)
                                throws IOException

Called to prepare the output stream, if content length is required.

Parameters:

pConfig - The configuration object.

pSize - The requests size.

Throws:

IOException

isContentLengthRequired

protected boolean isContentLengthRequired(XmlRpcStreamRequestConfig pConfig)

Returns, whether the requests content length is required.

Parameters:

pConfig - The configuration object.

execute

public void execute(XmlRpcStreamRequestConfig pConfig,
                    ServerStreamConnection pConnection)
             throws XmlRpcException

Returns, whether the /** Processes a "connection". The "connection" is an opaque object, which is being handled by the subclasses.

Specified by:

execute in interface XmlRpcStreamRequestProcessor

Parameters:

pConfig - The request configuration.

pConnection - The "connection" being processed.

Throws:

XmlRpcException - Processing the request failed.

logError

protected void logError(Throwable t)

getErrorLogger

public XmlRpcErrorLogger getErrorLogger()

Returns the error logger.

setErrorLogger

public void setErrorLogger(XmlRpcErrorLogger pErrorLogger)

Sets the error logger.