11.21.1 SimpleXMLRPCServer Objects
Keywords: lib

##
11.21.1 SimpleXMLRPCServer Objects

The `SimpleXMLRPCServer` class provides two methods that an application can use to register functions that can be called via the XML-RPC protocol via the request handler.

`register_function`(function[, name])
  Register a function that can respond to XML-RPC requests. The function must be callable with a single parameter which will be the return value of ``xmlrpclib`.loads()` when called with the payload of the request. If name is given, it will be the method name associated with function, otherwise `function.__name__` will be used. name can be either a normal or Unicode string, and may contain characters not legal in Python identifiers, including the period character.

`register_instance`(instance)
  Register an object which is used to expose method names which have not been registered using `register_function()`. If instance contains a `_dispatch()` method, it is called with the requested method name and the parameters from the request; the return value is returned to the client as the result. If instance does not have a `_dispatch()` method, it is searched for an attribute matching the name of the requested method; if the requested method name contains periods, each component of the method name is searched for individually, with the effect that a simple hierarchical search is performed. The value found from this search is then called with the parameters from the request, and the return value is passed back to the client.