WsEventSource
The WsEventSource provides a SOAP web-service API to the event system. The SOAP service is published at a configured endpoint. The service offers the following operations which are used to signal an event:
- void signal(EventData event)
- JobResult synchronousSignal(EventData event) throws JobResult
The WSDL and XML schema needed to invoke the service can be found in the JAR nevisdp- wsclient.jar. It also contains Java client stubs to invoke the service.
Optional authentication is handled by means of two-way SSL.
Configuration
| Name | Type, usage constraints, defaults | Description |
|---|---|---|
| endpoint | required: paraVal default: none type: URL of the endpoint | The URL which is used to publish the service. |
| threads | optional: paraVal default: 10 type: integer | The number of threads the HTTP server uses to handle client requests. |
| sslSettings | optional: paraMap default: none type: string/string | The SSL configuration settings used for this HTTP server. It uses the Java system property names to set up the key and trust stores. No SSL is used by default. Two-way SSL is the only way to configure authentication. |
| raiseFault | optional: paraVal default: none type: boolean | Instead of returning JobResult on the synchronousSignal call, raise a SOAP fault if an error occurs. |
Example
Register a SOAP web-service at the URL http://localhost:1234/nevisdp/ws.
<eventSource name="wsEvents" type="WsEventSource">
<dp:paraVal name="endpoint" value="http://localhost:1234/nevisdp/ws" />
</eventSource>