Extending FeatureLoader type and refactoring loadFeaturesXhr
This commit is contained in:
@@ -16,15 +16,19 @@ let withCredentials = false;
|
|||||||
* load features.
|
* load features.
|
||||||
*
|
*
|
||||||
* This function takes an {@link module:ol/extent~Extent} representing the area to be loaded,
|
* This function takes an {@link module:ol/extent~Extent} representing the area to be loaded,
|
||||||
* a `{number}` representing the resolution (map units per pixel) and an
|
* a `{number}` representing the resolution (map units per pixel), an
|
||||||
* {@link module:ol/proj/Projection} for the projection as
|
* {@link module:ol/proj/Projection} for the projection and success and failure callbacks as
|
||||||
* arguments. `this` within the function is bound to the
|
* arguments. `this` within the function is bound to the
|
||||||
* {@link module:ol/source/Vector} it's called from.
|
* {@link module:ol/source/Vector} it's called from.
|
||||||
*
|
*
|
||||||
* The function is responsible for loading the features and adding them to the
|
* The function is responsible for loading the features and adding them to the
|
||||||
* source.
|
* source.
|
||||||
* @typedef {function(this:(import("./source/Vector").default|import("./VectorTile.js").default), import("./extent.js").Extent, number,
|
* @typedef {function(this:(import("./source/Vector").default|import("./VectorTile.js").default),
|
||||||
* import("./proj/Projection.js").default): void} FeatureLoader
|
* import("./extent.js").Extent,
|
||||||
|
* number,
|
||||||
|
* import("./proj/Projection.js").default,
|
||||||
|
* function(): void=,
|
||||||
|
* function(): void=): void} FeatureLoader
|
||||||
* @api
|
* @api
|
||||||
*/
|
*/
|
||||||
|
|
||||||
@@ -43,81 +47,77 @@ let withCredentials = false;
|
|||||||
/**
|
/**
|
||||||
* @param {string|FeatureUrlFunction} url Feature URL service.
|
* @param {string|FeatureUrlFunction} url Feature URL service.
|
||||||
* @param {import("./format/Feature.js").default} format Feature format.
|
* @param {import("./format/Feature.js").default} format Feature format.
|
||||||
* @param {function(this:import("./VectorTile.js").default, Array<import("./Feature.js").default>, import("./proj/Projection.js").default, import("./extent.js").Extent): void|function(this:import("./source/Vector").default, Array<import("./Feature.js").default>): void} success
|
* @param {import("./extent.js").Extent} extent Extent.
|
||||||
* Function called with the loaded features and optionally with the data
|
* @param {number} resolution Resolution.
|
||||||
* projection. Called with the vector tile or source as `this`.
|
* @param {import("./proj/Projection.js").default} projection Projection.
|
||||||
* @param {function(this:import("./VectorTile.js").default): void|function(this:import("./source/Vector").default): void} failure
|
* @param {function(Array<import("./Feature.js").default>, import("./proj/Projection.js").default): void} success Success
|
||||||
* Function called when loading failed. Called with the vector tile or
|
* Function called with the loaded features and optionally with the data projection.
|
||||||
* source as `this`.
|
* @param {function(): void} failure Failure
|
||||||
* @return {FeatureLoader} The feature loader.
|
* Function called when loading failed.
|
||||||
*/
|
*/
|
||||||
export function loadFeaturesXhr(url, format, success, failure) {
|
export function loadFeaturesXhr(
|
||||||
return (
|
url,
|
||||||
/**
|
format,
|
||||||
* @param {import("./extent.js").Extent} extent Extent.
|
extent,
|
||||||
* @param {number} resolution Resolution.
|
resolution,
|
||||||
* @param {import("./proj/Projection.js").default} projection Projection.
|
projection,
|
||||||
* @this {import("./source/Vector").default|import("./VectorTile.js").default}
|
success,
|
||||||
*/
|
failure
|
||||||
function (extent, resolution, projection) {
|
) {
|
||||||
const xhr = new XMLHttpRequest();
|
const xhr = new XMLHttpRequest();
|
||||||
xhr.open(
|
xhr.open(
|
||||||
'GET',
|
'GET',
|
||||||
typeof url === 'function' ? url(extent, resolution, projection) : url,
|
typeof url === 'function' ? url(extent, resolution, projection) : url,
|
||||||
true
|
true
|
||||||
);
|
|
||||||
if (format.getType() == FormatType.ARRAY_BUFFER) {
|
|
||||||
xhr.responseType = 'arraybuffer';
|
|
||||||
}
|
|
||||||
xhr.withCredentials = withCredentials;
|
|
||||||
/**
|
|
||||||
* @param {Event} event Event.
|
|
||||||
* @private
|
|
||||||
*/
|
|
||||||
xhr.onload = function (event) {
|
|
||||||
// status will be 0 for file:// urls
|
|
||||||
if (!xhr.status || (xhr.status >= 200 && xhr.status < 300)) {
|
|
||||||
const type = format.getType();
|
|
||||||
/** @type {Document|Node|Object|string|undefined} */
|
|
||||||
let source;
|
|
||||||
if (type == FormatType.JSON || type == FormatType.TEXT) {
|
|
||||||
source = xhr.responseText;
|
|
||||||
} else if (type == FormatType.XML) {
|
|
||||||
source = xhr.responseXML;
|
|
||||||
if (!source) {
|
|
||||||
source = new DOMParser().parseFromString(
|
|
||||||
xhr.responseText,
|
|
||||||
'application/xml'
|
|
||||||
);
|
|
||||||
}
|
|
||||||
} else if (type == FormatType.ARRAY_BUFFER) {
|
|
||||||
source = /** @type {ArrayBuffer} */ (xhr.response);
|
|
||||||
}
|
|
||||||
if (source) {
|
|
||||||
success.call(
|
|
||||||
this,
|
|
||||||
format.readFeatures(source, {
|
|
||||||
extent: extent,
|
|
||||||
featureProjection: projection,
|
|
||||||
}),
|
|
||||||
format.readProjection(source)
|
|
||||||
);
|
|
||||||
} else {
|
|
||||||
failure.call(this);
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
failure.call(this);
|
|
||||||
}
|
|
||||||
}.bind(this);
|
|
||||||
/**
|
|
||||||
* @private
|
|
||||||
*/
|
|
||||||
xhr.onerror = function () {
|
|
||||||
failure.call(this);
|
|
||||||
}.bind(this);
|
|
||||||
xhr.send();
|
|
||||||
}
|
|
||||||
);
|
);
|
||||||
|
if (format.getType() == FormatType.ARRAY_BUFFER) {
|
||||||
|
xhr.responseType = 'arraybuffer';
|
||||||
|
}
|
||||||
|
xhr.withCredentials = withCredentials;
|
||||||
|
/**
|
||||||
|
* @param {Event} event Event.
|
||||||
|
* @private
|
||||||
|
*/
|
||||||
|
xhr.onload = function (event) {
|
||||||
|
// status will be 0 for file:// urls
|
||||||
|
if (!xhr.status || (xhr.status >= 200 && xhr.status < 300)) {
|
||||||
|
const type = format.getType();
|
||||||
|
/** @type {Document|Node|Object|string|undefined} */
|
||||||
|
let source;
|
||||||
|
if (type == FormatType.JSON || type == FormatType.TEXT) {
|
||||||
|
source = xhr.responseText;
|
||||||
|
} else if (type == FormatType.XML) {
|
||||||
|
source = xhr.responseXML;
|
||||||
|
if (!source) {
|
||||||
|
source = new DOMParser().parseFromString(
|
||||||
|
xhr.responseText,
|
||||||
|
'application/xml'
|
||||||
|
);
|
||||||
|
}
|
||||||
|
} else if (type == FormatType.ARRAY_BUFFER) {
|
||||||
|
source = /** @type {ArrayBuffer} */ (xhr.response);
|
||||||
|
}
|
||||||
|
if (source) {
|
||||||
|
success(
|
||||||
|
/** @type {Array<import("./Feature.js").default>} */
|
||||||
|
(format.readFeatures(source, {
|
||||||
|
extent: extent,
|
||||||
|
featureProjection: projection,
|
||||||
|
})),
|
||||||
|
format.readProjection(source)
|
||||||
|
);
|
||||||
|
} else {
|
||||||
|
failure();
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
failure();
|
||||||
|
}
|
||||||
|
};
|
||||||
|
/**
|
||||||
|
* @private
|
||||||
|
*/
|
||||||
|
xhr.onerror = failure;
|
||||||
|
xhr.send();
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -130,25 +130,35 @@ export function loadFeaturesXhr(url, format, success, failure) {
|
|||||||
* @api
|
* @api
|
||||||
*/
|
*/
|
||||||
export function xhr(url, format) {
|
export function xhr(url, format) {
|
||||||
return loadFeaturesXhr(
|
/**
|
||||||
url,
|
* @param {import("./extent.js").Extent} extent Extent.
|
||||||
format,
|
* @param {number} resolution Resolution.
|
||||||
/**
|
* @param {import("./proj/Projection.js").default} projection Projection.
|
||||||
* @param {Array<import("./Feature.js").default>} features The loaded features.
|
* @param {function(): void} success Success
|
||||||
* @param {import("./proj/Projection.js").default} dataProjection Data
|
* Function called when loading succeeded.
|
||||||
* projection.
|
* @param {function(): void} failure Failure
|
||||||
* @this {import("./source/Vector").default|import("./VectorTile.js").default}
|
* Function called when loading failed.
|
||||||
*/
|
* @this {import("./source/Vector").default}
|
||||||
function (features, dataProjection) {
|
*/
|
||||||
const sourceOrTile = /** @type {?} */ (this);
|
return function (extent, resolution, projection, success, failure) {
|
||||||
if (typeof sourceOrTile.addFeatures === 'function') {
|
const sourceOrTile = /** @type {import("./source/Vector").default} */ (this);
|
||||||
/** @type {import("./source/Vector").default} */ (sourceOrTile).addFeatures(
|
loadFeaturesXhr(
|
||||||
features
|
url,
|
||||||
);
|
format,
|
||||||
}
|
extent,
|
||||||
},
|
resolution,
|
||||||
/* FIXME handle error */ VOID
|
projection,
|
||||||
);
|
/**
|
||||||
|
* @param {Array<import("./Feature.js").default>} features The loaded features.
|
||||||
|
* @param {import("./proj/Projection.js").default} dataProjection Data
|
||||||
|
* projection.
|
||||||
|
*/
|
||||||
|
function (features, dataProjection) {
|
||||||
|
sourceOrTile.addFeatures(features);
|
||||||
|
},
|
||||||
|
/* FIXME handle error */ VOID
|
||||||
|
);
|
||||||
|
};
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|||||||
@@ -528,11 +528,22 @@ export default VectorTile;
|
|||||||
* @param {string} url URL.
|
* @param {string} url URL.
|
||||||
*/
|
*/
|
||||||
export function defaultLoadFunction(tile, url) {
|
export function defaultLoadFunction(tile, url) {
|
||||||
const loader = loadFeaturesXhr(
|
tile.setLoader(
|
||||||
url,
|
/**
|
||||||
tile.getFormat(),
|
* @param {import("../extent.js").Extent} extent Extent.
|
||||||
tile.onLoad.bind(tile),
|
* @param {number} resolution Resolution.
|
||||||
tile.onError.bind(tile)
|
* @param {import("../proj/Projection.js").default} projection Projection.
|
||||||
|
*/
|
||||||
|
function (extent, resolution, projection) {
|
||||||
|
loadFeaturesXhr(
|
||||||
|
url,
|
||||||
|
tile.getFormat(),
|
||||||
|
extent,
|
||||||
|
resolution,
|
||||||
|
projection,
|
||||||
|
tile.onLoad.bind(tile),
|
||||||
|
tile.onError.bind(tile)
|
||||||
|
);
|
||||||
|
}
|
||||||
);
|
);
|
||||||
tile.setLoader(loader);
|
|
||||||
}
|
}
|
||||||
|
|||||||
Reference in New Issue
Block a user