diff options
author | snowdrop | 2004-02-10 09:51:10 +0000 |
---|---|---|
committer | snowdrop | 2004-02-10 09:51:10 +0000 |
commit | d5600e2ebe6b8b146daa685c189315cd320c25a2 (patch) | |
tree | 7f55bcc4441e73b0b4ee6e36e836bdc75464afbe /libcsoap/soap-router.h | |
parent | cd9698cdee9fe0de0794289198dbdc9251951d94 (diff) | |
download | csoap-d5600e2ebe6b8b146daa685c189315cd320c25a2.tar.gz csoap-d5600e2ebe6b8b146daa685c189315cd320c25a2.tar.bz2 |
added documentation
Diffstat (limited to 'libcsoap/soap-router.h')
-rw-r--r-- | libcsoap/soap-router.h | 41 |
1 files changed, 40 insertions, 1 deletions
diff --git a/libcsoap/soap-router.h b/libcsoap/soap-router.h index 34de257..b0a2536 100644 --- a/libcsoap/soap-router.h +++ b/libcsoap/soap-router.h @@ -1,5 +1,5 @@ /****************************************************************** - * $Id: soap-router.h,v 1.1 2004/02/03 08:10:05 snowdrop Exp $ + * $Id: soap-router.h,v 1.2 2004/02/10 09:51:10 snowdrop Exp $ * * CSOAP Project: A SOAP client/server library in C * Copyright (C) 2003 Ferhat Ayaz @@ -27,6 +27,10 @@ #include <libcsoap/soap-service.h> +/** + The router object. A router can store a set of + services. A service is a C function. + */ typedef struct _SoapRouter { SoapServiceNode *service_head; @@ -34,18 +38,53 @@ typedef struct _SoapRouter }SoapRouter; +/** + Creates a new router object. Create a router if + you are implementing a soap server. Then register + the services to this router. + <P>A router points also to http url context. + + @returns Soap router + @see soap_router_free + */ SoapRouter *soap_router_new(); + +/** + Registers a SOAP service (in this case a C function) + to the router. + + @param router The router object + @param func Function to register as a soap service + @param method Method name to call the function from + the client side. + @param urn The urn for this service + */ void soap_router_register_service(SoapRouter *router, SoapServiceFunc func, const char* method, const char* urn); +/** + Searches for a registered soap service. + + @param router The router object + @param urn URN of the service + @param method The name under which the service was registered. + + @return The service if found, NULL otherwise. + */ SoapService* soap_router_find_service(SoapRouter *router, const char* urn, const char* method); + +/** + Frees the router object. + + @param router The router object to free + */ void soap_router_free(SoapRouter *router); #endif |