🐍 Python with Zeep

Zeep is the most modern and robust library for SOAP in Python.

Installation and Basic Usage

# Installation
pip install zeep

# Basic usage

from zeep import Client
import zeep

# Create client from WSDL
client = Client("https://example.com/service?wsdl")

# List available operations
print(client.service.__dict__.keys())

# Call operation
result = client.service.MyOperation(param1="abc", param2=123)
print(result)

Advanced Configurations

          from zeep import Client, Settings
from zeep.transports import Transport
from requests import Session
import ssl

# Configure custom HTTP session
session = Session()
session.verify = False  # For self-signed certificates
session.auth = ("username", "password")  # Basic authentication

# Configure transport
transport = Transport(session=session)

# Zeep settings
settings = Settings(strict=False, xml_huge_tree=True)

# Client with configurations
client = Client("https://example.com/service?wsdl", 
    transport=transport, 
    settings=settings)

# Operation with custom SOAP headers
header = {"Authentication": {"Token": "my-token"}}
result = client.service.MyOperation(
    param1="abc", 
    param2=123,
    _soapheaders=header
)

☕ Java with JAX-WS

JAX-WS is the Java standard for SOAP web services.

Class Generation

# Generate classes from WSDL
wsimport -keep -p com.example.ws https://example.com/service?wsdl

# Or using Maven
mvn jaxws:wsimport

Maven Configuration

<plugin>
  <groupId>org.codehaus.mojo</groupId>
  <artifactId>jaxws-maven-plugin</artifactId>
  <version>2.6</version>
  <executions>
    <execution>
      <goals>
        <goal>wsimport</goal>
      </goals>
      <configuration>
        <wsdlUrls>
          <wsdlUrl>https://example.com/service?wsdl</wsdlUrl>
        </wsdlUrls>
        <packageName>com.example.ws</packageName>
      </configuration>
    </execution>
  </executions>
</plugin>

Java Code

import com.example.ws.*;
import javax.xml.ws.BindingProvider;

public class SoapClient {
    public static void main(String[] args) {
      try {
        // Create service and port
        MyOperationService service = new MyOperationService();
        MyOperation port = service.getMyOperationPort();
      
        // Configure endpoint (optional)
        BindingProvider bp = (BindingProvider) port;
        bp.getRequestContext().put(
          BindingProvider.ENDPOINT_ADDRESS_PROPERTY,
          "https://example.com/service"
        );
      
        // Configure timeout
        bp.getRequestContext().put(
        "com.sun.xml.ws.connect.timeout", 30000);
        bp.getRequestContext().put("com.sun.xml.ws.request.timeout", 60000);
        
        // Call operation
        String result = port.myOperation("abc", 123);
        System.out.println("Result: " + result);
      
      } catch (Exception e) {
        e.printStackTrace();
      }
    }
}
      

🔷 .NET with WCF

Windows Communication Foundation is the .NET technology for web services.

Generation with dotnet-svcutil

# Install tool
dotnet tool install --global dotnet-svcutil

# Generate client
dotnet-svcutil https://example.com/service?wsdl --outputDir ./Generated

# Or using Visual Studio: Add Service Reference

C# Code

using System;
using System.ServiceModel;
using System.Threading.Tasks;

class Program 
{
    static async Task Main(string[] args)
    {
      // Configure binding
      var binding = new BasicHttpBinding();
      binding.Security.Mode = BasicHttpSecurityMode.Transport;
      binding.MaxReceivedMessageSize = 10000;
      
      // Configure endpoint
      var endpoint = new EndpointAddress("https://example.com/service");
      
      // Create client
      var client = new MyOperationClient(binding, endpoint);
      
      try 
      {
        // Configure timeout
        client.InnerChannel.OperationTimeout = TimeSpan.FromSeconds(30);
        
        // Call operation
        var request = new MyOperationRequest 
        {
          param1 = "abc",
          param2 = 123
        };
        
        var response = await client.MyOperationAsync(request);
        Console.WriteLine($"Result: {response.result}");
      }
      catch (Exception ex)
      {
        Console.WriteLine($"Error: {ex.Message}");
      }
      finally
      {
        if (client.State == CommunicationState.Opened)
        client.Close();
      }
    }
}
      

