/******************************************************************
 *  $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
 *
 * 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: ayaz@jprogrammer.net
 ******************************************************************/
#ifndef cSOAP_ROUTER_H
#define cSOAP_ROUTER_H


#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;
  SoapServiceNode *service_tail;
}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