// FIXME Envelopes should not be treated as geometries! readEnvelope_ is part // of GEOMETRY_PARSERS_ and methods using GEOMETRY_PARSERS_ do not expect // envelopes/extents, only geometries! goog.provide('ol.format.GMLBase'); goog.require('goog.array'); goog.require('goog.asserts'); goog.require('goog.dom'); goog.require('goog.dom.NodeType'); goog.require('goog.object'); goog.require('goog.string'); goog.require('ol.Feature'); goog.require('ol.format.Feature'); goog.require('ol.format.XMLFeature'); goog.require('ol.geom.Geometry'); goog.require('ol.geom.LineString'); goog.require('ol.geom.LinearRing'); goog.require('ol.geom.MultiLineString'); goog.require('ol.geom.MultiPoint'); goog.require('ol.geom.MultiPolygon'); goog.require('ol.geom.Point'); goog.require('ol.geom.Polygon'); goog.require('ol.proj'); goog.require('ol.xml'); /** * @classdesc * Abstract base class; normally only used for creating subclasses and not * instantiated in apps. * Feature base format for reading and writing data in the GML format. * This class cannot be instantiate, it contains only base content that * is shared with versioned format classes ol.format.GML2 and * ol.format.GML3. * * @constructor * @param {olx.format.GMLOptions=} opt_options * Optional configuration object. * @extends {ol.format.XMLFeature} * @api */ ol.format.GMLBase = function(opt_options) { var options = /** @type {olx.format.GMLOptions} */ (goog.isDef(opt_options) ? opt_options : {}); /** * @protected * @type {string} */ this.featureType = options.featureType; /** * @protected * @type {string} */ this.featureNS = options.featureNS; /** * @protected * @type {string} */ this.srsName = options.srsName; /** * @protected * @type {string} */ this.schemaLocation = ''; goog.base(this); }; goog.inherits(ol.format.GMLBase, ol.format.XMLFeature); /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @return {Array.} Features. * @private */ ol.format.GMLBase.prototype.readFeatures_ = function(node, objectStack) { goog.asserts.assert(node.nodeType == goog.dom.NodeType.ELEMENT); var localName = ol.xml.getLocalName(node); var features; if (localName == 'FeatureCollection') { features = ol.xml.pushParseAndPop(null, this.FEATURE_COLLECTION_PARSERS, node, objectStack, this); } else if (localName == 'featureMembers' || localName == 'featureMember') { var context = objectStack[0]; goog.asserts.assert(goog.isObject(context)); var featureType = goog.object.get(context, 'featureType'); if (!goog.isDef(featureType) && !goog.isNull(node.firstElementChild)) { var member = node.firstElementChild; featureType = member.nodeName.split(':').pop(); goog.object.set(context, 'featureType', featureType); goog.object.set(context, 'featureNS', member.namespaceURI); } var parsers = {}; var parsersNS = {}; parsers[featureType] = (localName == 'featureMembers') ? ol.xml.makeArrayPusher(this.readFeatureElement, this) : ol.xml.makeReplacer(this.readFeatureElement, this); parsersNS[goog.object.get(context, 'featureNS')] = parsers; features = ol.xml.pushParseAndPop([], parsersNS, node, objectStack); } if (!goog.isDef(features)) { features = []; } return features; }; /** * @type {Object.>} */ ol.format.GMLBase.prototype.FEATURE_COLLECTION_PARSERS = Object({ 'http://www.opengis.net/gml': { 'featureMember': ol.xml.makeArrayPusher( ol.format.GMLBase.prototype.readFeatures_), 'featureMembers': ol.xml.makeReplacer( ol.format.GMLBase.prototype.readFeatures_) } }); /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @return {ol.geom.Geometry|undefined} Geometry. */ ol.format.GMLBase.prototype.readGeometryElement = function(node, objectStack) { var context = objectStack[0]; goog.asserts.assert(goog.isObject(context)); goog.object.set(context, 'srsName', node.firstElementChild.getAttribute('srsName')); var geometry = ol.xml.pushParseAndPop(/** @type {ol.geom.Geometry} */(null), this.GEOMETRY_PARSERS_, node, objectStack, this); if (goog.isDefAndNotNull(geometry)) { return /** @type {ol.geom.Geometry} */ ( ol.format.Feature.transformWithOptions(geometry, false, context)); } else { return undefined; } }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @return {ol.Feature} Feature. */ ol.format.GMLBase.prototype.readFeatureElement = function(node, objectStack) { var n; var fid = node.getAttribute('fid') || ol.xml.getAttributeNS(node, 'http://www.opengis.net/gml', 'id'); var values = {}, geometryName; for (n = node.firstElementChild; !goog.isNull(n); n = n.nextElementSibling) { var localName = ol.xml.getLocalName(n); // Assume attribute elements have one child node and that the child // is a text node. Otherwise assume it is a geometry node. if (n.childNodes.length === 0 || (n.childNodes.length === 1 && n.firstChild.nodeType === 3)) { var value = ol.xml.getAllTextContent(n, false); if (goog.string.isEmpty(value)) { value = undefined; } values[localName] = value; } else { // boundedBy is an extent and must not be considered as a geometry if (localName !== 'boundedBy') { geometryName = localName; } values[localName] = this.readGeometryElement(n, objectStack); } } var feature = new ol.Feature(values); if (goog.isDef(geometryName)) { feature.setGeometryName(geometryName); } if (fid) { feature.setId(fid); } return feature; }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @return {ol.geom.Point|undefined} Point. */ ol.format.GMLBase.prototype.readPoint = function(node, objectStack) { goog.asserts.assert(node.nodeType == goog.dom.NodeType.ELEMENT); goog.asserts.assert(node.localName == 'Point'); var flatCoordinates = this.readFlatCoordinatesFromNode_(node, objectStack); if (goog.isDefAndNotNull(flatCoordinates)) { var point = new ol.geom.Point(null); goog.asserts.assert(flatCoordinates.length == 3); point.setFlatCoordinates(ol.geom.GeometryLayout.XYZ, flatCoordinates); return point; } }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @return {ol.geom.MultiPoint|undefined} MultiPoint. */ ol.format.GMLBase.prototype.readMultiPoint = function(node, objectStack) { goog.asserts.assert(node.nodeType == goog.dom.NodeType.ELEMENT); goog.asserts.assert(node.localName == 'MultiPoint'); var coordinates = ol.xml.pushParseAndPop( /** @type {Array.>} */ ([]), this.MULTIPOINT_PARSERS_, node, objectStack, this); if (goog.isDef(coordinates)) { return new ol.geom.MultiPoint(coordinates); } else { return undefined; } }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @return {ol.geom.MultiLineString|undefined} MultiLineString. */ ol.format.GMLBase.prototype.readMultiLineString = function(node, objectStack) { goog.asserts.assert(node.nodeType == goog.dom.NodeType.ELEMENT); goog.asserts.assert(node.localName == 'MultiLineString'); var lineStrings = ol.xml.pushParseAndPop( /** @type {Array.} */ ([]), this.MULTILINESTRING_PARSERS_, node, objectStack, this); if (goog.isDef(lineStrings)) { var multiLineString = new ol.geom.MultiLineString(null); multiLineString.setLineStrings(lineStrings); return multiLineString; } else { return undefined; } }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @return {ol.geom.MultiPolygon|undefined} MultiPolygon. */ ol.format.GMLBase.prototype.readMultiPolygon = function(node, objectStack) { goog.asserts.assert(node.nodeType == goog.dom.NodeType.ELEMENT); goog.asserts.assert(node.localName == 'MultiPolygon'); var polygons = ol.xml.pushParseAndPop( /** @type {Array.} */ ([]), this.MULTIPOLYGON_PARSERS_, node, objectStack, this); if (goog.isDef(polygons)) { var multiPolygon = new ol.geom.MultiPolygon(null); multiPolygon.setPolygons(polygons); return multiPolygon; } else { return undefined; } }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @private */ ol.format.GMLBase.prototype.pointMemberParser_ = function(node, objectStack) { goog.asserts.assert(node.nodeType == goog.dom.NodeType.ELEMENT); goog.asserts.assert(node.localName == 'pointMember' || node.localName == 'pointMembers'); ol.xml.parseNode(this.POINTMEMBER_PARSERS_, node, objectStack, this); }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @private */ ol.format.GMLBase.prototype.lineStringMemberParser_ = function(node, objectStack) { goog.asserts.assert(node.nodeType == goog.dom.NodeType.ELEMENT); goog.asserts.assert(node.localName == 'lineStringMember' || node.localName == 'lineStringMembers'); ol.xml.parseNode(this.LINESTRINGMEMBER_PARSERS_, node, objectStack, this); }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @private */ ol.format.GMLBase.prototype.polygonMemberParser_ = function(node, objectStack) { goog.asserts.assert(node.nodeType == goog.dom.NodeType.ELEMENT); goog.asserts.assert(node.localName == 'polygonMember' || node.localName == 'polygonMembers'); ol.xml.parseNode(this.POLYGONMEMBER_PARSERS_, node, objectStack, this); }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @return {ol.geom.LineString|undefined} LineString. */ ol.format.GMLBase.prototype.readLineString = function(node, objectStack) { goog.asserts.assert(node.nodeType == goog.dom.NodeType.ELEMENT); goog.asserts.assert(node.localName == 'LineString'); var flatCoordinates = this.readFlatCoordinatesFromNode_(node, objectStack); if (goog.isDefAndNotNull(flatCoordinates)) { var lineString = new ol.geom.LineString(null); lineString.setFlatCoordinates(ol.geom.GeometryLayout.XYZ, flatCoordinates); return lineString; } else { return undefined; } }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @private * @return {Array.|undefined} LinearRing flat coordinates. */ ol.format.GMLBase.prototype.readFlatLinearRing_ = function(node, objectStack) { goog.asserts.assert(node.nodeType == goog.dom.NodeType.ELEMENT); goog.asserts.assert(node.localName == 'LinearRing'); var ring = ol.xml.pushParseAndPop(/** @type {Array.} */(null), this.GEOMETRY_FLAT_COORDINATES_PARSERS_, node, objectStack, this); if (goog.isDefAndNotNull(ring)) { return ring; } else { return undefined; } }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @return {ol.geom.LinearRing|undefined} LinearRing. */ ol.format.GMLBase.prototype.readLinearRing = function(node, objectStack) { goog.asserts.assert(node.nodeType == goog.dom.NodeType.ELEMENT); goog.asserts.assert(node.localName == 'LinearRing'); var flatCoordinates = this.readFlatCoordinatesFromNode_(node, objectStack); if (goog.isDef(flatCoordinates)) { var ring = new ol.geom.LinearRing(null); ring.setFlatCoordinates(ol.geom.GeometryLayout.XYZ, flatCoordinates); return ring; } else { return undefined; } }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @return {ol.geom.Polygon|undefined} Polygon. */ ol.format.GMLBase.prototype.readPolygon = function(node, objectStack) { goog.asserts.assert(node.nodeType == goog.dom.NodeType.ELEMENT); goog.asserts.assert(node.localName == 'Polygon'); var flatLinearRings = ol.xml.pushParseAndPop( /** @type {Array.>} */ ([null]), this.FLAT_LINEAR_RINGS_PARSERS_, node, objectStack, this); if (goog.isDef(flatLinearRings) && !goog.isNull(flatLinearRings[0])) { var polygon = new ol.geom.Polygon(null); var flatCoordinates = flatLinearRings[0]; var ends = [flatCoordinates.length]; var i, ii; for (i = 1, ii = flatLinearRings.length; i < ii; ++i) { goog.array.extend(flatCoordinates, flatLinearRings[i]); ends.push(flatCoordinates.length); } polygon.setFlatCoordinates( ol.geom.GeometryLayout.XYZ, flatCoordinates, ends); return polygon; } else { return undefined; } }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @private * @return {Array.} Flat coordinates. */ ol.format.GMLBase.prototype.readFlatCoordinatesFromNode_ = function(node, objectStack) { goog.asserts.assert(node.nodeType == goog.dom.NodeType.ELEMENT); return /** @type {Array.} */ (ol.xml.pushParseAndPop( null, this.GEOMETRY_FLAT_COORDINATES_PARSERS_, node, objectStack, this)); }; /** * @const * @type {Object.>} * @private */ ol.format.GMLBase.prototype.MULTIPOINT_PARSERS_ = Object({ 'http://www.opengis.net/gml' : { 'pointMember': ol.xml.makeArrayPusher( ol.format.GMLBase.prototype.pointMemberParser_), 'pointMembers': ol.xml.makeArrayPusher( ol.format.GMLBase.prototype.pointMemberParser_) } }); /** * @const * @type {Object.>} * @private */ ol.format.GMLBase.prototype.MULTILINESTRING_PARSERS_ = Object({ 'http://www.opengis.net/gml' : { 'lineStringMember': ol.xml.makeArrayPusher( ol.format.GMLBase.prototype.lineStringMemberParser_), 'lineStringMembers': ol.xml.makeArrayPusher( ol.format.GMLBase.prototype.lineStringMemberParser_) } }); /** * @const * @type {Object.>} * @private */ ol.format.GMLBase.prototype.MULTIPOLYGON_PARSERS_ = Object({ 'http://www.opengis.net/gml' : { 'polygonMember': ol.xml.makeArrayPusher( ol.format.GMLBase.prototype.polygonMemberParser_), 'polygonMembers': ol.xml.makeArrayPusher( ol.format.GMLBase.prototype.polygonMemberParser_) } }); /** * @const * @type {Object.>} * @private */ ol.format.GMLBase.prototype.POINTMEMBER_PARSERS_ = Object({ 'http://www.opengis.net/gml' : { 'Point': ol.xml.makeArrayPusher( ol.format.GMLBase.prototype.readFlatCoordinatesFromNode_) } }); /** * @const * @type {Object.>} * @private */ ol.format.GMLBase.prototype.LINESTRINGMEMBER_PARSERS_ = Object({ 'http://www.opengis.net/gml' : { 'LineString': ol.xml.makeArrayPusher( ol.format.GMLBase.prototype.readLineString) } }); /** * @const * @type {Object.>} * @private */ ol.format.GMLBase.prototype.POLYGONMEMBER_PARSERS_ = Object({ 'http://www.opengis.net/gml' : { 'Polygon': ol.xml.makeArrayPusher( ol.format.GMLBase.prototype.readPolygon) } }); /** * @const * @type {Object.>} * @protected */ ol.format.GMLBase.prototype.RING_PARSERS = Object({ 'http://www.opengis.net/gml' : { 'LinearRing': ol.xml.makeReplacer( ol.format.GMLBase.prototype.readFlatLinearRing_) } }); /** * @inheritDoc */ ol.format.GMLBase.prototype.readGeometryFromNode = function(node, opt_options) { var geometry = this.readGeometryElement(node, [this.getReadOptions(node, goog.isDef(opt_options) ? opt_options : {})]); return goog.isDef(geometry) ? geometry : null; }; /** * Read all features from a GML FeatureCollection. * * @function * @param {ArrayBuffer|Document|Node|Object|string} source Source. * @param {olx.format.ReadOptions=} opt_options Options. * @return {Array.} Features. * @api stable */ ol.format.GMLBase.prototype.readFeatures; /** * @inheritDoc */ ol.format.GMLBase.prototype.readFeaturesFromNode = function(node, opt_options) { var options = { 'featureType': this.featureType, 'featureNS': this.featureNS }; if (goog.isDef(opt_options)) { goog.object.extend(options, this.getReadOptions(node, opt_options)); } return this.readFeatures_(node, [options]); }; /** * @inheritDoc */ ol.format.GMLBase.prototype.readProjectionFromNode = function(node) { return ol.proj.get(goog.isDef(this.srsName_) ? this.srsName_ : node.firstElementChild.getAttribute('srsName')); };