mediawiki-extensions-Multim.../resources/mmv/provider/mmv.provider.ImageUsage.js
Gergő Tisza 284a936aff Cache API responses
Cache API responses, both on Varnish and in the user's browser.
The imageinfo request is not cached, since that would make it very
hard to test metadata template edits. Everything else is cached for
one day.

Change-Id: I9149cf40d4448a424073eefd1eb442c70c977687
Mingle: https://wikimedia.mingle.thoughtworks.com/projects/multimedia/cards/435
2014-04-22 10:56:52 +02:00

83 lines
2.7 KiB
JavaScript

/*
* This file is part of the MediaWiki extension MultimediaViewer.
*
* MultimediaViewer is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 2 of the License, or
* (at your option) any later version.
*
* MultimediaViewer is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with MultimediaViewer. If not, see <http://www.gnu.org/licenses/>.
*/
( function ( mw, oo, $ ) {
/**
* Gets file usage information on the local wiki.
* @class mw.mmv.provider.ImageUsage
* @extends mw.mmv.provider.Api
* @constructor
* @param {mw.Api} api
* @param {Object} [options]
* @cfg {number[]} [namespaces=[0, 100]] list of namespace ids
* @cfg {number} [apiLimit=100] number of entries to get from the API. If there are
* more pages than this, we won't have an accurate count.
* (Also, influences query performance.)
* @cfg {number} [dataLimit=10] number of entries to actually put into the model.
* @cfg {number} [maxage] cache expiration time, in seconds
* Will be used for both client-side cache (maxage) and reverse proxies (s-maxage)
*/
function ImageUsage( api, options ) {
options = $.extend( {
apiLimit: 100,
dataLimit: 10
}, options );
mw.mmv.provider.Api.call( this, api, options );
}
oo.inheritClass( ImageUsage, mw.mmv.provider.Api );
/**
* Runs an API GET request to get the image usage.
* @param {mw.Title} file
* @return {jQuery.Promise}
*/
ImageUsage.prototype.get = function( file ) {
var provider = this;
return this.getCachedPromise( file.getPrefixedDb(), function () {
return provider.apiGetWithMaxAge( {
action: 'query',
list: 'imageusage',
iutitle: file.getPrefixedDb(),
iunamespace: provider.options.namespaces,
iulimit: provider.options.apiLimit
} ).then( function( data ) {
return provider.getQueryField( 'imageusage', data );
} ).then( function( imageusage, data ) {
var pages;
pages = $.map( imageusage, function( item ) {
return {
wiki: null,
page: new mw.Title( item.title, item.ns )
};
} );
return new mw.mmv.model.FileUsage(
file,
mw.mmv.model.FileUsage.Scope.LOCAL,
pages.slice( 0, provider.options.dataLimit ),
pages.length,
!!( data['query-continue'] && data['query-continue'].imageusage )
);
} );
} );
};
mw.mmv.provider.ImageUsage = ImageUsage;
}( mediaWiki, OO, jQuery ) );