实施SOAP方法 implementing-soap-methods

简介 introduction

可以在JavaScript中创建SOAP方法。 该功能简单实现了应用过程,避免了开发JSP和表单中对JSP的调用。

这些SOAP方法的行为方式与应用程序中本机定义的方法相同。 支持相同的属性:静态、仅键和常量。

定义方法库 defining-a-method-library

创建方法库涉及两个阶段:

  • SOAP方法声明,
  • JavaScript中的定义(或实现)。

声明 declaration

首先,声明架构中的方法(有关如何创建和编辑架构的详细信息,请参阅此部分)。

它们的声明与本机方法的声明类似,不同之处在于,您需要添加“library”属性来指定定义所在的方法库的名称。

此名称与“JavaScript代码”类型实体的名称(以及命名空间)一致。

例如:

testLog(msg)方法在nms:recipient扩展中声明

<method name="testLog" static="true" library="cus:test">
     <parameters>
       <param name="message" type="string" inout="in"/>
     </parameters>
   </method>
NOTE
用于库的命名空间和名称与发现声明的命名空间和架构名称无关。

条件 definition

SOAP方法以分组到表示库的脚本中的JavaScript函数的形式实现。

NOTE
方法库可以为各种架构对函数进行分组,反之亦然,一个架构的函数可以在单独的库中定义。

脚本可以包含在初始库加载期间要执行的代码。

1. 名称

函数的名称必须符合以下格式:

 <schema-namespace>_<schema-name>_<method-name>

例如:

以下JavaScript函数是上述方法的实现。 应使用"cus:test"名称在"JavaScript Code"类型实体中定义。

function nms_recipient_testLog(message)
 {
   logInfo("*** " + message)
 }

2。 签名

函数的签名必须为声明的每个“in”或“inout”参数包含一个参数。

具体案例:

  • 非静态方法:函数必须首先包含一个附加参数,这与以“xml”(E4X)类型对象的形式传递的XML实体一致。
  • “仅键”类型方法:函数必须首先包含一个附加参数,该参数应与以字符串形式传递的键一致。

3。 返回的值

该函数必须为每个“out”或“inout”类型参数返回一个值。 特定案例:如果在声明方法时未使用任何“static”、“key only”或“const”属性,则第一个返回值必须与修改的实体一致。 可以返回新对象或返回第一个修改的参数。

例如:

function nms_recipient_setLastName(self, name)
 {
   self.@lastName = name
   return self
 }

要返回多个值时,必须在表中显示它们。

例如:

function nms_recipient_getKey(self)
 {
   return [self.@firstName, self.@lastName]
 }
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1