NxTIC/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,

	/* 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>			si donne, token d'auth pour l'api
	*
	* @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 = this.xhr.slice(0,i-1).concat(this.xhr.slice(i,this.xhr.length-1)); // suppression entrée
		}

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

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

		console.log(pRequest);

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

				ptrAPI.buffer = ptrAPI.xhr[i].responseText;
				/* DEBUG : affiche la réponse BRUTE de http://host/api/ */
				// console.log('http://host/api/ => '+ptrAPI.xhr[i].responseText);
				// console.log( JSON.parse(ptrAPI.xhr[i].responseText) );

				/* si success de requête */
				if( [0,200].indexOf(ptrAPI.xhr[i].status) > -1 ){ // si fichier existe et reçu
					try{      pHandler( JSON.parse(ptrAPI.xhr[i].responseText) );                        } // si on peut parser, on envoie
					catch(e){ pHandler({ModuleError:-1, ErrorDescription:'Erreur au niveau de api.js'}); } // sinon on envoie obj.request = 'corrupted'
				}
				/* sinon retourne obj.request = 'unreachable' */
				else
					pHandler({ModuleError:3});

			}
		};

		// 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);



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

	}
};