🟢 Node.js with node-soap

Popular library for consuming SOAP services in Node.js.

Installation and Usage

# Installation
npm install soap

// Basic usage
        

const soap = require("soap");

const url = "https://example.com/service?wsdl";

soap.createClient(url, (err, client) => {
  if (err) {
    console.error("Error creating client:", err);
    return;
  }
  
  // List available services
  console.log("Services:", Object.keys(client.describe()));
  
  // Call operation
  const args = {
    param1: "abc",
    param2: 123
  };
  
  client.MyOperation(args, (err, result) => {
    if (err) {
      console.error("Operation error:", err);
      return;
    }
    console.log("Result:", result);
  });
});

Version with Promises/Async

const soap = require("soap");
const { promisify } = require("util");

async function callSoap() {
  try {
    const client = await soap.createClientAsync(
      "https://example.com/service?wsdl"
    );
    
    // Configure headers if needed
    client.addSoapHeader({
      Authentication": {
      "Token": "my-token"
    }
    });
    
    // Configure basic security
    client.setSecurity(new soap.BasicAuthSecurity("user", "pass"));
    
    // Call operation
    const result = await client.MyOperationAsync({
      param1: "abc",
      param2: 123
    });
    
    console.log("Result:", result);
    
  } catch (error) {
    console.error("Error:", error);
  }
}

callSoap();
      

🐘 PHP with SoapClient

PHP has native SOAP support through the SoapClient class.

<?php
try {
    // Client configurations
    $options = [
      "trace" => true,
      "exceptions" => true,
      "cache_wsdl" => WSDL_CACHE_NONE,
      "connection_timeout" => 30,
      "user_agent" => "PHP SOAP Client",
      "stream_context" => stream_context_create([
        "http" => [
          "timeout" => 60,
          "user_agent" => "PHP SOAP Client"
        ],
        "ssl" => [
          "verify_peer" => false,
          "verify_peer_name" => false
        ]
      ])
    ];
    
    // Create client
    $client = new SoapClient("https://example.com/service?wsdl", $options);
    
    // List available functions
    print_r($client->__getFunctions());
    
    // Call operation
    $params = [
      "param1" => "abc",
      "param2" => 123
    ];
    
    $result = $client->MyOperation($params);
    
    echo "Result: " . print_r($result, true);
    
    // Debug: see sent/received XML
    echo "Request XML:\n" . $client->__getLastRequest() . "\n";
    echo "Response XML:\n" . $client->__getLastResponse() . "\n";
    
} catch (SoapFault $e) {
    echo "SOAP Error: " . $e->getMessage() . "\n";
    echo "Code: " . $e->getCode() . "\n";
} catch (Exception $e) {
    echo "General Error: " . $e->getMessage() . "\n";
}
?>
      

📨 Manual SOAP Request

Sometimes it's necessary to build the SOAP request manually.

HTTP Structure

POST /service HTTP/1.1
Host: example.com
Content-Type: text/xml; charset=utf-8
SOAPAction: "http://example.com/MyOperation"
Content-Length: [size]

<?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope 
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ex="http://example.com/schema">
  <soapenv:Header>
    <!-- Optional headers -->
  </soapenv:Header>
  <soapenv:Body>
    <ex:MyOperation>
    <ex:param1>abc</ex:param1>
    <ex:param2>123</ex:param2>
    </ex:MyOperation>
  </soapenv:Body>
</soapenv:Envelope>
        

With cURL

          curl -X POST \
  https://example.com/service \
  -H Content-Type: text/xml; charset=utf-8 \
  -H SOAPAction: "http://example.com/MyOperation" \
  -d <?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ex="http://example.com/schema">
  <soapenv:Body>
    <ex:MyOperation>
    <ex:param1>abc</ex:param1>
    <ex:param2>123</ex:param2>
    </ex:MyOperation>
  </soapenv:Body>
</soapenv:Envelope>
      

⚠️ Important Tips

🚀 Next Steps

Continue learning:

• Use the WSDL Viewer to analyze your services
• Explore advanced tools for development
• Practice with public SOAP services for testing