/*  					W3C Sample Code Library libwww RDF Parser!  RDF Parser Based on Expat and SiRPAC!Written and integrated into libwww by John Punin - thanks!This module is implemented by HTRDF.c, and is a partof the  W3C Sample Code Library.This RDF parser is based on Janne Saarela's Java basedSiRPAC andJames Clark's expat XMLparser which isincluded in the libwww CVS code base where I compile isas two libraries: libxmltok.a and libxmlparse.a.See the external modules that libwww works withfor details.*/#ifndef HTRDF_H#define HTRDF_H#include "HTHash.h"#define RDFMS "http://www.w3.org/1999/02/22-rdf-syntax-ns#"#define RDFSCHEMA "http://www.w3.org/TR/WD-rdf-schema#"#define XMLSCHEMA "xml"/*.  RDF Triple Class.*/typedef struct _HTTriple HTTriple;extern HTTriple * HTTriple_new (char * p, char * s, char * o);extern BOOL HTTriple_delete (HTTriple * me);extern void HTTriple_print (HTTriple * me);extern char * HTTriple_subject (HTTriple * me);extern char * HTTriple_predicate (HTTriple * me);extern char * HTTriple_object (HTTriple * me);/*.  RDF Element Class.*/typedef struct _HTElement HTElement;extern HTElement * HTElement_new (char * sName, HTAssocList * al);extern HTElement * HTElement_new2 (char * sContent);extern BOOL HTElement_addData (HTElement *me, char * sContent);extern BOOL HTElement_delete (HTElement * me);extern BOOL HTElement_addChild (HTElement * me, HTElement * element);extern BOOL HTElement_addAttribute (HTElement * me, char * sName, char * sValue);extern BOOL HTElement_removeAttribute (HTElement * me, char * sName);extern char * HTElement_getAttribute (HTElement * me, char * sName);extern char * HTElement_getAttribute2 (HTElement * me, char * sNamespace, char * sName);extern BOOL HTElement_addTarget (HTElement * me, HTElement * element);extern HTElement * HTElement_target (HTElement * me);extern BOOL HTElement_instanceOfData (HTElement * me);/*.  RDF Parser & Compiler Definition.These methods create and deletes an RDF Parser/Compiler (SIRPAC)(  Create and Delete Parser Instance)*/typedef struct _HTRDFParser HTRDF;extern HTRDF * HTRDF_new (void);extern BOOL HTRDF_delete (HTRDF * me);/*(  Callback Handler Announcing a new RDF Parser Object)When a RDF parser object is created, the streamchecks to see if there are any callbacks registered which should be notifiedabout the new stream instance. If that is the case then this callback iscalled and a pointer to the RDF parser passed along. The output stream isthe target that was originally set for the request object before the requestwas issued.*/typedef void HTRDFCallback_new (	HTStream *		me,	HTRequest *		request,	HTFormat 		target_format,	HTStream *		target_stream,	HTRDF *                 rdfparser,	void *                  context);/*  Register RDF Parser Creation Notification Callback@@@Should be handled via XML names spaces@@@*/extern BOOL HTRDF_registerNewParserCallback (HTRDFCallback_new *, void * context);/*(  Callback Handler Announcing a new RDF Triple)Handler announcing that a new triple has been generated.*/typedef void HTTripleCallback_new (	HTRDF *		rdfp,	HTTriple *	t,	void *		context);/*  Register RDF Triple Creation Notification Callback*/extern BOOL HTRDF_registerNewTripleCallback (	HTRDF *			me,	HTTripleCallback_new * 	cbf,	void * 			context);/*(  Set Address)Saves the name of the source document for later inspection if needed*/extern BOOL HTRDF_setSource (HTRDF * me, char * source);/*(  Resolve Symbolic References)Go through the m_vResolveQueue and assign direct object reference for eachsymbolic reference*/extern BOOL HTRDF_resolve(HTRDF *me);/*(  Find Suitable Start Element)Given an XML document (well-formed HTML, for example), look for a suitableelement to start parsing from*/extern BOOL HTRDF_processXML(HTRDF *me, HTElement *root);/*(  Return the root element pointer.)This requires the parsing has been already done.*/extern HTElement * HTRDF_root(HTRDF *me);/*(  Return the full namespace URI for a given prefix sPrefix.)The default namespace is identified with xmlns prefix. The namespace of xmlnsattribute is an empty string.*/extern char * HTRDF_namespace (HTRDF * me, char * sPrefix);/*(  Parsing Literal or Resource?)Methods to determine whether we are parsing parseType="Literal" orparseType="Resource"*/extern BOOL HTRDF_parseLiteral(HTRDF *me);extern BOOL HTRDF_parseResource(HTRDF *me);/*(  Resolve Later)Add the element e to the m_vResolveQueue to be resolved later.*/extern void HTRDF_resolveLater(HTRDF *me,HTElement *e);/*(  Register ID)Add an element e to the Hashtable m_hIDtable which stores all nodes withan ID*/extern void HTRDF_registerID(HTRDF *me, char * sID,HTElement *e);/*(  Register Resource)Add an element e to the Vector m_vResources which stores all nodes with anURI*/extern void HTRDF_registerResource(HTRDF *me,HTElement *e);/*(  Look for Node)Look for a node by name sID from the Hashtable m_hIDtable of all registeredIDs.*/extern HTElement *HTRDF_lookforNode(HTRDF *me, char * sID);/*(  If Element from RDF Schema?)Check if the element e is from the namespace of the RDF schema by comparingonly the beginning of the expanded element name with the canonical RDFMSURI*/extern BOOL HTRDF_isRDF(HTRDF *me, HTElement *ele);extern BOOL HTRDF_isRDFroot(HTRDF *me, HTElement *ele);/*(  Is the element a Description?)*/extern BOOL HTRDF_isDescription(HTRDF *me, HTElement *ele);/*(  Is the element a Predicate? )This method matches all properties but those from RDF namespace*/extern BOOL HTRDF_isTypedPredicate(HTRDF *me, HTElement *e);/*(  Is the element a Container?)*/extern BOOL HTRDF_isContainer(HTRDF *me, HTElement *e);/*(  Is the element a Bag?)*/extern BOOL HTRDF_isBag(HTRDF *me, HTElement *e);/*(  Is the element an Alternative?)*/extern BOOL HTRDF_isAlternative(HTRDF *me, HTElement *e);/*(  Is the element a Sequence?)*/extern BOOL HTRDF_isSequence(HTRDF *me, HTElement *e);/*(  Is the element a ListItem?)*/extern BOOL HTRDF_isListItem (HTRDF *me, HTElement *e);/*(  Start processing an RDF/XML document instance from the root element rdf.)*/extern BOOL HTRDF_processRDF(HTRDF *me, HTElement *ele);/*processDescription manages Description elements      description      The Description element itself      inPredicate      Is this is a nested description      reificate      Do we need to reificate      createBag      Do we create a bag container      return      An ID for the description*/extern char * HTRDF_processDescription (	HTRDF *		me,	HTElement *	description,	BOOL		inPredicate,	BOOL		reificate,	BOOL		createBag);/*(  Manage the typedNode production in the RDF grammar.)*/extern char * HTRDF_processTypedNode(HTRDF *me, HTElement *e);/*(  Special method to deal with rdf:resource attribute)*/extern char * HTRDF_getResource(HTRDF *me,HTElement *e);/*(  Create a new reification ID)Using a name part and an incremental counter m_iReificationCounter.*/extern char * HTRDF_newReificationID (HTRDF *me);/*(  Create a new triple)and add it to the m_triples List*/extern void HTRDF_addTriple (HTRDF *me, char * sPredicate, char * sSubject,			     char * sObject);/*(  Create New Bag)allows one to determine whether SiRPAC produces Bag instances for eachDescription block. The default setting is not to generate them.*/extern void HTRDF_createBags (HTRDF *me, BOOL b);/*(  Set Output Stream)Set output stream for RDF parser*/extern void HTRDF_setOutputStream (HTRDF *me, HTStream *ostream);/*.  RDF Converter Streams.A set of converter streams using theHTRDF Parser object(  RDF To Triple Converter)This stream converter converts an RDF stream to triples that are passed tothe application using the new triples callbackhandler. The RDF object itself can be obtained using thenew RDF parser object callback*/extern HTConverter HTRDFParser_new;/*(  Print RDF Triple Converter)This stream converter converts an RDF stream to triples and sends them downstremas (predicate, subject, object). This can for example be used toprint them out to stdout etc.*/extern HTConverter HTRDFToTriples;/*(  Parse a file of RDF)This function parses a file of RDF in a synchronous, non-blockingway.  In other words, the file is not asynchronously loaded.  If new_triple_callback is NULL, the default triple handler is invoked.  The context pointer will be available in the triplecallback function. Returns YES if the file is successfully parsed; otherwise NO isreturned and an error message is logged. */extern BOOL HTRDF_parseFile (const char *file_name,                              HTTripleCallback_new * new_triple_callback,                             void *context);/*(  Parse a buffer of RDF)This function parses a buffer of RDF in a synchronous, non-blocking way.  If new_triple_callback is NULL, the default triple handler is invoked.  The context pointer will be available in the triplecallback function. Returns YES if the buffer is successfully parsed; otherwise NO isreturned and an error message is logged. */extern BOOL HTRDF_parseBuffer (const char *buffer, 		               const char *buffer_name,                                int buffer_len,                                HTTripleCallback_new * new_triple_callback,                               void *context);/**/#endif/*    @(#) $Id: HTRDF.html,v 2.7 2000/08/30 13:01:57 barstow Exp $*/