/** * @module ol/format/GMLBase */ // 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! import {inherits} from '../index.js'; import {extend} from '../array.js'; import Feature from '../Feature.js'; import {transformWithOptions} from '../format/Feature.js'; import XMLFeature from '../format/XMLFeature.js'; import GeometryLayout from '../geom/GeometryLayout.js'; import LineString from '../geom/LineString.js'; import LinearRing from '../geom/LinearRing.js'; import MultiLineString from '../geom/MultiLineString.js'; import MultiPoint from '../geom/MultiPoint.js'; import MultiPolygon from '../geom/MultiPolygon.js'; import Point from '../geom/Point.js'; import Polygon from '../geom/Polygon.js'; import {assign} from '../obj.js'; import {get as getProjection} from '../proj.js'; import _ol_xml_ from '../xml.js'; /** * @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 instantiated, it contains only base content that * is shared with versioned format classes ol.format.GML2 and * ol.format.GML3. * * @constructor * @abstract * @param {olx.format.GMLOptions=} opt_options * Optional configuration object. * @extends {ol.format.XMLFeature} */ const GMLBase = function(opt_options) { const options = /** @type {olx.format.GMLOptions} */ (opt_options ? opt_options : {}); /** * @protected * @type {Array.|string|undefined} */ this.featureType = options.featureType; /** * @protected * @type {Object.|string|undefined} */ this.featureNS = options.featureNS; /** * @protected * @type {string} */ this.srsName = options.srsName; /** * @protected * @type {string} */ this.schemaLocation = ''; /** * @type {Object.>} */ this.FEATURE_COLLECTION_PARSERS = {}; this.FEATURE_COLLECTION_PARSERS[GMLBase.GMLNS] = { 'featureMember': _ol_xml_.makeReplacer( GMLBase.prototype.readFeaturesInternal), 'featureMembers': _ol_xml_.makeReplacer( GMLBase.prototype.readFeaturesInternal) }; XMLFeature.call(this); }; inherits(GMLBase, XMLFeature); /** * @const * @type {string} */ GMLBase.GMLNS = 'http://www.opengis.net/gml'; /** * A regular expression that matches if a string only contains whitespace * characters. It will e.g. match `''`, `' '`, `'\n'` etc. The non-breaking * space (0xa0) is explicitly included as IE doesn't include it in its * definition of `\s`. * * Information from `goog.string.isEmptyOrWhitespace`: https://github.com/google/closure-library/blob/e877b1e/closure/goog/string/string.js#L156-L160 * * @const * @type {RegExp} * @private */ GMLBase.ONLY_WHITESPACE_RE_ = /^[\s\xa0]*$/; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @return {Array. | undefined} Features. */ GMLBase.prototype.readFeaturesInternal = function(node, objectStack) { const localName = node.localName; let features = null; if (localName == 'FeatureCollection') { if (node.namespaceURI === 'http://www.opengis.net/wfs') { features = _ol_xml_.pushParseAndPop([], this.FEATURE_COLLECTION_PARSERS, node, objectStack, this); } else { features = _ol_xml_.pushParseAndPop(null, this.FEATURE_COLLECTION_PARSERS, node, objectStack, this); } } else if (localName == 'featureMembers' || localName == 'featureMember') { const context = objectStack[0]; let featureType = context['featureType']; let featureNS = context['featureNS']; let i, ii; const prefix = 'p'; const defaultPrefix = 'p0'; if (!featureType && node.childNodes) { featureType = [], featureNS = {}; for (i = 0, ii = node.childNodes.length; i < ii; ++i) { const child = node.childNodes[i]; if (child.nodeType === 1) { const ft = child.nodeName.split(':').pop(); if (featureType.indexOf(ft) === -1) { let key = ''; let count = 0; const uri = child.namespaceURI; for (const candidate in featureNS) { if (featureNS[candidate] === uri) { key = candidate; break; } ++count; } if (!key) { key = prefix + count; featureNS[key] = uri; } featureType.push(key + ':' + ft); } } } if (localName != 'featureMember') { // recheck featureType for each featureMember context['featureType'] = featureType; context['featureNS'] = featureNS; } } if (typeof featureNS === 'string') { const ns = featureNS; featureNS = {}; featureNS[defaultPrefix] = ns; } const parsersNS = {}; const featureTypes = Array.isArray(featureType) ? featureType : [featureType]; for (const p in featureNS) { const parsers = {}; for (i = 0, ii = featureTypes.length; i < ii; ++i) { const featurePrefix = featureTypes[i].indexOf(':') === -1 ? defaultPrefix : featureTypes[i].split(':')[0]; if (featurePrefix === p) { parsers[featureTypes[i].split(':').pop()] = (localName == 'featureMembers') ? _ol_xml_.makeArrayPusher(this.readFeatureElement, this) : _ol_xml_.makeReplacer(this.readFeatureElement, this); } } parsersNS[featureNS[p]] = parsers; } if (localName == 'featureMember') { features = _ol_xml_.pushParseAndPop(undefined, parsersNS, node, objectStack); } else { features = _ol_xml_.pushParseAndPop([], parsersNS, node, objectStack); } } if (features === null) { features = []; } return features; }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @return {ol.geom.Geometry|undefined} Geometry. */ GMLBase.prototype.readGeometryElement = function(node, objectStack) { const context = /** @type {Object} */ (objectStack[0]); context['srsName'] = node.firstElementChild.getAttribute('srsName'); context['srsDimension'] = node.firstElementChild.getAttribute('srsDimension'); /** @type {ol.geom.Geometry} */ const geometry = _ol_xml_.pushParseAndPop(null, this.GEOMETRY_PARSERS_, node, objectStack, this); if (geometry) { return ( /** @type {ol.geom.Geometry} */ transformWithOptions(geometry, false, context) ); } else { return undefined; } }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @return {ol.Feature} Feature. */ GMLBase.prototype.readFeatureElement = function(node, objectStack) { let n; const fid = node.getAttribute('fid') || _ol_xml_.getAttributeNS(node, GMLBase.GMLNS, 'id'); const values = {}; let geometryName; for (n = node.firstElementChild; n; n = n.nextElementSibling) { const localName = n.localName; // Assume attribute elements have one child node and that the child // is a text or CDATA node (to be treated as text). // Otherwise assume it is a geometry node. if (n.childNodes.length === 0 || (n.childNodes.length === 1 && (n.firstChild.nodeType === 3 || n.firstChild.nodeType === 4))) { let value = _ol_xml_.getAllTextContent(n, false); if (GMLBase.ONLY_WHITESPACE_RE_.test(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); } } const feature = new Feature(values); if (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. */ GMLBase.prototype.readPoint = function(node, objectStack) { const flatCoordinates = this.readFlatCoordinatesFromNode_(node, objectStack); if (flatCoordinates) { const point = new Point(null); point.setFlatCoordinates(GeometryLayout.XYZ, flatCoordinates); return point; } }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @return {ol.geom.MultiPoint|undefined} MultiPoint. */ GMLBase.prototype.readMultiPoint = function(node, objectStack) { /** @type {Array.>} */ const coordinates = _ol_xml_.pushParseAndPop([], this.MULTIPOINT_PARSERS_, node, objectStack, this); if (coordinates) { return new MultiPoint(coordinates); } else { return undefined; } }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @return {ol.geom.MultiLineString|undefined} MultiLineString. */ GMLBase.prototype.readMultiLineString = function(node, objectStack) { /** @type {Array.} */ const lineStrings = _ol_xml_.pushParseAndPop([], this.MULTILINESTRING_PARSERS_, node, objectStack, this); if (lineStrings) { const multiLineString = new 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. */ GMLBase.prototype.readMultiPolygon = function(node, objectStack) { /** @type {Array.} */ const polygons = _ol_xml_.pushParseAndPop([], this.MULTIPOLYGON_PARSERS_, node, objectStack, this); if (polygons) { const multiPolygon = new MultiPolygon(null); multiPolygon.setPolygons(polygons); return multiPolygon; } else { return undefined; } }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @private */ GMLBase.prototype.pointMemberParser_ = function(node, objectStack) { _ol_xml_.parseNode(this.POINTMEMBER_PARSERS_, node, objectStack, this); }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @private */ GMLBase.prototype.lineStringMemberParser_ = function(node, objectStack) { _ol_xml_.parseNode(this.LINESTRINGMEMBER_PARSERS_, node, objectStack, this); }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @private */ GMLBase.prototype.polygonMemberParser_ = function(node, objectStack) { _ol_xml_.parseNode(this.POLYGONMEMBER_PARSERS_, node, objectStack, this); }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @return {ol.geom.LineString|undefined} LineString. */ GMLBase.prototype.readLineString = function(node, objectStack) { const flatCoordinates = this.readFlatCoordinatesFromNode_(node, objectStack); if (flatCoordinates) { const lineString = new LineString(null); lineString.setFlatCoordinates(GeometryLayout.XYZ, flatCoordinates); return lineString; } else { return undefined; } }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @private * @return {Array.|undefined} LinearRing flat coordinates. */ GMLBase.prototype.readFlatLinearRing_ = function(node, objectStack) { const ring = _ol_xml_.pushParseAndPop(null, this.GEOMETRY_FLAT_COORDINATES_PARSERS_, node, objectStack, this); if (ring) { return ring; } else { return undefined; } }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @return {ol.geom.LinearRing|undefined} LinearRing. */ GMLBase.prototype.readLinearRing = function(node, objectStack) { const flatCoordinates = this.readFlatCoordinatesFromNode_(node, objectStack); if (flatCoordinates) { const ring = new LinearRing(null); ring.setFlatCoordinates(GeometryLayout.XYZ, flatCoordinates); return ring; } else { return undefined; } }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @return {ol.geom.Polygon|undefined} Polygon. */ GMLBase.prototype.readPolygon = function(node, objectStack) { /** @type {Array.>} */ const flatLinearRings = _ol_xml_.pushParseAndPop([null], this.FLAT_LINEAR_RINGS_PARSERS_, node, objectStack, this); if (flatLinearRings && flatLinearRings[0]) { const polygon = new Polygon(null); const flatCoordinates = flatLinearRings[0]; const ends = [flatCoordinates.length]; let i, ii; for (i = 1, ii = flatLinearRings.length; i < ii; ++i) { extend(flatCoordinates, flatLinearRings[i]); ends.push(flatCoordinates.length); } polygon.setFlatCoordinates( GeometryLayout.XYZ, flatCoordinates, ends); return polygon; } else { return undefined; } }; /** * @param {Node} node Node. * @param {Array.<*>} objectStack Object stack. * @private * @return {Array.} Flat coordinates. */ GMLBase.prototype.readFlatCoordinatesFromNode_ = function(node, objectStack) { return _ol_xml_.pushParseAndPop(null, this.GEOMETRY_FLAT_COORDINATES_PARSERS_, node, objectStack, this); }; /** * @const * @type {Object.>} * @private */ GMLBase.prototype.MULTIPOINT_PARSERS_ = { 'http://www.opengis.net/gml': { 'pointMember': _ol_xml_.makeArrayPusher( GMLBase.prototype.pointMemberParser_), 'pointMembers': _ol_xml_.makeArrayPusher( GMLBase.prototype.pointMemberParser_) } }; /** * @const * @type {Object.>} * @private */ GMLBase.prototype.MULTILINESTRING_PARSERS_ = { 'http://www.opengis.net/gml': { 'lineStringMember': _ol_xml_.makeArrayPusher( GMLBase.prototype.lineStringMemberParser_), 'lineStringMembers': _ol_xml_.makeArrayPusher( GMLBase.prototype.lineStringMemberParser_) } }; /** * @const * @type {Object.>} * @private */ GMLBase.prototype.MULTIPOLYGON_PARSERS_ = { 'http://www.opengis.net/gml': { 'polygonMember': _ol_xml_.makeArrayPusher( GMLBase.prototype.polygonMemberParser_), 'polygonMembers': _ol_xml_.makeArrayPusher( GMLBase.prototype.polygonMemberParser_) } }; /** * @const * @type {Object.>} * @private */ GMLBase.prototype.POINTMEMBER_PARSERS_ = { 'http://www.opengis.net/gml': { 'Point': _ol_xml_.makeArrayPusher( GMLBase.prototype.readFlatCoordinatesFromNode_) } }; /** * @const * @type {Object.>} * @private */ GMLBase.prototype.LINESTRINGMEMBER_PARSERS_ = { 'http://www.opengis.net/gml': { 'LineString': _ol_xml_.makeArrayPusher( GMLBase.prototype.readLineString) } }; /** * @const * @type {Object.>} * @private */ GMLBase.prototype.POLYGONMEMBER_PARSERS_ = { 'http://www.opengis.net/gml': { 'Polygon': _ol_xml_.makeArrayPusher( GMLBase.prototype.readPolygon) } }; /** * @const * @type {Object.>} * @protected */ GMLBase.prototype.RING_PARSERS = { 'http://www.opengis.net/gml': { 'LinearRing': _ol_xml_.makeReplacer( GMLBase.prototype.readFlatLinearRing_) } }; /** * @inheritDoc */ GMLBase.prototype.readGeometryFromNode = function(node, opt_options) { const geometry = this.readGeometryElement(node, [this.getReadOptions(node, opt_options ? opt_options : {})]); return geometry ? geometry : null; }; /** * Read all features from a GML FeatureCollection. * * @function * @param {Document|Node|Object|string} source Source. * @param {olx.format.ReadOptions=} opt_options Options. * @return {Array.} Features. * @api */ GMLBase.prototype.readFeatures; /** * @inheritDoc */ GMLBase.prototype.readFeaturesFromNode = function(node, opt_options) { const options = { featureType: this.featureType, featureNS: this.featureNS }; if (opt_options) { assign(options, this.getReadOptions(node, opt_options)); } const features = this.readFeaturesInternal(node, [options]); return features || []; }; /** * @inheritDoc */ GMLBase.prototype.readProjectionFromNode = function(node) { return getProjection(this.srsName ? this.srsName : node.firstElementChild.getAttribute('srsName')); }; export default GMLBase;