gSoap: How to add info to SOAP Header using gSOAP
There's some misleading info in gSOAP's official documents in SOAP Header Processing Part.
This article leads you to the right way and can make your program work.
The use case is:
Client needs to pass user name and password to Server Side to get authenticated.
The username and password info should be embeded in SOAP Header.
Steps:
1. Edit struct SOAP_ENV__Header in soapStub.h file which is generated by gSOAP's soapcpp2 compiler
Add the neccesary info to this struct
For example:
The original one is:
struct SOAP_ENV__Header
{
public:
void *dummy; /* transient */
};
This should be changed to:
struct SOAP_ENV__Header
{
public:
void *dummy; /* transient */
char *username;
char *password;
};
2. Edit function soap_out_SOAP_ENV__Header in soapC.cpp file which is also generated by gSOAP
Add statements to serialize those info into SOAP Header.
For example:
The original one is:
SOAP_FMAC3 int SOAP_FMAC4 soap_out_SOAP_ENV__Header(struct soap *soap, const char *tag, int id, const struct SOAP_ENV__Header *a, const char *type)
{
soap_element_begin_out(soap, tag, soap_embedded_id(soap, id, a, SOAP_TYPE_SOAP_ENV__Header), type);
/* transient dummy skipped */
soap_element_end_out(soap, tag);
return SOAP_OK;
}
This could be changed to:
SOAP_FMAC3 int SOAP_FMAC4 soap_out_SOAP_ENV__Header(struct soap *soap, const char *tag, int id, const struct SOAP_ENV__Header *a, const char *type)
{
soap_element_begin_out(soap, tag, soap_embedded_id(soap, id, a, SOAP_TYPE_SOAP_ENV__Header), type);
/* transient dummy skipped */
soap_out_string(soap, "headerNS:username", 1, &(a->username), "");
soap_out_string(soap, "headerNS:password", 2, &(a->password), "");
soap_element_end_out(soap, tag);
return SOAP_OK;
}
struct soap soap;
soap_init(&soap);
...
soap->header = (SOAP_ENV__Header *)soap_malloc(soap, sizeof(SOAP_ENV__Header));
soap->header->username = (char*)malloc(MAX_NAME_SIZE * sizeof(char));
soap->header->password = (char*)malloc(MAX_NAME_SIZE * sizeof(char));
strcpy(soap->header->username, username);
strcpy(soap->header->password, passwd);
soap_call_method(&soap, ...); //the SOAP Header will be in the request
...
5. Compile
6. Run.
The SOAP Message could be
...
<SOAP-ENV:Envelope xmlns:headerNS="http://customeheader.vpamws.com">
<SOAP-ENV:Header>
<headerNS:username>admin</headerNS:username>
<headerNS:password>default</headerNS:password>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
...
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Any Questions, Please let me know. Thanks.
-Debora