Changes between Initial Version and Version 1 of UsingMapOWSCommon

Timestamp:

Jun 19, 2007, 8:22:16 AM (17 years ago)

Author:

tomkralidis

Comment:

--

UsingMapOWSCommon

@@ +1 @@
+
+Using mapowscommon.c
+
+mapowscommon implements the OGC OWS Common Specification
+
+- version 1.0.0
+- OGC document: OGC 05-008
+
+The library uses libxml2 (http://www.xmlsoft.org/) to create
+XML objects.
+
+The library uses the tree and parser modules of libxml2.
+
+The library returns xmlNodePtr objects to the calling code.
+
+To implement, the calling code must instantiate an xmlNewDoc
+object:
+
+{{{
+/* use libxml2: */
+
+#include "libxml/parser.h"
+#include "libxml/tree.h"
+
+#include "mapowscommon.h"
+
+static int msSOSException(mapObj *map, char *locator, char *exceptionCode)
+  xmlDocPtr  psDoc      = NULL;
+  xmlNodePtr psRootNode = NULL;
+  xmlChar    *buffer    = NULL;
+  int size = 0;
+
+  /* create XML document object */
+  psDoc = xmlNewDoc(BAD_CAST "1.0");
+
+  /* generate a service exception object */
+  psRootNode = msOWSCommonExceptionReport(msEncodeHTMLEntities(msOWSGetSchemasLocation(map)), pszSOSVersion, msOWSGetLanguage(map, "exception"), exceptionCode, locator, msEncodeHTMLEntities(msGetErrorString("\n")));
+
+  /* set the root element of the document */
+  xmlDocSetRootElement(psDoc, psRootNode);
+
+  /* set the namespace of the document */
+  xmlSetNs(psRootNode,  xmlNewNs(psRootNode, BAD_CAST MS_OWSCOMMON_OWS_NAMESPACE_URI, BAD_CAST MS_OWSCOMMON_OWS_NAMESPACE_PREFIX));
+  msIO_printf("Content-type: text/xml%c%c",10,10);
+
+  /* dump the libxml2 object to a string for output */
+  xmlDocDumpFormatMemoryEnc(psDoc, &buffer, &size, "ISO-8859-1", 1);
+
+  msIO_printf("%s", buffer);
+
+  /*free buffer and the document */
+  xmlFree(buffer);
+  xmlFreeDoc(psDoc);
+
+  /* clear error since we have already reported it */
+  msResetErrorList();
+
+  return MS_FAILURE;
+}
+
+
+}}}
+
+NOTES:
+
+- with the exception of msOWSCommonExceptionReport, ALL functions return
+an XML chunk.  It is the responsibility of the calling code to setup the
+root element with correct namespace decls and schema pointers
+
+- msOWSCommonExceptionReport returns an entire, complete and valid XML
+document, as it is the only XML in OWS Common which is designed to be
+implemented standalone