用C实现WebService

副标题#e#

一、系统情况

Linux 操纵系统 kernel2.4.2，安装 gsoap2.6 到目次/usr/local/gsoap

二、gSOAP 的扼要利用例子

下面是一个简朴的例子，实现一个加法运算的 WebService，详细成果是客户端（client）输入 num1 和 num2，处事器端（server）返回 num1 和 num2 相加的功效 sum。
1、首先，我们需要做的是写一个函数声明文件，来界说接口函数 ns__add，文件名字为 add.h，内容如下：

//gsoap ns service name: add
//gsoap ns service namespace: http://mail.263.net/add.wsdl
//gsoap ns service location: http://mail.263.net
//gsoap ns service executable: add.cgi
//gsoap ns service encoding: encoded
//gsoap ns schema namespace: urn:add
int ns__add( int num1, int num2, int* sum );

2、然后我们需要建设文件 Makefile，从而操作 gsoapcpp2 东西由 add.h 生成一些 .xml 文件、.c 文件和 .h 文件，这些文件均为自动生成，Makefile的内容如下：

GSOAP_ROOT=/usr/local/gsoap
WSNAME=add
CC=g++ -g -DWITH_NONAMESPACES
INCLUDE=-I $(GSOAP_ROOT)
SERVER_OBJS=$(WSNAME)C.o $(WSNAME)Server.o stdsoap2.o
CLIENT_OBJS=$(GSOAP_ROOT)/env/envC.o $(WSNAME)ClientLib.o stdsoap2.o
ALL_OBJS=${WSNAME}server.o $(WSNAME)C.o $(WSNAME)Server.o ${WSNAME}test.o
${WSNAME}client.o $(WSNAME)ClientLib.o
#总的方针
all:server
${WSNAME}.wsdl:${WSNAME}.h
$(GSOAP_ROOT)/soapcpp2 -p$(WSNAME) -i -n -c ${WSNAME}.h
stdsoap2.o:$(GSOAP_ROOT)/stdsoap2.c
$(CC) -c $?
#编译一样生陈法则的.o文件
$(ALL_OBJS):%.o:%.c
$(CC) -c $? $(INCLUDE)
#编译处事器端
server:Makefile ${WSNAME}.wsdl ${WSNAME}server.o $(SERVER_OBJS)
$(CC) ${WSNAME}server.o $(SERVER_OBJS) -o ${WSNAME}server
#编译客户端
client:Makefile ${WSNAME}.wsdl ${WSNAME}client.c ${WSNAME}test.c $(ALL_OBJS) stdsoap2.o
$(CC) ${WSNAME}test.o ${WSNAME}client.o $(CLIENT_OBJS) -o ${WSNAME}test
cl:
rm -f *.o *.xml *.a *.wsdl *.nsmap $(WSNAME)H.h $(WSNAME)C.c $(WSNAME)Server.c $(WSNAME)Client.c
$(WSNAME)Stub.* $(WSNAME)$(WSNAME)Proxy.* $(WSNAME)$(WSNAME)Object.* $(WSNAME)ServerLib.c
$(WSNAME)ClientLib.c $(WSNAME)server ns.xsd $(WSNAME)test

3、我们先来做一个 server 端，建设文件 addserver.c 文件，内容如下：

#include "addH.h"
#include "add.nsmap"
int main(int argc, char **argv)
{
　　int m, s; /* master and slave sockets */
　　struct soap add_soap;
　　soap_init(&add_soap);
　　soap_set_namespaces(&add_soap, add_namespaces);
　　if (argc < 2)
　　{
　　　　printf("usage: %s\n", argv[0]);
　　　　exit(1);
　　}
　　else
　　{
　　　　m = soap_bind(&add_soap, NULL, atoi(argv[1]), 100);
　　　　if (m < 0)
　　　　{
　　　　　　soap_print_fault(&add_soap, stderr);
　　　　　　exit(-1);
　　　　}
　　　　fprintf(stderr, "Socket connection successful: master socket = %d\n", m);
　　　　for ( ; ; )
　　　　{
　　　　　　s = soap_accept(&add_soap);
　　　　　　if (s < 0)
　　　　　　{
　　　　　　　　soap_print_fault(&add_soap, stderr);
　　　　　　　　exit(-1);
　　　　　　}
　　　　　　fprintf(stderr, "Socket connection successful: slave socket = %d\n", s);
　　　　　　add_serve(&add_soap);//该句说明该server的处事
　　　　　　soap_end(&add_soap);
　　　　}
　　}
　　return 0;
}
//server端的实现函数与add.h中声明的函数沟通，可是多了一个当前的soap毗连的参数
int ns__add(struct soap *add_soap, int num1, int num2, int *sum)
{
　　*sum = num1 + num2;
　　return 0;
}　　　　

