Use Case: Implement a SOAP Web Service

Input

You have:

• a WSDL file myService.wsdl stored in a local filesystem with all dependencies;
• a function named myMethod (/*...*/) that calculates:
  • normally, a single property object {MyMethodResponse: {...}}, where MyMethodResponse is a local name of the element representing the corresponding message type;
  • otherwise, an Error is thrown.

Problem

Send the HTTP response rp representing the obtained result as a SOAP message.

Basic Solution

const {XMLSchemata, SOAP11, SOAP12, SOAPFault} = require ('xml-toolkit')

const SOAP = SOAP11 // or SOAP12

const xs = new XMLSchemata (`myService.wsdl`)

let body, statusCode; try {  
  body = xs.stringify (myMethod (/*...*/))
  statusCode = 200
}
catch (x) {
  body = new SOAPFault (x)
  statusCode = 500
}

rp.writeHead (statusCode, {
  'Content-Type': SOAP.contentType,
})

rp.end (SOAP.message (body))

Q&A

How to set the SOAP Header?

Provide its literal XML as the 2nd argument to SOAP.message

rp.end (SOAP.message (body, header))

To add an empty Header element, use the zero length string ('').

For missing or null 2nd argument, SOAP Header is omitted.