Current File : /home/jvzmxxx/wiki1/extensions/MobileFrontend/resources/mobile.gallery/PhotoListGateway.js

( function ( M, $ ) {
	var IMAGE_WIDTH = mw.config.get( 'wgMFThumbnailSizes' ).small;

	/**
	 * API for retrieving gallery photos
	 * @class PhotoListApi
	 *
	 * @constructor
	 * @param {Object} options Configuration options
	 * @param {mw.Api} options.api
	 */
	function PhotoListGateway( options ) {
		this.api = options.api;
		this.username = options.username;
		this.category = options.category;
		this.limit = 10;
		this.continueParams = {
			'continue': ''
		};
		this.canContinue = true;
	}

	PhotoListGateway.prototype = {
		/**
		 * Returns a description based on the file name using
		 * a regular expression that strips the file type suffix,
		 * namespace prefix and any
		 * date suffix in format YYYY-MM-DD HH-MM
		 * @method
		 * @private
		 * @param {string} title Title of file
		 * @return {string} Description for file
		 */
		_getDescription: function ( title ) {
			title = title.replace( /\.[^\. ]+$/, '' ); // replace filename suffix
			// strip namespace: prefix and date suffix from remainder
			return title.replace( /^[^:]*:/, '' )
				.replace( / \d{4}-\d{1,2}-\d{1,2} \d{1,2}-\d{1,2}$/, '' );
		},
		/**
		 * Returns the value in pixels of a medium thumbnail
		 * @method
		 * @return {number}
		 */
		getWidth: function () {
			return IMAGE_WIDTH;
		},
		/**
		 * Extracts image data from api response
		 * @method
		 * @private
		 * @param {Object} page as returned by api request
		 * @return {Object} describing image.
		 */
		_getImageDataFromPage: function ( page ) {
			var img = page.imageinfo[0];
			return {
				url: img.thumburl,
				title: page.title,
				timestamp: img.timestamp,
				description: this._getDescription( page.title ),
				descriptionUrl: img.descriptionurl
			};
		},
		/**
		 * Get the associated query needed to retrieve images from API based
		 * on currently configured options.
		 * @return {Object}
		 */
		getQuery: function () {
			var query = $.extend( {
				action: 'query',
				prop: 'imageinfo',
				// FIXME: [API] have to request timestamp since api returns an object
				// rather than an array thus we need a way to sort
				iiprop: 'url|timestamp',
				iiurlwidth: IMAGE_WIDTH
			}, this.continueParams );

			if ( this.username ) {
				$.extend( query, {
					generator: 'allimages',
					gaiuser: this.username,
					gaisort: 'timestamp',
					gaidir: 'descending',
					gailimit: this.limit
				} );
			} else if ( this.category ) {
				$.extend( query, {
					generator: 'categorymembers',
					gcmtitle: 'Category:' + this.category,
					gcmtype: 'file',
					// FIXME [API] a lot of duplication follows due to the silly way generators work
					gcmdir: 'descending',
					gcmlimit: this.limit
				} );
			}

			return query;
		},
		/**
		 * Request photos beginning with the current value of endTimestamp
		 * @return {jQuery.Deferred} where parameter is a list of JavaScript objects describing an image.
		 */
		getPhotos: function () {
			var self = this,
				result = $.Deferred();

			if ( this.canContinue === true ) {
				this.api.ajax( this.getQuery() ).done( function ( resp ) {
					var photos;
					if ( resp.query && resp.query.pages ) {
						// FIXME: [API] in an ideal world imageData would be a sorted array
						// but it is a map of {[id]: page}
						photos = Object.keys( resp.query.pages ).map( function ( id ) {
							return self._getImageDataFromPage.call( self, resp.query.pages[id] );
						} ).sort( function ( a, b ) {
							return a.timestamp < b.timestamp ? 1 : -1;
						} );

						if ( resp.hasOwnProperty( 'continue' ) ) {
							self.continueParams = resp.continue;
						} else {
							self.canContinue = false;
						}

						// FIXME: Should reply with a list of PhotoItem or Photo classes.
						result.resolve( photos );
					} else {
						result.resolve( [] );
					}
				} ).fail( $.proxy( result, 'reject' ) );
			} else {
				result.resolve( [] );
			}

			return result;
		}
	};

	M.define( 'mobile.gallery/PhotoListGateway', PhotoListGateway );
}( mw.mobileFrontend, jQuery ) );