第十二章：互联网-xmlrpc.server:一个XML-RPC服务器-候选API名

12.11.2 候选API名
有时，模块或库中使用的函数名并不是外部API中要使用的名。函数名之所以有变化，可能是因为加载了一个平台特定的实现，或者要根据一个配置文件动态地构建服务API，也可能实际函数要用桩函数替换来完成测试。要注册一个有候选名的函数，需要将这个名作为第二个参数传递到register_function()。

from xmlrpc.server import SimpleXMLRPCServer
import os

server = SimpleXMLRPCServer(('localhost',9000))

def list_contents(dir_name):
    "Expose a function with an alternate name"
    return os.listdir(dir_name)

server.register_function(list_contents,'dir')

try:
    print('Use Control-C to exit')
    server.serve_forever()
except KeyboardInterrupt:
    print('Exiting')

客户现在应当使用dir()而不是list_contents()。

import xmlrpc.client

proxy = xmlrpc.client.ServerProxy('http://localhost:9000')
print('dir():',proxy.dir('/tmp'))
try:
    print('\nlist_contents():',proxy.list_contents('/tmp'))
except xmlrpc.client.Fault as err:
    print('\nERROR:',err)

调用list_contents()会得到一个错误，因为服务器上不再有以这个名字注册的处理器。
运行结果：