geographika / mapserver / 11366259730

/******************************************************************************

 * $Id$

 *

 * Project:  MapServer

 * Purpose:  OGC OWS Common Implementation for use by MapServer OGC code

 *           versions:

 *           1.0.0 (OGC Document 05-008c1)

 *           1.1.0 (OGC document 06-121r3)

 *

 * Author:   Tom Kralidis (tomkralidis@gmail.com)

 *

 ******************************************************************************

 * Copyright (c) 2006, Tom Kralidis

 *

 * Permission is hereby granted, free of charge, to any person obtaining a

 * copy of this software and associated documentation files (the "Software"),

 * to deal in the Software without restriction, including without limitation

 * the rights to use, copy, modify, merge, publish, distribute, sublicense,

 * and/or sell copies of the Software, and to permit persons to whom the

 * Software is furnished to do so, subject to the following conditions:

 *

 * The above copyright notice and this permission notice shall be included in

 * all copies of this Software or works derived from this Software.

 *

 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS

 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL

 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING

 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER

 * DEALINGS IN THE SOFTWARE.

 ****************************************************************************/

#include "mapserver.h"

#include "mapows.h"

#ifdef USE_LIBXML2

#include <libxml/parser.h>

#include <libxml/tree.h>

#include "mapowscommon.h"

#include "maplibxml2.h"

/**

 * msOWSCommonServiceIdentification()

 *

 * returns an object of ServiceIdentification as per:

 *

 * 1.0.0 subclause 7.4.3

 * 1.1.1 subclause 7.4.4

 *

 * @param map mapObj used to fetch WEB/METADATA

 * @param servicetype the OWS type

 * @param supported_versions the supported version(s) of the OWS

 *

 * @return psRootNode xmlNodePtr of XML construct

 *

 */

                                            const char *servicetype,

                                            const char *supported_versions,

                                            const char *namespaces,

                                            const char *validated_language) {

  const char *value = NULL;

  xmlNodePtr psRootNode = NULL;

  xmlNodePtr psNode = NULL;

                       BAD_CAST MS_OWSCOMMON_OWS_NAMESPACE_PREFIX);

  /* create element name */

  /* add child elements */

                                          "title", validated_language);

  psNode =

        psNode,

        xmlNewComment(

            BAD_CAST

            "WARNING: Optional metadata \"ows_title\" missing for ows:Title"));

  }

                                          "abstract", validated_language);

  psNode =

                  xmlNewComment(BAD_CAST

                                "WARNING: Optional metadata \"ows_abstract\" "

                                "was missing for ows:Abstract"));

  }

                                          "keywordlist", validated_language);

  }

  else {

        psNode,

        xmlNewComment(BAD_CAST "WARNING: Optional metadata \"ows_keywordlist\" "

                               "was missing for ows:KeywordList"));

  }

                           BAD_CAST servicetype);

                        supported_versions, ',');

                                          "fees", validated_language);

  psNode =

                  xmlNewComment(BAD_CAST

                                "WARNING: Optional metadata \"ows_fees\" was "

                                "missing for ows:Fees"));

  }

  value =

                                      "accessconstraints", validated_language);

                           BAD_CAST value);

        psNode,

        xmlNewComment(BAD_CAST

                      "WARNING: Optional metadata \"ows_accessconstraints\" "

                      "was missing for ows:AccessConstraints"));

  }

}

