Axis2/C 基础入门
Axis2/C是一个用C语言实现的Web Service引擎。
Axis2/C基于Axis2架构，支持SOAP1.1和SOAP1.2协议，并且支持RESTful风格的Web Service。基于Axis2/C的Web Service可以同时暴露为SOAP和RESTful风格的服务。
最近研究了一下Axis2/C，这篇文章详述了如何利用Axis2/C发布一个Web Service，并通过SOAP访问这个Web Service。
一、Axis2/C的下载和安装
1、可以从Axis2/C的官方网站下载到最新的Axis2/C发布包：Axis2/C下载
2、解压axis2c-bin-1.6.0-win32.zip，并在系统的环境变量中添加AXIS2_HOME并指向Axis2/C的解压目录，这样可以确保后续编译过程中可以找到Axis2/C的依赖项；
3、在系统环境变量中找到Path项，编辑该项，在它的最开始加入C:\VS8\Common7\IDE，并以分号分隔，以此保证编译后的客户端程序可以顺利找到依赖项；
4、在Path的结尾添加%AXIS2_HOME%\lib，确保编译器可以找到Axis2/C的依赖项；
二、构建和发布服务
5、新建CPP文件，命名为：hello_svc.c，并加入如下代码：
#include "stdafx.h"#include <axis2_svc_skeleton.h>#include <axutil_log_default.h>#include <axutil_error_default.h>#include <axutil_array_list.h>#include <axiom_text.h>#include <axiom_node.h>#include <axiom_element.h>#include <stdio.h>axiom_node_t *axis2_hello_greet(const axutil_env_t *env, axiom_node_t *node);int AXIS2_CALL hello_free(axis2_svc_skeleton_t *svc_skeleton, const axutil_env_t *env);axiom_node_t* AXIS2_CALL hello_invoke(axis2_svc_skeleton_t *svc_skeleton, const axutil_env_t *env, axiom_node_t *node, axis2_msg_ctx_t *msg_ctx);int AXIS2_CALL hello_init(axis2_svc_skeleton_t *svc_skeleton, const axutil_env_t *env);axiom_node_t* AXIS2_CALL hello_on_fault(axis2_svc_skeleton_t *svc_skeli, const axutil_env_t *env, axiom_node_t *node);axiom_node_t *build_greeting_response(const axutil_env_t *env, axis2_char_t *greeting);axiom_node_t *axis2_hello_greet(const axutil_env_t *env, axiom_node_t *node){axiom_node_t *client_greeting_node = NULL;axiom_node_t *return_node = NULL;AXIS2_ENV_CHECK(env, NULL);if (node){client_greeting_node = axiom_node_get_first_child(node, env);if (client_greeting_node && axiom_node_get_node_type(client_greeting_node, env) == AXIOM_TEXT){axiom_text_t *greeting = (axiom_text_t *)axiom_node_get_data_element(client_greeting_node, env);if (greeting && axiom_text_get_value(greeting , env)){const axis2_char_t *greeting_str = axiom_text_get_value(greeting, env);printf("Client greeted saying \"%s\" \n", greeting_str);return_node = build_greeting_response(env, "Hello Client!");}}}else{AXIS2_ERROR_SET(env->error, AXIS2_ERROR_SVC_SKEL_INVALID_XML_FORMAT_IN_REQUEST, AXIS2_FAILURE);printf("ERROR: invalid XML in request\n");return_node = build_greeting_response(env, "Client! Who are you?");}return return_node;}axiom_node_t *build_greeting_response(const axutil_env_t *env, axis2_char_t *greeting){axiom_node_t* greeting_om_node = NULL;axiom_element_t * greeting_om_ele = NULL;greeting_om_ele = axiom_element_create(env, NULL, "greetResponse", NULL, &greeting_om_node);axiom_element_set_text(greeting_om_ele, env, greeting, greeting_om_node);return greeting_om_node;}static const axis2_svc_skeleton_ops_t hello_svc_skeleton_ops_var = {hello_init,hello_invoke,hello_on_fault,hello_free};axis2_svc_skeleton_t *axis2_hello_create(const axutil_env_t *env){axis2_svc_skeleton_t *svc_skeleton = NULL;svc_skeleton = (axis2_svc_skeleton_t *) AXIS2_MALLOC(env->allocator, sizeof(axis2_svc_skeleton_t));svc_skeleton->ops = &hello_svc_skeleton_ops_var;svc_skeleton->func_array = NULL;return svc_skeleton;}int AXIS2_CALL hello_init(axis2_svc_skeleton_t *svc_skeleton, const axutil_env_t *env){svc_skeleton->func_array = axutil_array_list_create(env, 0);axutil_array_list_add(svc_skeleton->func_array, env, "helloString");return AXIS2_SUCCESS;}axiom_node_t* AXIS2_CALL hello_invoke(axis2_svc_skeleton_t *svc_skeleton, const axutil_env_t *env, axiom_node_t *node, axis2_msg_ctx_t *msg_ctx){return axis2_hello_greet(env, node);}axiom_node_t* AXIS2_CALL hello_on_fault(axis2_svc_skeleton_t *svc_skeli, const axutil_env_t *env, axiom_node_t *node){axiom_node_t *error_node = NULL;axiom_node_t* text_node = NULL;axiom_element_t *error_ele = NULL;error_ele = axiom_element_create(env, node, "EchoServiceError", NULL,&error_node);axiom_element_set_text(error_ele, env, "Echo service failed ",text_node);return error_node;}int AXIS2_CALL hello_free(axis2_svc_skeleton_t *svc_skeleton, const axutil_env_t *env){if (svc_skeleton->func_array){axutil_array_list_free(svc_skeleton->func_array, env);svc_skeleton->func_array = NULL;}if (svc_skeleton){AXIS2_FREE(env->allocator, svc_skeleton);svc_skeleton = NULL;}return AXIS2_SUCCESS;}AXIS2_EXPORT int axis2_get_instance(axis2_svc_skeleton_t **inst, const axutil_env_t *env){*inst = axis2_hello_create(env);if (!(*inst)){return AXIS2_FAILURE;}return AXIS2_SUCCESS;}AXIS2_EXPORT int axis2_remove_instance(axis2_svc_skeleton_t *inst, const axutil_env_t *env){axis2_status_t status = AXIS2_FAILURE;if (inst){status = AXIS2_SVC_SKELETON_FREE(inst, env);}return status;}
6、编译上述代码，在命令行运行如下编译命令：
$ C:\VS8\VC\bin\cl.exe /D "WIN32" /D "_WINDOWS" /D "_MBCS" /D "AXIS2_DECLARE_EXPORT" /D "AXIS2_SVR_MULTI_THREADED" /w /nologo /I E:\\mengli\\axis2c-bin-1.6.0-win32\\include /I C:\\VS8\\VC\\include /c hello_svc.c
7、链接生成的中间对象，并产生DLL，运行命令如下：
$ C:\VS8\VC\bin\link.exe /nologo /LIBPATH:E:\\mengli\\axis2c-bin-1.6.0-win32\\lib /LIBPATH:C:\\VS8\\VC\\lib axutil.lib axiom.lib axis2_parser.lib axis2_engine.lib /DLL /OUT:hello.dll *.obj
8、在%AXIS2_HOME%\services下创建目录hello，将步骤7产生的hello.dll拷贝到其中，并创建服务描述文件services.xml，并插入如下内容：
<?xml version="1.0" encoding="utf-8"?><service name="hello"><parameter name="ServiceClass" locked="xsd:false">hello</parameter><description> Quick start guide hello service sample.</description><operation name="greet"><parameter name="wsamapping">http://ws.apache.org/axis2/c/samples/hello</parameter></operation></service>
9、启动Axis2服务器，执行如下命令：
$ axis2_http_server
三、访问服务
10、在VS中创建项目Axis2Test，并在Axis2Test.cpp中插入这些代码：
#include "stdafx.h"#include <stdio.h>#include <axiom.h>#include <axis2_util.h>#include <axiom_soap.h>#include <axis2_client.h>axiom_node_t *build_om_request(const axutil_env_t *env);const axis2_char_t *process_om_response(const axutil_env_t *env, axiom_node_t *node);int _tmain(int argc, char** argv){const axutil_env_t *env = NULL;const axis2_char_t *address = NULL;axis2_endpoint_ref_t* endpoint_ref = NULL;axis2_options_t *options = NULL;const axis2_char_t *client_home = NULL;axis2_svc_client_t* svc_client = NULL;axiom_node_t *payload = NULL;axiom_node_t *ret_node = NULL;env = axutil_env_create_all("hello_client.log", AXIS2_LOG_LEVEL_TRACE);options = axis2_options_create(env);address = "http://localhost:9090/axis2/services/hello";if (argc > 1)address = argv;if (axutil_strcmp(address, "-h") == 0){printf("Usage : %s \n", argv);printf("use -h for help\n");return 0;}printf("Using endpoint : %s\n", address);endpoint_ref = axis2_endpoint_ref_create(env, address);axis2_options_set_to(options, env, endpoint_ref);axis2_options_set_action(options, env, "http://ws.apache.org/axis2/c/samples/hello");client_home = "E:\\mengli\\axis2c-bin-1.6.0-win32";//AXIS2_GETENV("AXIS2C_HOME");if (!client_home && !strcmp(client_home, ""))client_home = "../..";svc_client = axis2_svc_client_create(env, client_home);if (!svc_client){printf("Error creating service client\n");AXIS2_LOG_ERROR(env->log, AXIS2_LOG_SI, "Stub invoke FAILED: Error code:"" %d :: %s", env->error->error_number,AXIS2_ERROR_GET_MESSAGE(env->error));return -1;}axis2_svc_client_set_options(svc_client, env, options);payload = build_om_request(env);ret_node = axis2_svc_client_send_receive(svc_client, env, payload);if (ret_node){const axis2_char_t *greeting = process_om_response(env, ret_node);if (greeting)printf("\nReceived greeting: \"%s\" from service\n", greeting);axiom_node_free_tree(ret_node, env);ret_node = NULL;}else{AXIS2_LOG_ERROR(env->log, AXIS2_LOG_SI, "Stub invoke FAILED: Error code:"" %d :: %s", env->error->error_number,AXIS2_ERROR_GET_MESSAGE(env->error));printf("hello client invoke FAILED!\n");}if (svc_client){axis2_svc_client_free(svc_client, env);svc_client = NULL;}if (env){axutil_env_free((axutil_env_t *) env);env = NULL;}return 0;}axiom_node_t *build_om_request(const axutil_env_t *env){axiom_node_t* greet_om_node = NULL;axiom_element_t * greet_om_ele = NULL;greet_om_ele = axiom_element_create(env, NULL, "greet", NULL, &greet_om_node);axiom_element_set_text(greet_om_ele, env, "Hello Server!", greet_om_node);return greet_om_node;}const axis2_char_t *process_om_response(const axutil_env_t *env,axiom_node_t *node){axiom_node_t *service_greeting_node = NULL;axiom_node_t *return_node = NULL;if (node){service_greeting_node = axiom_node_get_first_child(node, env);if (service_greeting_node &&axiom_node_get_node_type(service_greeting_node, env) == AXIOM_TEXT){axiom_text_t *greeting = (axiom_text_t *)axiom_node_get_data_element(service_greeting_node, env);if (greeting && axiom_text_get_value(greeting , env)){return axiom_text_get_value(greeting, env);}}}return NULL;}
11、编译并执行该程序，会向远程服务发送字符串Hello Service!，并得到响应Hello Client!
转载请注明出处：http://www.blogjava.net/menglee/archive/2011/07/05/353719.html
页:
[1]