digitalSTROM Server

h1. Modifying SOAP interface

> *NOTE:* this page is deprecated, as of version 1.4.0 the soap interface files are automatically generated through the build process.

The SOAP interface is defined by @webservices/model_soap.h@. From this header-file several other files are generated (everything except @model_soap.*@). After modifying @model_soap.h@ these files have to be regenerated by issuing:

<pre>soapcpp2 -SLx model_soap.h</pre>

or on Ubuntu:

<pre>soapcpp2 -I/usr/include/gsoap/ -SLx model_soap.h

</pre>

on Mac OS X:

<pre>soapcpp2 -I /opt/local/share/gsoap/import/ -SLx model_soap.h</pre>

After regenerating those file you need to apply the following patch:

<pre>

--- ./webservices/soapdssObject.h.gen	2011-10-13 13:34:06.985806729 +0200

+++ ./webservices/soapdssObject.h	2011-10-14 10:13:19.502578656 +0200

@@ -9,6 +9,9 @@

 #define soapdssObject_H

 #include "soapH.h"

+// soap_accept() timeout in seconds

+#define SOAP_ACCEPT_TIMEOUT 2

+

 /******************************************************************************\

  *                                                                            *

  * Service Object                                                             *

@@ -27,6 +30,8 @@

 	{"dss", "urn:dss:1.0", NULL, NULL},

 	{NULL, NULL, NULL, NULL}

 };

+	bind_flags = SO_REUSEADDR;

+	accept_timeout = SOAP_ACCEPT_TIMEOUT; // seconds

 	if (!this->namespaces) this->namespaces = namespaces; };

 	virtual ~dssService() { };

 	/// Bind service to port (returns master socket or SOAP_INVALID_SOCKET)

</pre>

Note, that as of version 0.7.7 the SOAP interface is using SSL, more information regarding the SSL setup is available [[How_to_build_the_dSS#Configuring|here]].