/**

 * msOWSCommonServiceProvider()

 *

 * returns an object of ServiceProvider as per:

 *

 *

 * 1.0.0 subclause 7.4.4

 * 1.1.0 subclause 7.4.5

 *

 * @param map mapObj to fetch MAP/WEB/METADATA

 *

 * @return psRootNode xmlNodePtr pointer of XML construct

 *

 */

                                      mapObj *map, const char *namespaces,

                                      const char *validated_language) {

  const char *value = NULL;

  xmlNodePtr psNode = NULL;

  xmlNodePtr psRootNode = NULL;

  xmlNodePtr psSubNode = NULL;

  xmlNodePtr psSubSubNode = NULL;

  xmlNodePtr psSubSubSubNode = NULL;

                       BAD_CAST MS_OWSCOMMON_OWS_NAMESPACE_PREFIX);

  /* add child elements */

                                          "contactorganization",

                                          validated_language);

                           BAD_CAST value);

        psNode,

        xmlNewComment(BAD_CAST

                      "WARNING: Mandatory metadata \"ows_contactorganization\" "

                      "was missing for ows:ProviderName"));

  }

                                          "service_onlineresource",

                                          validated_language);

        psNode, xmlNewComment(

                    BAD_CAST

                    "WARNING: Optional metadata \"ows_service_onlineresource\" "

                    "was missing for ows:ProviderSite/@xlink:href"));

  }

  psNode =

                                          "contactperson", validated_language);

                              BAD_CAST value);

        psSubNode,

        xmlNewComment(BAD_CAST

                      "WARNING: Optional metadata \"ows_contactperson\" was "

                      "missing for ows:IndividualName"));

  }

      &(map->web.metadata), namespaces, "contactposition", validated_language);

  psSubNode =

        psSubNode,

        xmlNewComment(BAD_CAST

                      "WARNING: Optional metadata \"ows_contactposition\" was "

                      "missing for ows:PositionName"));

  }

                                          "contactvoicetelephone",

                                          validated_language);

  psSubSubSubNode =

        psSubSubSubNode,

        xmlNewComment(

            BAD_CAST "WARNING: Optional metadata \"ows_contactvoicetelephone\" "

                     "was missing for ows:Voice"));

  }

                                          "contactfacsimiletelephone",

                                          validated_language);

                                    BAD_CAST value);

        psSubSubSubNode,

        xmlNewComment(

            BAD_CAST

            "WARNING: Optional metadata \"ows_contactfacsimiletelephone\" was "

            "missing for ows:Facsimile"));

  }

                                          "address", validated_language);

                                    BAD_CAST "DeliveryPoint", BAD_CAST value);

        psSubSubSubNode,

        xmlNewComment(BAD_CAST "WARNING: Optional metadata \"ows_address\" was "

                               "missing for ows:DeliveryPoint"));

  }

                                          "city", validated_language);

  psSubSubSubNode =

                  xmlNewComment(BAD_CAST

                                "WARNING: Optional metadata \"ows_city\" was "

                                "missing for ows:City"));

  }

      &(map->web.metadata), namespaces, "stateorprovince", validated_language);

      psSubSubNode, psNsOws, BAD_CAST "AdministrativeArea", BAD_CAST value);

        psSubSubSubNode,

        xmlNewComment(BAD_CAST

                      "WARNING: Optional metadata \"ows_stateorprovince\" was "

                      "missing for ows:AdministrativeArea"));

  }

                                          "postcode", validated_language);

                                    BAD_CAST "PostalCode", BAD_CAST value);

                  xmlNewComment(BAD_CAST

                                "WARNING: Optional metadata \"ows_postcode\" "

                                "was missing for ows:PostalCode"));

  }

                                          "country", validated_language);

                                    BAD_CAST value);

        psSubSubSubNode,

        xmlNewComment(BAD_CAST "WARNING: Optional metadata \"ows_country\" was "

                               "missing for ows:Country"));

  }

                                          "contactelectronicmailaddress",

                                          validated_language);

      psSubSubNode, psNsOws, BAD_CAST "ElectronicMailAddress", BAD_CAST value);

        psSubSubSubNode,

        xmlNewComment(

            BAD_CAST

            "WARNING: Optional metadata \"ows_contactelectronicmailaddress\" "

            "was missing for ows:ElectronicMailAddress"));

  }

  psSubSubNode =

                                          "service_onlineresource",

                                          validated_language);

        psSubSubNode,

        xmlNewComment(

            BAD_CAST

            "WARNING: Optional metadata \"ows_service_onlineresource\" was "

            "missing for ows:OnlineResource/@xlink:href"));

  }

                                          "hoursofservice", validated_language);

                                 BAD_CAST value);

        psSubSubNode,

        xmlNewComment(BAD_CAST

                      "WARNING: Optional metadata \"ows_hoursofservice\" was "

                      "missing for ows:HoursOfService"));

  }

                                          "contactinstructions",

                                          validated_language);

      psSubNode, psNsOws, BAD_CAST "ContactInstructions", BAD_CAST value);

        psSubSubNode,

        xmlNewComment(BAD_CAST

                      "WARNING: Optional metadata \"ows_contactinstructions\" "

                      "was missing for ows:ContactInstructions"));

  }

                                          "role", validated_language);

                  xmlNewComment(BAD_CAST

                                "WARNING: Optional metadata \"ows_role\" was "

                                "missing for ows:Role"));

  }

}

/**

 * msOWSCommonOperationsMetadata()

 *

 * returns the root element of OperationsMetadata as per:

 *

 * 1.0.0 subclause 7.4.5

 * 1.1.0 subclause 7.4.6

 *

 * @return psRootNode xmlNodePtr pointer of XML construct

 *

 */

  xmlNodePtr psRootNode = NULL;

                       BAD_CAST MS_OWSCOMMON_OWS_NAMESPACE_PREFIX);

}

