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
DefaultHandlerMappingsystemMapping
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
voidaddDefaultSystemHandlers()
Add the default system handlers.
voidaddSystemHandler(String handlerName, ContextXmlRpcHandler handler)
Objectexecute(String method, Vector params, XmlRpcContext context)
Execute a <ignored>.<name> call by calling the handler for <name> in the the system handler mapping.
voidremoveSystemHandler(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.

addSystemHandler

public void addSystemHandler(String handlerName, ContextXmlRpcHandler handler)

See Also: DefaultHandlerMapping

execute

public 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.

removeSystemHandler

public void removeSystemHandler(String handlerName)

See Also: removeHandler

Copyright B) 1999-2002 Apache Software Foundation. All Rights Reserved.