In Camunda Connect a Connectors class exists which automatically detects every connector in the classpath. It can be used to get the SOAP connector instance by its connector ID, which is soap-http-connector.

SoapHttpConnector soap = Connectors.getConnector(SoapHttpConnector.ID);

The SOAP connector extends the Camunda Connect HTTP connector which uses the Apache HTTP client in the default implementation. To read about default and custom client configuration, please see the corresponding section in the HTTP connector docs.

Request

Creating a Request

The SOAP HTTP connector can be used to create a new request, set a URL, content type and payload.

connector.createRequest()
  .url("http://camunda.org/soap")
  .soapAction("doIt")
  .contentType("application/soap+xml")
  .payload(soap_envelope)
  .execute();

Adding HTTP Headers to a Request

To add own headers to the HTTP request the method header is available.

connector.createRequest()
  .url("http://camunda.org/soap")
  .soapAction("doIt")
  .contentType("application/soap+xml")
  .header("Accept", "application/xml")
  .payload(soap_envelope)
  .execute();

Using the Generic API

Besides the configuration methods also a generic API exists to set parameters of a request. The following parameters are available:

This can be used as follows:

HttpRequest request = http.createRequest();
request.setRequestParameter("method", "GET");
request.setRequestParameter("url", "http://camunda.org");
request.setRequestParameter("payload", "hello world!");

Response

A response contains the status code, response headers and body.

Integer statusCode = response.getStatusCode();
String contentTypeHeader = response.getHeader("Content-Type");
String body = response.getResponse();

After the response was processed it should be closed.

response.close()

Using the Generic API

Besides the response methods a generic API is provided to gather the response parameters. The following parameters are available:

This can be used as follows:

response.getResponseParameter("statusCode");
response.getResponseParameter("headers");
response.getResponseParameter("response");