/**

 * msOWSCommonOperationsMetadataOperation()

 *

 * returns an Operation element of OperationsMetadata as per:

 *

 * 1.0.0 subclause 7.4.5

 * 1.1.0 subclause 7.4.6

 *

 * @param name name of the Operation

 * @param method HTTP method: OWS_METHOD_GET, OWS_METHOD_POST or

 * OWS_METHOD_GETPOST)

 * @param url online resource URL

 *

 * @return psRootNode xmlNodePtr pointer of XML construct

 */

                                                  xmlNsPtr psXLinkNs,

                                                  const char *name, int method,

                                                  const char *url) {

                       BAD_CAST MS_OWSCOMMON_OWS_NAMESPACE_PREFIX);

    xmlNodePtr psSubSubNode =

  }

    xmlNodePtr psSubSubNode =

  }

}

/**

 * msOWSCommonOperationsMetadataDomainType()

 *

 * returns a Parameter or Constraint element (which are of type ows:DomainType)

 * of OperationsMetadata as per:

 *

 * 1.0.0 subclause 7.4.5

 * 1.1.0 subclause 7.4.6

 *

 * @param version the integerized x.y.z version of OWS Common to use

 * @param elname name of the element (Parameter | Constraint)

 * @param name name of the Parameter

 * @param values list of values (comma separated list) or NULL if none

 *

 * @return psRootNode xmlNodePtr pointer of XML construct

 *

 */

                                                   xmlNsPtr psNsOws,

                                                   const char *elname,

                                                   const char *name,

                                                   const char *values) {

                       BAD_CAST MS_OWSCOMMON_OWS_NAMESPACE_PREFIX);

  }

    xmlNodePtr psNode =

  }

}

/**

 * msOWSCommonExceptionReport()

 *

 * returns an object of ExceptionReport as per clause 8

 *

 * @param ows_version the version of OWS Common to use

 * @param schemas_location URL to OGC Schemas Location base

 * @param version the version of the calling specification

 * @param language ISO3166 code of language

 * @param exceptionCode a code from the calling specification's list of

 * exceptions, or from OWS Common

 * @param locator where the exception was encountered (i.e. "layers" keyword)

 * @param ExceptionText the actual error message

 *

 * @return psRootNode xmlNodePtr pointer of XML construct

 *

 */

                                      const char *schemas_location,

                                      const char *version, const char *language,

                                      const char *exceptionCode,

                                      const char *locator,

                                      const char *ExceptionText) {

  char *xsi_schemaLocation = NULL;

  char szVersionBuf[OWS_VERSION_MAXLEN];

  xmlNsPtr psNsXsi = NULL;

  xmlNodePtr psRootNode = NULL;

  xmlNodePtr psMainNode = NULL;

                     BAD_CAST MS_OWSCOMMON_W3C_XSI_NAMESPACE_PREFIX);

  /* add attributes to root element */

  }

  }

  xsi_schemaLocation =

      xsi_schemaLocation,

      (char *)msOWSGetVersionString(ows_version, szVersionBuf));

  xsi_schemaLocation =

  /* add namespace'd attributes to root element */

               BAD_CAST xsi_schemaLocation);

  /* add child element */

  /* add attributes to child */

  }

                    BAD_CAST ExceptionText);

  }

}

/**

 * msOWSCommonBoundingBox()

 *

 * returns an object of BoundingBox as per subclause 10.2.1

 *

 * If necessary (ie. an EPSG URN GCS such as 4326) the tuple axes will be

 * reoriented to match the EPSG coordinate system expectations.

 *

 * @param psNsOws OWS namespace object

 * @param crs the CRS / EPSG code

 * @param dimensions number of dimensions of the coordinates

 * @param minx minx

 * @param miny miny

 * @param maxx maxx

 * @param maxy maxy

 *

 * @return psRootNode xmlNodePtr pointer of XML construct

 */

                                  int dimensions, double minx, double miny,

                                  double maxx, double maxy) {

  char LowerCorner[100];

  char UpperCorner[100];

  char dim_string[100];

  xmlNodePtr psRootNode = NULL;

  /* Do we need to reorient tuple axes? */

    projectionObj proj;

    }

  }

                       BAD_CAST MS_OWSCOMMON_OWS_NAMESPACE_PREFIX);

  /* create element name */

  /* add attributes to the root element */

  snprintf(dim_string, sizeof(dim_string), "%d", dimensions);

  /* add child elements */

              BAD_CAST LowerCorner);

              BAD_CAST UpperCorner);

}

