Skip to main content
Version: 2.17.x.x LTS

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

NameType, usage constraints, defaultsDescription
endpointrequired: paraVal
default: none
type: URL of the endpoint
The URL which is used to publish the service.
threadsoptional: paraVal
default: 10
type: integer
The number of threads the HTTP server uses to handle client requests.
sslSettingsoptional: 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.
raiseFaultoptional: 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>