org.apache.xmlrpc

Class SystemHandler

public class SystemHandler extends Object implements ContextXmlRpcHandler

Wraps calls to the XML-RPC standard system.* methods (such as system.multicall).

Since: 1.2

Author: Adam Megacz Andrew Evers Daniel L. Rall

Field Summary
DefaultHandlerMapping	systemMapping

Constructor Summary
	SystemHandler() Creates a new instance.
	SystemHandler(XmlRpcHandlerMapping handlerMapping) Creates a new instance that delegates calls via the specified XmlRpcHandlerMapping.
protected	SystemHandler(XmlRpcServer server) Creates a new instance that delegates its multicalls via the mapping used by the specified XmlRpcServer.

Method Summary
void	addDefaultSystemHandlers() Add the default system handlers.
void	addSystemHandler(String handlerName, ContextXmlRpcHandler handler)
Object	execute(String method, Vector params, XmlRpcContext context) Execute a <ignored>.<name> call by calling the handler for <name> in the the system handler mapping.
void	removeSystemHandler(String handlerName)

Field Detail

systemMapping

private DefaultHandlerMapping systemMapping

Constructor Detail

SystemHandler

public SystemHandler()

Creates a new instance. This instance contains no system calls. Use the addDefaultSystemHandlers() method to add the 'default' set of handlers, or add handlers manually.

SystemHandler

public SystemHandler(XmlRpcHandlerMapping handlerMapping)

Deprecated: use new SystemHandler() and addDefaultSystemHandlers() instead.

Creates a new instance that delegates calls via the specified XmlRpcHandlerMapping. This method will add the system.multicall handler when a non-null handlerMapping is specified. The value itself is ignored.

SystemHandler

protected SystemHandler(XmlRpcServer server)

Deprecated: use new SystemHandler() and addDefaultSystemHandlers() instead.

Creates a new instance that delegates its multicalls via the mapping used by the specified XmlRpcServer. This method will add the default handlers when the specfied server's getHandlerMapping() returns a non-null handler mapping.

Parameters: server The server to retrieve the XmlRpcHandlerMapping from.

Method Detail

addDefaultSystemHandlers

public void addDefaultSystemHandlers()

Add the default system handlers. The default system handlers are:

system.multicall: Make multiple XML-RPC calls in one request and receive multiple responses.