SOAP-Methoden implementieren implementing-soap-methods
Einleitung introduction
Es ist möglich, SOAP-Methoden in JavaScript zu erstellen. Diese Funktion ermöglicht einfach anwendungsbezogene Prozesse. Sie kann die Entwicklung von JSPs und deren Aufruf in den Formularen vermeiden.
Diese SOAP-Methoden verhalten sich genauso wie die nativ in der Anwendung definierten Methoden. Es werden dieselben Attribute unterstützt: "Statisch", "Nur Schlüssel"und "const".
Definieren einer Methodenbibliothek defining-a-method-library
Das Erstellen einer Methodenbibliothek umfasst zwei Phasen:
- die SOAP-Methodendeklaration,
- Definition (oder Implementierung) in JavaScript.
Erklärung declaration
Deklarieren Sie zunächst die Methoden in den Schemas (weitere Informationen zum Erstellen und Bearbeiten von Schemas finden Sie unter diesem Abschnitt).
Ihre Deklaration ähnelt der nativen Methoden, allerdings müssen Sie das Attribut "library"hinzufügen, das den Namen der Methodenbibliothek angibt, in der sich die Definition befindet.
Dieser Name entspricht dem Namen (mit dem Namespace) der Entität vom Typ "JavaScript-Code".
Beispiel:
Die Methode testLog(msg) wird in der Erweiterung nms:recipient deklariert
<method name="testLog" static="true" library="cus:test">
<parameters>
<param name="message" type="string" inout="in"/>
</parameters>
</method>
Definition definition
SOAP-Methoden werden in Form von JavaScript-Funktionen implementiert, die in einem Skript gruppiert sind, das eine Bibliothek darstellt.
Das Skript kann Code enthalten, der beim ersten Laden der Bibliothek ausgeführt werden soll.
1. Name
Der Name der Funktion muss dem folgenden Format entsprechen:
<schema-namespace>_<schema-name>_<method-name>
Beispiel:
Die folgende JavaScript-Funktion ist die Implementierung der oben beschriebenen Methode. Sie wird in der Entität vom Typ "JavaScript-Code"unter Verwendung des Namens "cus:test"definiert.
function nms_recipient_testLog(message)
{
logInfo("*** " + message)
}
2. Unterschrift
Die Signatur der Funktion muss ein -Argument für jeden "in"- oder "inout"-Parameter der Deklaration enthalten.
Sonderfälle:
- nicht statische Methoden: Die Funktion muss zunächst ein zusätzliches -Argument enthalten, das mit der XML-Entität übereinstimmt, die in Form eines Objekts vom Typ "xml"(E4X) übergeben wurde.
- Methoden vom Typ "Nur Schlüssel": Die Funktion muss zuerst ein zusätzliches -Argument enthalten, das mit dem in Form von Zeichenfolgen übergebenen Schlüssel übereinstimmt.
3. Zurückgegebene Werte
Die Funktion muss für jeden Parameter vom Typ 'out' oder 'inout' einen Wert zurückgeben. Sonderfall: Wenn die Methode ohne die Attribute "static", "key only"oder "const"deklariert wird, muss der erste zurückgegebene Wert mit der geänderten Entität übereinstimmen. Es ist möglich, ein neues Objekt zurückzugeben oder den ersten geänderten Parameter zurückzugeben.
Beispiel:
function nms_recipient_setLastName(self, name)
{
self.@lastName = name
return self
}
Wenn mehrere Werte zurückgegeben werden sollen, müssen sie in einer Tabelle angezeigt werden.
Beispiel:
function nms_recipient_getKey(self)
{
return [self.@firstName, self.@lastName]
}