/**

 * msOWSCommonWGS84BoundingBox()

 *

 * returns an object of WGS84BoundingBox as per subclause 10.2.2

 *

 * @param psNsOws OWS namespace object

 * @param dimensions number of dimensions of the coordinates

 * @param minx minx

 * @param miny miny

 * @param maxx maxx

 * @param maxy maxy

 *

 * @return psRootNode xmlNodePtr pointer of XML construct

 */

                                       double minx, double miny, double maxx,

                                       double maxy) {

  char LowerCorner[100];

  char UpperCorner[100];

  char dim_string[100];

  xmlNodePtr psRootNode = NULL;

                       BAD_CAST MS_OWSCOMMON_OWS_NAMESPACE_PREFIX);

  /* create element name */

  snprintf(dim_string, sizeof(dim_string), "%d", dimensions);

  snprintf(LowerCorner, sizeof(LowerCorner), "%.6f %.6f", minx, miny);

  snprintf(UpperCorner, sizeof(UpperCorner), "%.6f %.6f", maxx, maxy);

  /* add child elements */

              BAD_CAST LowerCorner);

              BAD_CAST UpperCorner);

}

/**

 * _validateNamespace()

 *

 * validates the namespace passed to this module's functions

 *

 * @param psNsOws namespace object

 *

 * @return MS_SUCCESS or MS_FAILURE

 *

 */

  char namespace_prefix[10];

    return MS_SUCCESS;

  else

}

/*

 * Valid an xml string against an XML schema

 * Inpired from:

 * http://xml.developpez.com/sources/?page=validation#validate_XSD_CppCLI_2

 * taken from tinyows.org

 */

  xmlSchemaPtr schema;

  xmlSchemaParserCtxtPtr ctxt;

  xmlSchemaValidCtxtPtr validctxt;

  int ret;

  xmlDocPtr doc;

    return MS_FAILURE;

  schema = NULL;

  ret = -1;

  /* To valid WFS 2.0 requests, we might need to explicitly import */

  /* GML and FES 2.0 */

                 strlen(MS_OWSCOMMON_WFS_20_SCHEMA_LOCATION),

    const size_t nLenBaseLocation =

        strlen(xml_schema) - strlen(MS_OWSCOMMON_WFS_20_SCHEMA_LOCATION);

    char *pszInMemSchema = NULL;

    memcpy(pszBaseLocation, xml_schema, nLenBaseLocation);

        pszInMemSchema,

        "<schema elementFormDefault=\"qualified\" version=\"1.0.0\" "

        "xmlns=\"http://www.w3.org/2001/XMLSchema\">\n");

        pszInMemSchema, "<import namespace=\"" MS_OWSCOMMON_WFS_20_NAMESPACE_URI

                        "\" schemaLocation=\"");

          pszInMemSchema,

          "<import namespace=\"" MS_OWSCOMMON_FES_20_NAMESPACE_URI

          "\" schemaLocation=\"");

          pszInMemSchema, MS_OWSCOMMON_FES_20_SCHEMA_LOCATION "\" />\n");

    }

          pszInMemSchema,

          "<import namespace=\"" MS_OWSCOMMON_GML_32_NAMESPACE_URI

          "\" schemaLocation=\"");

          pszInMemSchema, MS_OWSCOMMON_GML_321_SCHEMA_LOCATION "\" />\n");

            pszInMemSchema,

            "<import namespace=\"" MS_OWSCOMMON_GML_NAMESPACE_URI

            "\" schemaLocation=\"");

            pszInMemSchema, MS_OWSCOMMON_GML_212_SCHEMA_LOCATION "\" />\n");

            pszInMemSchema,

            "<import namespace=\"" MS_OWSCOMMON_GML_NAMESPACE_URI

            "\" schemaLocation=\"");

            pszInMemSchema, MS_OWSCOMMON_GML_311_SCHEMA_LOCATION "\" />\n");

      }

    }

  } else {

    /* Open XML Schema File */

  }

  /*

  xmlSchemaSetParserErrors(ctxt,

                           (xmlSchemaValidityErrorFunc) libxml2_callback,

                           (xmlSchemaValidityWarningFunc) libxml2_callback,

  stderr);

  */

  /* If XML Schema hasn't been rightly loaded */

  }

    /* Loading XML Schema content */

    /*

    xmlSchemaSetValidErrors(validctxt,

                            (xmlSchemaValidityErrorFunc) libxml2_callback,

                            (xmlSchemaValidityWarningFunc) libxml2_callback,

    stderr);

    */

    /* validation */

  }

}

#endif /* defined(USE_LIBXML2) */

/**

 * msOWSCommonNegotiateVersion()

 *

 * returns a supported version as per subclause 7.3.2

 *

 * @param requested_version the version passed by the client

 * @param supported_versions an array of supported versions

 * @param num_supported_versions size of supported_versions

 *

 * @return supported version integer, or -1 on error

 *

 */

                                const int supported_versions[],

                                int num_supported_versions) {

  int i;

  /* if version is not set return error */

    return -1;

  /* return the first entry that's equal to the requested version */

  }

  /* no match; calling code should throw an exception */

  return -1;

}