xmlrpc钩子有两种形式。简单的形式，如例子remotehello.module中所展示的，它简单的将一个外部的方法名映射到一个函数上。在一个更高级的形式中，它描述了方法的方法签名；这里指的是,它返回的是什么XML-RPC类型，以及每一个参数的类型（参看http://www.xmlrpc.com/spec来查看类型列表）.下面是remotehello.module的升级版,xmlrpc钩子的形式更复杂一些:
function xmlrpclucky_xmlrpc() {
return array(
array(
'xmlrpclucky.guessLuckyNumber', // External method name.
'xmlrpclucky_lucky_number', // Drupal function to run.
array('string', 'int'), // Return value's type, then any parameter types
t('Returns a lucky number.') // Description.
)
);
}
图19-2显示了当一个请求从XML-RPC客户端到达我们的模块时XML-RPC的请求生命周期。如果你在你的模块中使用更复杂的形式来实现xmlrpc钩子，你将得到多个好处。首先，Drupal将根据方法签名自动验证发送过来的类型并返回 -32602：Server error。如果验证失败将标示出无效的方法参数。(这还意味着你的函数具有挑选能力.而不再进行类型转换了,如果是整数3,那么就不能当作字符串“3”使用了).如果你使用xmlrpc钩子的复杂形式, Drupal内置的XML-RPC方法system.methodSignature和system.methodHelp将返回你方法的相关信息.注意,你在你的xmlrpc钩子实现中提供的描述,将会在system.methodHelp方法中作为帮助信息返回,所以你需要写一个有用的描述.
图19-2 一个XML-RPC请求的处理流程图
老葛的Drupal培训班 Think in Drupal
