1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
|
/******************************************************************
* $Id: soap-server.h,v 1.18 2006/12/09 09:57:38 m0gg Exp $
*
* CSOAP Project: A SOAP client/server library in C
* Copyright (C) 2003 Ferhat Ayaz
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*
* Email: ferhatayaz@yahoo.com
******************************************************************/
#ifndef __csoap_server_h
#define __csoap_server_h
/**
*
* @mainpage Project overview
*
* @section seq_intro Introduction
*
* cSOAP is a client/server SOAP library implemented in pure C. It comes with
* embedded transport servers for UDP and HTTP (nanohttp). The transferred XML
* structures are handled by libxml2.
*
* @section seq_features Features
*
* - different transport services
* - @ref nanoHTTP (HTTP including SSL)
* - client/server UDP transport service (multicast)
* - attachments via MIME
* - message based security (encryption/signation)
* - automatic generation of WS-Inspection
*
* @author Ferhat Ayaz
* @author Michael Rans
* @author Matt Campbell
* @author Heiko Ronsdorf
*
* @version 1.2
*
* @see http://csoap.sourceforge.net/
* @see http://www.libxml.org/
* @see http://www.openssl.org/
* @see http://www.aleksey.com/xmlsec/
*/
/** @file
*
* @version $Revision: 1.18 $
*
*/
#ifdef __cplusplus
extern "C" {
#endif
/**
*
* Initializes the soap server with commandline arguments.
*
* @param argc commandline arg count
* @param argv commandline arg vector
*
* @returns H_OK on success
*
* @see httpd_init_args
* @see udpd_init_args
*
*/
herror_t soap_server_init_args(int argc, char **argv);
/**
*
* Register a router to the SOAP server.
*
* <p><i>scheme</i>://<i>host</i>:<i>port</i>/<b>[context]</b>
*
* @param router The router to register
* @param context the url context
*
* @returns H_OK on success
*
* @see soap_router_new
* @see soap_router_register_service
*
*/
extern herror_t soap_server_register_router(struct SoapRouter * router, const char *context);
/**
*
* Returns an URI name of the server.
*
*/
extern const char *soap_server_get_name(void);
/**
*
* Enters the server loop and starts to listen to incoming requests.
*
* @see httpd_run
* @see udpd_run
* @see smptd_run
*
*/
extern herror_t soap_server_run(void);
/**
*
* Frees the SOAP server.
*
* @see httpd_destroy
* @see udpd_destroy
*
*/
extern void soap_server_destroy(void);
#ifdef __CSOAP_INTERNAL
typedef struct _SoapRouterNode
{
char *context;
struct SoapRouter *router;
struct _SoapRouterNode *next;
} SoapRouterNode;
extern struct SoapRouter *soap_server_find_router(const char *context);
extern SoapRouterNode * soap_server_get_routers(void);
extern herror_t soap_server_process(struct SoapCtx *request, struct SoapCtx **response);
#endif
#ifdef __cplusplus
}
#endif
#endif
|
