SOAP-methoden implementeren implementing-soap-methods
Inleiding introduction
U kunt SOAP-methoden maken in JavaScript. Deze functie laat eenvoudig toepassingsprocessen toe, kan het het ontwikkelen van JSPs en hun het roepen in de vormen vermijden.
Deze SOAP-methoden gedragen zich op dezelfde manier als de methoden die native in de toepassing worden gedefinieerd. Dezelfde kenmerken worden ondersteund: statisch, alleen-toets en const.
Een methodebibliotheek definiëren defining-a-method-library
Het maken van een methodebibliotheek bestaat uit twee fasen:
- de SOAP-methodedeclaratie,
- Definitie (of implementatie) in JavaScript.
Verklaring declaration
Begin door de methodes in de schema's te verklaren (voor meer op om schema's tot stand te brengen en uit te geven, verwijs naar deze sectie).
Hun verklaring is gelijkaardig aan die van inheemse methodes, behalve dat moet u het attribuut "bibliotheek"toevoegen die de naam van de methodebibliotheek specificeren waar de definitie wordt gevestigd.
Deze naam valt samen met de naam (met de naamruimte) van de entiteit van het type 'JavaScript Code'.
Voorbeeld:
De methode testLog(msg) wordt gedeclareerd in een extensie nms:ontvanger
<method name="testLog" static="true" library="cus:test">
<parameters>
<param name="message" type="string" inout="in"/>
</parameters>
</method>
Definitie definition
SOAP-methoden worden geïmplementeerd in de vorm van een JavaScript-functie gegroepeerd in een script dat een bibliotheek vertegenwoordigt.
Het script kan code bevatten die moet worden uitgevoerd tijdens het laden van de eerste bibliotheek.
1. Naam
De naam van de functie moet de volgende indeling hebben:
<schema-namespace>_<schema-name>_<method-name>
Voorbeeld:
De volgende JavaScript-functie is de implementatie van de hierboven beschreven methode. Deze wordt gedefinieerd in de entiteit van het type JavaScript Code met de naam 'cus:test'.
function nms_recipient_testLog(message)
{
logInfo("*** " + message)
}
2. Handtekening
De handtekening van de functie moet een argument bevatten voor elke parameter 'in' of 'inout' van de declaratie.
Specifieke gevallen:
- niet-statische methoden: de functie moet eerst een extra argument bevatten, dat samenvalt met de XML-entiteit die wordt doorgegeven in de vorm van een object van het type 'xml' (E4X).
- Methoden van het type "key only": de functie moet eerst een aanvullend argument bevatten, dat samenvalt met de sleutel die wordt doorgegeven in de vorm van tekenreeksen.
3. Geretourneerde waarden
De functie moet een waarde retourneren voor elke parameter van het type 'out' of 'inout'. Specifiek geval: als de methode wordt gedeclareerd zonder de kenmerken 'static', 'key only' of 'const', moet de eerste geretourneerde waarde overeenkomen met de gewijzigde entiteit. Het is mogelijk om een nieuw object te retourneren of de eerste gewijzigde parameter te retourneren.
Bijvoorbeeld:
function nms_recipient_setLastName(self, name)
{
self.@lastName = name
return self
}
Wanneer meerdere waarden moeten worden geretourneerd, moeten deze in een tabel worden weergegeven.
Voorbeeld:
function nms_recipient_getKey(self)
{
return [self.@firstName, self.@lastName]
}