/* ***********************************************************************

   UploadMgr - provides an API for uploading one or multiple files
   with progress feedback (on modern browsers), does not block the user 
   interface during uploads, supports cancelling uploads.

   http://qooxdoo.org

   Copyright:
     2011 Zenesis Limited, http://www.zenesis.com

   License:
     LGPL: http://www.gnu.org/licenses/lgpl.html
     EPL: http://www.eclipse.org/org/documents/epl-v10.php
     
     This software is provided under the same licensing terms as Qooxdoo,
     please see the LICENSE file in the Qooxdoo project's top-level directory 
     for details.

   Authors:
     * John Spackman (john.spackman@zenesis.com)

************************************************************************/

/**
 * This mixin adds get/setParam methods used by UploadManager, AbstractHandler,
 * and UploadButton
 */
qx.Mixin.define("com.zenesis.qx.upload.MParameters", {
	members: {
		__params: null,
		
		/**
		 * Sets a parameter value to be sent with the file
		 * @param name {String} name of the parameter
		 * @param value {String} the value of the parameter, or null to delete a previous parameter
		 */
		setParam: function(name, value) {
			if (value !== null && typeof value != "string")
				value ="" + value;
			if (!this.__params)
				this.__params = {};
			this.__params[name] = value;
		},
		
		/**
		 * Returns a parameter value to be sent with the file
		 * @param name
		 * @returns {Boolean}
		 */
		getParam: function(name) {
			return this.__params && this.__params[name];
		},
		
		/**
		 * Returns a list of parameter names
		 * @returns {Array}
		 */
		getParamNames: function() {
			var result = [];
			if (this.__params)
				for (var name in this.__params)
					result.push(name);
			return result;
		}
	}
});