SOAP implementing-soap-methods

Introduktion introduction

Det går att skapa SOAP metoder i JavaScript. Den här funktionen aktiverar helt enkelt tillämpande processer och kan undvika att utveckla JSP:er och anrop till dem i formulären.

Dessa SOAP fungerar på samma sätt som de som definierats internt i programmet. Samma attribut stöds: static, key only och const.

Definiera ett metodbibliotek defining-a-method-library

När du skapar ett metodbibliotek ingår två faser:

Deklaration declaration

Börja med att deklarera metoderna i scheman (mer information om hur du skapar och redigerar scheman finns i det här avsnittet).

Deras deklaration liknar den för inbyggda metoder, förutom att du måste lägga till attributet 'library' som anger namnet på det metodbibliotek där definitionen finns.

Det här namnet sammanfaller med namnet (med namnutrymmet) för entiteten av typen JavaScript-kod.

Exempel:

Metoden testLog(msg) deklareras i tillägget nms:mottagare

<method name="testLog" static="true" library="cus:test">
     <parameters>
       <param name="message" type="string" inout="in"/>
     </parameters>
   </method>

Definition definition

SOAP implementeras i form av en JavaScript-funktion som grupperas i ett skript som representerar ett bibliotek.

Skriptet kan innehålla kod som ska köras under den initiala biblioteksinläsningen.

1. Namn

Namnet på funktionen måste vara i följande format:

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

Exempel:

Följande JavaScript-funktion är implementeringen av den metod som beskrivs ovan. Den ska definieras i typentiteten"JavaScript Code" med hjälp av namnet"cus:test".

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

2. Signatur

Funktionens signatur måste innehålla ett argument för varje in- eller inout-parameter i deklarationen.

Specialfall:

3. Returnerade värden:

Funktionen måste returnera ett värde för varje parameter av typen"out" eller"inout". Specialfall: Om metoden deklareras utan något av attributen"static","key only" eller"const" måste det första returnerade värdet sammanfalla med den ändrade entiteten. Du kan returnera ett nytt objekt eller returnera den första ändrade parametern.

Exempel:

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

När flera värden ska returneras måste de visas i en tabell.

Exempel:

function nms_recipient_getKey(self)
 {
   return [self.@firstName, self.@lastName]
 }