Send-mediators worden veelvuldig gebruikt in mediation-sequences in de WSO2 ESB. Zonder Send-mediator gebeurt er natuurlijk weinig, in de IN sequence (de Send-mediator stuurt het bericht naar het endpoint dat je hebt gedefinieerd) noch in de OUT sequence (de Send-mediator stuurt het bericht terug naar de client).
Tijd om eens te kijken naar deze mediator die we vaak gebruiken, maar waar we misschien weinig van weten. Aan het einde van de blog kijken we ook naar andere mediators die gerelateerd zijn aan de Send-mediator, zoals Call, Respond en Drop.

Hoe werkt de Send-mediator?
In zijn eenvoudigste vorm stuurt deze het bericht naar het gedefinieerde endpoint. Dit endpoint kan inline (hardcoded) worden gedefinieerd, een vooraf gedefinieerd endpoint zijn (met naam of in een register), of kan worden afgeleid van een XPATH-expressie. Als er geen endpoint is gedefinieerd, probeert de Send het bericht naar de TO-header te sturen.
Als de Send-mediator zich in de OUT sequence bevindt, wordt het bericht simpelweg naar de client gestuurd als er geen endpoint is gedefinieerd. Het definiëren van een endpoint in de Send-mediator in de OUT sequence stuurt het naar dat endpoint.
De syntax van de Send-mediator is vrij eenvoudig:
<send/>
Als er een endpoint in de Send is opgenomen, ziet de syntax er zo uit:
<send></send> |
Welke parameters mogelijk zijn, zien we iets later. De syntax lijkt eenvoudig, maar er kan meer dan je denkt.
Het Endpoint in de Send-mediator kan zijn:
- Leeg (zie de vorige paragraaf voor de flow)
- Inline gedefinieerd (hardcoded in de send-mediator)
- Opgehaald uit het register of een ander benoemd endpoint
- XPath-statement
Volgens de documentatie kun je een bericht ook naar meerdere endpoints sturen.
Een voorbeeld van een Send-mediator met een inline gedefinieerd endpoint
<send>
<endpoint>
<address uri="http://localhost:9764/services/ADeployedService"/>
</endpoint>
</send>
Een voorbeeld met zowel een gedefinieerd Endpoint als een benoemde OUT sequence
<send receive="ProvideDataSeq">
<endpoint key="PersonDataEpr"/>
</send>
Wil je met meerdere endpoints werken, dan definieer je ze in een recipientlist. Voor meer informatie is er een Enterprise Integration Pattern (EIP) voorbeeld in de documentatie. Een recipientlist zou er ongeveer zo uitzien:
<inSequence>
<log/>
<send>
<endpoint name="1469526965038">
<recipientlist>
<endpoint>
<address trace="disable"
uri="http://localhost:9764/services/echo"/>
</endpoint>
<endpoint>
<address trace="disable"
uri="http://localhost:9765/services/echo"/>
</endpoint>
</recipientlist>
</endpoint>
</send>
</inSequence>
Een andere mogelijkheid is het definiëren van het type ontvangende Sequence voor de Send. Hiermee bedoelen we de OUT sequence (als er geen ontvangend endpoint is opgegeven, wordt het standaard endpoint in de proxy of API gebruikt), of een statisch (benoemde sequence), of zelfs een dynamisch endpoint. In het laatste geval moet een XPath-statement worden opgegeven.
De laatste parameter geeft aan of het bericht in het geheugen wordt opgebouwd voordat het wordt verstuurd. Als er logica moet plaatsvinden na de send, moet deze parameter op Yes worden ingesteld. Laat het anders op No staan, wat de prestaties verbetert.
De Send-mediator kan worden gedefinieerd met de UI van de WSO2 ESB, Developer Studio, of als een XML-fragment dat in een proxy of API wordt gekopieerd.
UI-configuratie

Het is belangrijk te beseffen dat de Send Mediator de huidige flow (IN of OUT) verlaat. Het plaatsen van mediators na Send werkt niet, aangezien ze nooit bereikt worden.
Call Mediator
De Call Mediator doet iets vergelijkbaars als de Send-mediator, maar blijft, in tegenstelling tot de Send-mediator, binnen de flow van de proxy of API. Dit maakt service chaining mogelijk, een aantal opeenvolgende aanroepen waarbij bijvoorbeeld resultaten van de ene aanroep naar de andere worden doorgegeven met behulp van ingestelde eigenschappen.
De syntax van de Call-mediator lijkt op de syntax van de Send-mediator
<call [blocking="true"]>
(endpointref | endpoint)+
</call>
In dit geval worden meerdere endpoints ondersteund, echter alleen in non-blocking-modus.

Figuur 1: voorbeeld uit de ESB fundamentals-training, waarin in de OUT sequence een andere dienst wordt aangeroepen
In theorie kun je service chaining ook op andere manieren doen, met de IN- en OUT-flows van een benoemde sequence, of zelfs met een constructie waarin in de OUT-flow van bijvoorbeeld een proxy een switch en nog een send worden gebruikt (de switch bepaalt of er nog een aanroep nodig is). Maar dat is verre van ideaal. Voor service chaining binnen WSO2 ESB gebruik je de Call-mediator.
Drop Mediator
Een andere content-onbewuste mediator die gerelateerd is aan de send-mediator is de Drop-mediator, die precies het tegenovergestelde doet van de Send-mediator: hij laat het bericht vallen. Als de Drop-mediator in de IN Sequence is geplaatst, geeft deze een 202 Accepted-respons aan de client. Als deze in de out sequence is geplaatst, geeft deze geen respons terug, maar laat het bericht simpelweg vallen.
De syntax hiervan is de eenvoudigste van allemaal: <drop/>
Respond Mediator
De Respond-mediator stuurt het bericht terug naar de client en stopt de huidige verwerking. Een van de toepassingen is samen met de Makefault-mediator, om een soap-bericht terug te geven aan de client dat er iets mis is met het bericht (bijv. de payload is niet correct of iets dergelijks).
In dit geval is de syntax ook eenvoudig: <respond/>
Loopback Mediator
Een van de minst bekende mediators is de loopback-mediator. Zoals je in de afbeelding hieronder ziet, zet de loopback-mediator de flow over naar de out sequence, waarbij de variabelen op axis2-scope behouden blijven.
De syntax is: <loopback/>
Wanneer gebruik je de loopback? Vooral als je de outsequence wilt gebruiken om de response naar de client op te maken.

In dit overzicht hebben we een aantal manieren bekeken om de flow binnen een proxy te sturen, zoals versturen naar verschillende endpoints of een benoemde outsequence aanroepen. Nu weet je dat je de flow kunt aanpassen, en dat kan in een van je eigen projecten goed van pas komen.
Heb je vragen over deze blogpost, neem dan contact met ons op via de reacties onder deze blog. Bekijk ook onze WSO2-tutorials, webinars of whitepapers voor meer technische informatie. Support nodig? Wij leveren WSO2 Product Support, WSO2 Development Support, WSO2 Operational Support en WSO2 Training Programs.
| WSO2TORIALS helpen je WSO2-producten aan te passen, bij te werken of te verbeteren, en zijn gebaseerd op onze ervaring met de producten. WSO2TORIALS nemen je stap voor stap mee, met zo min mogelijk voorkennis. | ![]() |

