gsoap内存管理与释放

（一）gSoap客户端调用WebService完成后注意内存释放顺序

 //Soap资源清理
 soap_destroy(soap_sp.get()); //清理反序列化的类实例
 soap_end(soap_sp.get());    //清理反序列化的数据 （除类实例） 和临时数据清理
 soap_done(soap_sp.get());    //重置和分离上下文： 关闭网络连接和删除回调

释放顺序不能错,否则导致内存泄露

（二）gsoap内存管理

gsoap分配的内存在内部有一个链表维护,在调用soap_destroy时会释放所有手动分配的内存,因此你无需释放内存,只需要检查soap_malloc成功与否就可以了.
如果你只用soap_malloc分配内存,并且发生了内存泄露且值是一个比较大的值时,请检查你使用soap_malloc分配的内存使用时是否越界.如发生越界行为,将无法释放soap.

 /*************************************************************************************
 * 内存分配函数
 */
 //分配指定大小的内存
 void * soap_malloc(struct soap *soap, size_t n)
 //复制字符串
 char * soap_strdup(struct soap *soap, const char *s)
 //复制宽字节字符串
 char * soap_wstrdup(struct soap *soap, const wchar_t *s)
 //创建一个soap对象,并使用默认值初始化.仅C++,C不适用
 T * soap_new_T(struct soap *soap)
 //创建指定大小soap对象数组,并使用默认值初始化.n=-1时只创建一个soap对象,仅C++,C不适用
 T * soap_new_T(struct soap *soap, int n)
 //其它不常用就不写了
 /*************************************************************************************/

 /*************************************************************************************
 * 释放资源函数
 */
 //删除所有上下文管理的对象,实际上就是删除soap_malloc分配的内存资源.必须在soap_end之前调用,适用于C和C++
 void soap_destroy(struct soap *soap)
 //清理反序列化的数据和临时数据(不包含上下文管理的对象),适用于C和C++
 void soap_end(struct soap *soap)
 //删除临时数据但保持反序列化的数据不变,适用于C和C++,不常用
 void soap_free_temp(struct soap *soap)
 //提前释放你用内存分配函数(如soap_malloc)分配的内存,适用于C和C++.你不释放也没关系,调用soap_destroy时也会释放
 void soap_dealloc(struct soap *soap, void *p)
 //从gsoap上下文管理对象断开p对象,此时p对象必须由你手动调用free释放,适用于C和C++.
 int soap_unlink(struct soap *soap, const void *p)
 //完成上下文, 但不删除任何托管对象或数据
 void soap_done(struct soap *soap)
 //最后确定并释放上下文 (使用 soap _ new 或 soap _ copy 分配的上下文), 但不删除任何托管对象或数据。
 void soap_free(struct soap *soap)
 /*************************************************************************************/

释放内存正确的姿势

 //soap需要复用时的清理方法
 #define SE_soap_clear(soap_) do {\
     if(NULL!=soap_){\
         soap_destroy(soap_);\
         soap_end(soap_);\
     }\
 } while ();
 //完全释放soap
 #define SE_SAFE_SOAP(soap)\
  do {\
     if(NULL !=soap) { \
         soap_destroy(soap);\
         soap_end(soap);\
         soap_done(soap);\
         soap_free(soap);\
         soap= NULL; \
     } \
 } while ()

 struct soap *ctx = NULL;
 char *ptr = NULL;

 ctx = soap_new1(SOAP_C_UTFSTRING);
 //提前释放ptr
 ptr = soap_malloc(ctx, );
 if(NULL != ptr){
   soap_dealloc(ctx, ptr);ptr = NULL;
 }
 //分离ptr
 ptr = soap_malloc(ctx, );
 if(NULL != ptr){
   soap_unlink(ctx, ptr);
   //此时需要手动释放ptr
   free(ptr);ptr=NULL;
 }
 //调用soap_destroy时释放
 ptr = soap_malloc(ctx, );
 //如果你的ctx需要复用,调用
 SE_soap_clear(ctx)
 //否则调用
 SE_SAFE_SOAP(ctx);
 --------------------- 

转自：https://blog.csdn.net/kmblack1/article/details/84341987

（三）内存管理

C/C++最大的麻烦，也是最大的优点是它要求用户自己管理内存。我们在实现web service方式时，同样需要考虑内存的分配与释放。

分配内存有两类：

• 分配n个字节，采用

void*soap_malloc(struct soap *soap, size_tn)

• 分配某个类，采用

Class*soap_new_Class(struct soap*soap)   一个类

Class*soap_new_Class(struct soap *soap, intn)    n个类

这里的类是通讯xml中定义的元素，在response构造时，必然要创建若干此类元素。为简化类的创建，可定义如下宏：

#defineNEW_ELEMENT(classtype)     soap_new_##classtype(GetSoapStruct(),-1)

#defineNEW_ELEMENT_X(classtype,n) soap_new_##classtype(GetSoapStruct(),n)

其中 GetSoapSturct()是返回继承的或包含的structsoap结构，对继承方式的代码，它的定义如下：

struct soap *GetSoapStruct() { return(struct soap*)this; }

在我们的Web方法实现中，可以随意使用上面的new方法，在每次web方法完结后，调用soap_destroy(structsoap *soap) ，它会为我们清除掉这部分内存。

gsoap中有若干释放内存的方法，几个有用的函数（还有其它的，忽略）及其说明如下：

Function Call	Description
soap_destroy(struct soap *soap)	释放所有动态分配的C++类，必须在soap_end()之前调用。
soap_end(struct soap *soap)	释放所有存储临时数据和反序列化数据中除类之外的空间（soap_malloc的数据也属于反序列化数据）。
soap_done(struct soap *soap)	Detach soap结构（即初始化化soap结构）
soap_free(struct soap *soap)	Detach 且释放soap结构

上表中，动态分配的C++类，指上面用"soap_new"分配的类；临时数据是指那些在序列化/反序列化过程中创建的例如hash表等用来帮助解析、跟踪xml的数据；反序列化数据是指在接收soap过程中产生的用malloc和new分配空间存储的数据。在gsoap中，纯数据空间与类空间管理不同，采用两个方法，可以保留soap的反序列化数据（这时你需要自己释放）。

转自：https://www.cnblogs.com/liushui-sky/p/9723397.html