diff --git a/src/dzitilesource.js b/src/dzitilesource.js index f600a4d1..633c0371 100644 --- a/src/dzitilesource.js +++ b/src/dzitilesource.js @@ -124,10 +124,11 @@ $.extend( $.DziTileSource.prototype, $.TileSource.prototype, /** @lends OpenSead * @function * @param {Object|XMLDocument} data - the raw configuration * @param {String} url - the url the data was retrieved from if any. + * @param {String} postData - data for the post request or null * @return {Object} options - A dictionary of keyword arguments sufficient * to configure this tile sources constructor. */ - configure: function( data, url ){ + configure: function( data, url, postData ){ var options; diff --git a/src/iiiftilesource.js b/src/iiiftilesource.js index 76479e76..5450b612 100644 --- a/src/iiiftilesource.js +++ b/src/iiiftilesource.js @@ -183,6 +183,8 @@ $.extend( $.IIIFTileSource.prototype, $.TileSource.prototype, /** @lends OpenSea * * @function * @param {Object} data - the raw configuration + * @param {String} url - the url configuration was retrieved from + * @param {String} postData - data for the post request or null * @example IIIF 1.1 Info Looks like this * { * "@context" : "http://library.stanford.edu/iiif/image-api/1.1/context.json", @@ -197,7 +199,7 @@ $.extend( $.IIIFTileSource.prototype, $.TileSource.prototype, /** @lends OpenSea * "profile" : "http://library.stanford.edu/iiif/image-api/1.1/compliance.html#level0" * } */ - configure: function( data, url ){ + configure: function( data, url, postData ){ // Try to deduce our version and fake it upwards if needed if ( !$.isPlainObject(data) ) { var options = configureFromXml10( data ); diff --git a/src/imageloader.js b/src/imageloader.js index faa1fac8..b48e1d55 100644 --- a/src/imageloader.js +++ b/src/imageloader.js @@ -43,6 +43,7 @@ * @param {String} [options.loadWithAjax] - Whether to load this image with AJAX. * @param {String} [options.ajaxHeaders] - Headers to add to the image request if using AJAX. * @param {String} [options.crossOriginPolicy] - CORS policy to use for downloads + * @param {String} [options.postData] - POST parameters or null * @param {Function} [options.callback] - Called once image has been downloaded. * @param {Function} [options.abort] - Called when this image job is aborted. * @param {Number} [options.timeout] - The max number of milliseconds that this image job may take to complete. @@ -96,6 +97,7 @@ ImageJob.prototype = { withCredentials: this.ajaxWithCredentials, headers: this.ajaxHeaders, responseType: "arraybuffer", + postData: this.postData, success: function(request) { var blb; // Make the raw data into a blob. @@ -196,6 +198,7 @@ $.ImageLoader.prototype = { * @param {String} [options.loadWithAjax] - Whether to load this image with AJAX. * @param {String} [options.ajaxHeaders] - Headers to add to the image request if using AJAX. * @param {String|Boolean} [options.crossOriginPolicy] - CORS policy to use for downloads + * @param {String} [options.postData] - POST parameters in k=v&k2=v2... form or null * @param {Boolean} [options.ajaxWithCredentials] - Whether to set withCredentials on AJAX * requests. * @param {Function} [options.callback] - Called once image has been downloaded. @@ -212,6 +215,7 @@ $.ImageLoader.prototype = { ajaxHeaders: options.loadWithAjax ? options.ajaxHeaders : null, crossOriginPolicy: options.crossOriginPolicy, ajaxWithCredentials: options.ajaxWithCredentials, + postData: options.postData, callback: complete, abort: options.abort, timeout: this.timeout diff --git a/src/imagetilesource.js b/src/imagetilesource.js index 25f67988..cc0d2619 100644 --- a/src/imagetilesource.js +++ b/src/imagetilesource.js @@ -89,10 +89,11 @@ * @function * @param {Object} options - the options * @param {String} dataUrl - the url the image was retrieved from, if any. + * @param {String} postData - data for the post request or null * @return {Object} options - A dictionary of keyword arguments sufficient * to configure this tile sources constructor. */ - configure: function (options, dataUrl) { + configure: function (options, dataUrl, postData) { return options; }, /** diff --git a/src/legacytilesource.js b/src/legacytilesource.js index c1c5e253..cdf0cbc9 100644 --- a/src/legacytilesource.js +++ b/src/legacytilesource.js @@ -122,10 +122,11 @@ $.extend( $.LegacyTileSource.prototype, $.TileSource.prototype, /** @lends OpenS * @function * @param {Object|XMLDocument} configuration - the raw configuration * @param {String} dataUrl - the url the data was retrieved from if any. + * @param {String} postData - data for the post request or null * @return {Object} options - A dictionary of keyword arguments sufficient * to configure this tile sources constructor. */ - configure: function( configuration, dataUrl ){ + configure: function( configuration, dataUrl, postData ){ var options; diff --git a/src/openseadragon.js b/src/openseadragon.js index 5b0accb0..68761635 100644 --- a/src/openseadragon.js +++ b/src/openseadragon.js @@ -2273,6 +2273,7 @@ function OpenSeadragon( options ){ * @param {Function} options.error - a function to call on when an error occurs * @param {Object} options.headers - headers to add to the AJAX request * @param {String} options.responseType - the response type of the the AJAX request + * @param {String} options.postData - HTTP POST data in k=v&k2=v2... form, GET method used if null * @param {Boolean} [options.withCredentials=false] - whether to set the XHR's withCredentials * @throws {Error} * @returns {XMLHttpRequest} @@ -2281,6 +2282,7 @@ function OpenSeadragon( options ){ var withCredentials; var headers; var responseType; + var postData; // Note that our preferred API is that you pass in a single object; the named // arguments are for legacy support. @@ -2290,6 +2292,7 @@ function OpenSeadragon( options ){ withCredentials = url.withCredentials; headers = url.headers; responseType = url.responseType || null; + postData = url.postData || null; url = url.url; } @@ -2322,8 +2325,9 @@ function OpenSeadragon( options ){ } }; + var method = postData ? "POST" : "GET"; try { - request.open( "GET", url, true ); + request.open( method, url, true ); if (responseType) { request.responseType = responseType; @@ -2341,7 +2345,7 @@ function OpenSeadragon( options ){ request.withCredentials = true; } - request.send(null); + request.send(postData); } catch (e) { $.console.log( "%s while making AJAX request: %s", e.name, e.message ); diff --git a/src/osmtilesource.js b/src/osmtilesource.js index c28945bb..d5a11163 100644 --- a/src/osmtilesource.js +++ b/src/osmtilesource.js @@ -122,10 +122,11 @@ $.extend( $.OsmTileSource.prototype, $.TileSource.prototype, /** @lends OpenSead * @function * @param {Object} data - the raw configuration * @param {String} url - the url the data was retrieved from if any. + * @param {String} postData - data for the post request or null * @return {Object} options - A dictionary of keyword arguments sufficient * to configure this tile sources constructor. */ - configure: function( data, url ){ + configure: function( data, url, postData ){ return data; }, diff --git a/src/tile.js b/src/tile.js index 701db750..e8a97da9 100644 --- a/src/tile.js +++ b/src/tile.js @@ -45,6 +45,7 @@ * @param {Boolean} exists Is this tile a part of a sparse image? ( Also has * this tile failed to load? ) * @param {String} url The URL of this tile's image. + * @param {String} postData post parameters or null * @param {CanvasRenderingContext2D} context2D The context2D of this tile if it * is provided directly by the tile source. * @param {Boolean} loadWithAjax Whether this tile image should be loaded with an AJAX request . @@ -53,7 +54,7 @@ * drawing operation, in pixels. Note that this only works when drawing with canvas; when drawing * with HTML the entire tile is always used. */ -$.Tile = function(level, x, y, bounds, exists, url, context2D, loadWithAjax, ajaxHeaders, sourceBounds) { +$.Tile = function(level, x, y, bounds, exists, url, postData, context2D, loadWithAjax, ajaxHeaders, sourceBounds) { /** * The zoom level this tile belongs to. * @member {Number} level @@ -97,6 +98,13 @@ $.Tile = function(level, x, y, bounds, exists, url, context2D, loadWithAjax, aja * @memberof OpenSeadragon.Tile# */ this.url = url; + /** + * Post parameters for this tile. Either it is an URL-encoded string + * in k1=v1&k2=v2... format or null + * @member {String} postData + * @memberof OpenSeadragon.Tile# + */ + this.postData = postData; /** * The context2D of this tile if it is provided directly by the tile source. * @member {CanvasRenderingContext2D} context2D diff --git a/src/tiledimage.js b/src/tiledimage.js index 82e35ed7..39f195f2 100644 --- a/src/tiledimage.js +++ b/src/tiledimage.js @@ -1490,6 +1490,7 @@ function getTile( sourceBounds, exists, url, + post, ajaxHeaders, context2D, tile; @@ -1508,6 +1509,7 @@ function getTile( sourceBounds = tileSource.getTileBounds( level, xMod, yMod, true ); exists = tileSource.tileExists( level, xMod, yMod ); url = tileSource.getTileUrl( level, xMod, yMod ); + post = tileSource.getTilePostData( level, xMod, yMod ); // Headers are only applicable if loadTilesWithAjax is set if (tiledImage.loadTilesWithAjax) { @@ -1530,6 +1532,7 @@ function getTile( bounds, exists, url, + post, context2D, tiledImage.loadTilesWithAjax, ajaxHeaders, @@ -1573,6 +1576,7 @@ function loadTile( tiledImage, tile, time ) { tile.loading = true; tiledImage._imageLoader.addJob({ src: tile.url, + postData: tile.postData, loadWithAjax: tile.loadWithAjax, ajaxHeaders: tile.ajaxHeaders, crossOriginPolicy: tiledImage.crossOriginPolicy, diff --git a/src/tilesource.js b/src/tilesource.js index aab7f134..8c66258e 100644 --- a/src/tilesource.js +++ b/src/tilesource.js @@ -426,6 +426,13 @@ $.TileSource.prototype = { } } + var postData = null; + var hashIdx = url.indexOf("#"); + if (hashIdx !== -1) { + postData = url.substring(hashIdx + 1); + url = url.substr(0, hashIdx - 1); + } + callback = function( data ){ if( typeof (data) === "string" ) { data = $.parseXml( data ); @@ -447,7 +454,7 @@ $.TileSource.prototype = { return; } - options = $TileSource.prototype.configure.apply( _this, [ data, url ]); + options = $TileSource.prototype.configure.apply( _this, [ data, url, postData ]); if (options.ajaxWithCredentials === undefined) { options.ajaxWithCredentials = _this.ajaxWithCredentials; } @@ -482,6 +489,7 @@ $.TileSource.prototype = { // request info via xhr asynchronously. $.makeAjaxRequest( { url: url, + postData: postData, withCredentials: this.ajaxWithCredentials, headers: this.ajaxHeaders, success: function( xhr ) { @@ -559,11 +567,12 @@ $.TileSource.prototype = { * @param {String|Object|Array|Document} data * @param {String} url - the url the data was loaded * from if any. + * @param {String} postData value obtained from the url after '#' sign or null * @return {Object} options - A dictionary of keyword arguments sufficient * to configure this tile sources constructor. * @throws {Error} */ - configure: function( data, url ) { + configure: function( data, url, postData ) { throw new Error( "Method not implemented." ); }, @@ -584,6 +593,20 @@ $.TileSource.prototype = { throw new Error( "Method not implemented." ); }, + /** + * Must use AJAX in order to work, i.e. loadTilesWithAjax = true is set. + * It should return url-encoded string with the following structure: + * key=value&key2=value2... + * or null in case GET is used instead. + * @param level + * @param x + * @param y + * @return {string || null} post data to send with tile configuration request + */ + getTilePostData: function( level, x, y ) { + return null; + }, + /** * Responsible for retrieving the headers which will be attached to the image request for the * region specified by the given x, y, and level components. diff --git a/src/tmstilesource.js b/src/tmstilesource.js index abb8f2db..355ffa99 100644 --- a/src/tmstilesource.js +++ b/src/tmstilesource.js @@ -111,10 +111,11 @@ $.extend( $.TmsTileSource.prototype, $.TileSource.prototype, /** @lends OpenSead * @function * @param {Object} data - the raw configuration * @param {String} url - the url the data was retrieved from if any. + * @param {String} postData - data for the post request or null * @return {Object} options - A dictionary of keyword arguments sufficient * to configure this tile sources constructor. */ - configure: function( data, url ){ + configure: function( data, url, postData ){ return data; }, diff --git a/src/zoomifytilesource.js b/src/zoomifytilesource.js index 9ffa4988..540b2695 100644 --- a/src/zoomifytilesource.js +++ b/src/zoomifytilesource.js @@ -122,10 +122,11 @@ * @function * @param {Object} data - the raw configuration * @param {String} url - the url the data was retrieved from if any. + * @param {String} postData - data for the post request or null * @return {Object} options - A dictionary of keyword arguments sufficient * to configure this tile sources constructor. */ - configure: function(data, url) { + configure: function(data, url, postData) { return data; },