4、让我们的server跑起来吧：

shell>make
shell>./addserver 8888

假如终端打印出“Socket connection successful: master socket = 3”，那么你的 server 已经在前台 run 起来了，应该是值得兴奋的！打开IE，键入http://localhost:8888，显示XML，处事已…〕Socket connection successful: slave socket = 4”，暗示处事吸收到了一次soap的毗连。

#p#副标题#e#

5、让我们再来写个客户端（这个只是将soap的客户端函数封装一下，详细的挪用拜见下面的addtest.c），建设文件addclient.c，内容如下：

#include "addStub.h"
#include "add.nsmap"
/**
* 传入参数：server：server的地点
* num1,num2：需要相加的数
* 传出参数：sum：num1和num2相加的功效
* 返回值：0为乐成，其他为失败
*/
int add( const char* server, int num1, int num2, int *sum )
{
　　struct soap add_soap;
　　int result = 0;
　　soap_init(&add_soap);
　　soap_set_namespaces(&add_soap, add_namespaces);
　　
　　// 该函数是客户端挪用的主要函数，后头几个参数和add.h中声明的一样，前面多了3个参数，
　　// 函数名是接口函数名ns__add前面加上soap_call_
　　soap_call_ns__add( &add_soap, server, "", num1, num2, sum );
　　if(add_soap.error)
　　{
　　　　printf("soap error:%d,%s,%s\n",
　　　　　　　 add_soap.error,
　　　　　　　 *soap_faultcode(&add_soap),
　　　　　　　 *soap_faultstring(&add_soap) );
　　　　result = add_soap.error;
　　}
　　soap_end(&add_soap);
　　soap_done(&add_soap);
　　return result;
}

6、我们最终写一个可以运行的客户端挪用措施，建设文件addtest.c，内容如下：

#p#分页标题#e#

#include <stdio.h>
#include <stdlib.h>
int add(const char* server, int num1, int num2, int *sum);
int main(int argc, char **argv)
{
　　int result = -1;
　　char* server="http://localhost:8888";
　　int num1 = 0;
　　int num2 = 0;
　　int sum = 0;
　　if( argc < 3 )
　　{
　　　　printf("usage: %s num1 num2 \n", argv[0]);
　　　　exit(0);
　　}
　　
　　num1 = atoi(argv[1]);
　　num2 = atoi(argv[2]);
　　
　　result = add(server, num1, num2, &sum);
　　if (result != 0)
　　{
　　　　printf("soap err,errcode = %d\n", result);
　　}
　　else
　　{
　　　　printf("%d+%d=%d\n", num1, num2, sum );
　　}
　　return 0;
}

7、让我们的client端和server端通讯

shell>make client
shell>./addtest 7 8

虽然，你的server应该还在run，这样获得输出功效7+8=15，好了，你乐成完成了你的第一个C写的 WebService，恭喜。

三、要留意的问题

add.h文件前面的几句注释不能删除，为soapcpp2需要识此外符号；

接口函数的返回值只能是int，是soap挪用的功效，一般通过soap.error来判定soap的毗连环境，这个返回值没有用到；

接口函数的最后一个参数为传出参数，假如需要传出多个参数，需要本身界说一个布局将返回项封装；

在.h文件中不能include此外.h文件，大概不能生效，需要用到某些布局的时候需要在该文件中直接声明；

假如客户端的挪用不需要返回值，那么最后一个参数；