/*  					W3C Sample Code Library libwww URL Tress!  URL Trees!*//***	(c) COPYRIGHT MIT 1995.**	Please first read the full copyright statement in the file COPYRIGH.*//*A URL tree is a hierarchical container class that is well suited forstoring information about a URL hierarchy. The root of a URL treeis the hostname part of the URL, for examplewww.w3.org:8000. Client application can use URL trees tostore what they know about remote servers, for example the access authentication,PICS labels and PEP modules required to access a specific URL from a remoteserver. However, URL trees can also be used on server side to contain informationabout the server tree, for example what parts of the tree is protected etc.There are three components of the URL tree which all can be searched forusing the methods declared in this module.	 	   o 	     The Tree itself	   o 	     A URL Node which represents a hierarchy level in a URL	   o 	     A URL Template which can span multiple nodes and are very similar to the	     realms known from for example Basic Access Authentication in HTTP.	 	 Typically, a URL tree will be empty when the application starts and as timegoes by and we get to know more about the remote servers that we have access,the URL trees will contain more and more information. A nice feature aboutURL trees is that the application can interpolate information based on realmsand templates. This gives the application a good chance of guessing whatinformation (for example a set of credentials) should be appended to a newrequest.We do not currently distinguish between multiple access mechanisms, for exampleHTTP and FTP, however, URL trees are mostly used within theHTTP domain.URL Trees are often used by filters whichstores information about remote services, Each filter can have its own URLtree or a URL tree can be shared among multiple filters.This module is implemented by HTUTree.c, and it isa part of the  W3C Sample CodeLibrary.*/#ifndef HTUTREE_H#define HTUTREE_H#include "HTReq.h"/*.  URL Trees.The three parts of a URL tree are called*/typedef struct _HTUTree     HTUTree;typedef struct _HTURealm     HTURealm;typedef struct _HTUTemplate HTUTemplate;/*(  Create a URL Tree)Create a new authentication base Returns new object or NULL if error*/typedef int HTUTree_gc		(void * context);extern HTUTree * HTUTree_new (const char * 		root,			      const char * 		host,			      int 			port,			      HTUTree_gc *	 	gc);/*(  Delete a URL Tree)Delete a complete server tree and everything within it.*/extern BOOL HTUTree_delete (const char * 	root,			    const char * 	host,			    int			port);/*(  Delete ALL URL Trees)Delete all information bases*/extern BOOL HTUTree_deleteAll (void);/*(  Find a URL Tree)Find a authentication base. Return NULL if not found*/extern HTUTree * HTUTree_find (const char *	root,			       const char *	host,			       int		port);/*.  URL Nodes.*/extern void * HTUTree_findNode (HTUTree * tree,                                 const char * realm, const char * path); /**/extern BOOL HTUTree_addNode (HTUTree * tree,                              const char * realm, const char * path,                              void * context);/**/extern BOOL HTUTree_replaceNode (HTUTree * tree,                                  const char * realm, const char * path,                                  void * context);/**/extern BOOL HTUTree_deleteNode (HTUTree * tree,                                 const char * realm, const char * path);/**/#endif /* HTUTREE_H *//*    @(#) $Id: HTUTree.html,v 2.3 1998/05/14 02:11:15 frystyk Exp $*/