SMMP/public_html/js/lib/api.js

/* classe API */
function APIClass(target){ this.target = target; }

APIClass.prototype = {
	xhr: [],                         // tableau d'objets pour les requêtes ajax
	buffer: null,                    // Contiendra le buffer pour debugger si erreur de parsage
	optionalParams: [],              // Contiendra les paramètres que l'on veut passer au scope de @pHandler

	/* transaction avec le serveur (http://host/api/)
	*
	* @param pRequest<Object>		l'objet passé en POST (attribut->postfield) à http://host/api/
	* @param pHandler<Function>		fonction qui s'éxécutera lors de la réponse (1 argument -> réponse<Object>)
	* @param pToken<String>			Optionnel, token d'auth pour l'api
	* @param pParams<Mixed>			Optionnels, liste d'arguments à passer au scope de @pHandler
	*
	* @return answer<Object>		l'objet retourné par http://host/api/ via pHandler (1er argument)
	*
	***************************************************************************************************
	*
	* @usecase
	*	1.		var answerObject = sendRequest(
	*	2.			{ var1: "exemple", var2: 198294 },
	*	3.			function(rep){ alert(rep); }
	*	4.		);
	* @explain
	*	1. on appelle la fonction <=> on créé la requête
	*   2. on passe l'objet qui sera envoyé
	*   3. on passe une fonction qui utilise un argument (sera la réponse de http://host/api/) (sous forme d'objet)
	*
	*/
	send: function(pRequest, pHandler, pToken){

		// Si le chemin de delegation n'est pas renseigne, on renvoie une erreur
		if( !pRequest.hasOwnProperty('path') )
			pHandler({ModuleError:4});

		// on efface les requêtes qui sont terminées (toutes celles de this.xhr)
		for( var i = 0 ; i < this.xhr.length ; i++ )
			if( this.xhr[i].readyState == 4 ) // si terminée
				this.xhr.splice(i, 1);


		// on créé une nouvelle entrée
		this.xhr.push(null);
		i = this.xhr.length-1;


		// Gestion des paramètres optionnels à passer au scope de @pHandler
		this.optionalParams[i] = [];
		if( arguments.length > 3 )
			for( var arg  = 3 ; arg < arguments.length ; arg++ )
				this.optionalParams[i].push( arguments[arg] );


		// création de l'objet AJAX
		if(window.XMLHttpRequest) this.xhr[i] = new XMLHttpRequest();                          // IE7+, Firefox, Chrome, Opera, Safari
		else                      this.xhr[i] = new ActiveXObject('Microsoft.XMLHttpRequest'); // IE5, IE6

		var ptrAPI = this;
		this.xhr[i].onreadystatechange = function(){
			if( ptrAPI.xhr[i].readyState == 4 ){ // si la requête est terminée

				// On met à jour le BUFFER (pour debugger)
				ptrAPI.buffer = ptrAPI.xhr[i].responseText;

				console.log('api request', pRequest);

				/* si success de requête */
				if( [0,200,417].indexOf(ptrAPI.xhr[i].status) > -1 ){ // si fichier existe et reçu
					var parsedResponse = {ModuleError:-1, ErrorDescription:'Erreur au niveau de api.js'};

					// On essaie de parser le json
					try{
						parsedResponse = JSON.parse(ptrAPI.xhr[i].responseText);
					}catch(e){}

					// On lance la handler
					console.log('api response', parsedResponse);

					if( parsedResponse.hasOwnProperty('ModuleError') && parsedResponse.ModuleError != 0 )
						console.error('ModuleError::'+parsedResponse.ModuleError);

					pHandler(parsedResponse, ptrAPI.optionalParams[i]);

				}
				/* sinon retourne obj.request = 'unreachable' */
				else
					pHandler({ModuleError:-2, ModuleDescription:'Erreur au niveau d\'AJAX.'});

			}
		};

		// on créé un formulaire POST (virtuel)
		var form = new FormData();

		// On ajoute tous les attributs en POST
		for( var key in pRequest )
			// On envoie le 'path' tel quel <String>
			if( key == 'path' )                      form.append(key, pRequest[key]);
			// On envoie un fichier tel quel <File>
			else if( pRequest[key] instanceof File ) form.append(key, pRequest[key]);
			// On envoie le reste en JSON
			else                                     form.append(key, JSON.stringify(pRequest[key]));


		this.xhr[i].open('POST', this.target, true);


		// Gestion du token optionnel
		if( pToken != null ) this.xhr[i].setRequestHeader('Authorization', 'Digest '+pToken);


		// Header pour dire que c'est AJAX
		this.xhr[i].setRequestHeader('X-Requested-With', 'XMLHttpRequest');



		this.xhr[i].send( form );

	}
};