// ***************************************************************************************************************
// ***************************************************************************************************************
// Librairie HTTPRequest
// ***************************************************************************************************************
// ***************************************************************************************************************
// effectue des communications avec un serveur web sans recharger la page courante
// ATTENTION : nécessite dom.js pour la fonction "ajouter_evenement"
// ***************************************************************************************************************
// ***************************************************************************************************************
// code pour conserver le codage UTF-8 dans C-génie : éàè




//---------------------------------------------------------------------------------------
// VARIABLES GLOBALES :
//		@httprequest__communication (object) : pointeur vers le calque de notification de communication
//		@httprequest__nombre_de_communication (int) : nombre de communication en cours
//				permet de savoir quand supprimer le calque de notification de communication
//---------------------------------------------------------------------------------------
var httprequest__communication = null;
var httprequest__nombre_de_communication = 0;




//---------------------------------------------------------------------------------------
// NOM FONCTION : httprequest
// DESCRIPTION COURTE :	initialise le calque de notification de communication
// DESCRIPTION :	
//		crée un élément HTML contenu le code HTML du calque de notification de communication puis insère cet élément en tant que premier fils de BODY.
// ENTREES :
// NECESSITES :
//		La balise BODY doit exister.
// SORTIES :
// VALEURS DE RETOUR :	
//		* 0 : aucune erreur
// AUTEUR : DANIEL Eric
// DERNIERE MODIF : 10/12/2005
// ETAT : ok
// RESTE A FAIRE :
//		*
// REMARQUES :
// VOIR AUSSI : httprequest__communiquer
//---------------------------------------------------------------------------------------
function httprequest()
{
	// --------------
	// initialisation
	// --------------
	var element_html = null;


	// ------------------------------------
	// vérification des paramètres d'entrée
	// ------------------------------------


	// -----------
	// traitements
	// -----------
	element_html = document.createElement( "DIV" );
	element_html.innerHTML = '<div style="z-index: 500; position: absolute; top: 0px; right: 0%; width: 370px height: 150px; background-image: url(/ressources/images/com_serveur.gif); display: none;"><img src="/ressources/images/com_serveur.gif"></div>';
	httprequest__communication = element_html.firstChild;
	document.body.insertBefore( httprequest__communication, document.body.firstChild );


	// ---------------------
	// sortie de la fonction
	// ---------------------
	// 0 : aucune erreur
	return 0;
}




//---------------------------------------------------------------------------------------
// NOM FONCTION : httprequest__communiquer
// DESCRIPTION COURTE :	transmet des informations à une URL et récupère la réponse
// DESCRIPTION :	
//		interroge un script sur un serveur web en transmettant les informations spécifiées et récupère la réponse sous forme de chaine de caractères.
// ENTREES :
//		@url (string) : url à appeler (avec le http:// et le nom de domaine)
//		@methode (string) : GET ou POST (transmission des informations dans l'URL [GET] ou dans le header HTTP [POST])
//		@fonction (function) : pointeur vers la fonction a utiliser lors du retour des informations en mode asynchrone
//		@infos (array) : informations à transmettre en méthode POST
// NECESSITES :
// SORTIES :
// VALEURS DE RETOUR :	
//		* null : aucun contenu
//		* (string) : contenu de la réponse
// AUTEUR : DANIEL Eric
// DERNIERE MODIF : 10/12/2005
// ETAT : ok
// RESTE A FAIRE :
//		* ajouter un test sur le code de retour de la page web
// REMARQUES :
// VOIR AUSSI : httprequest
//---------------------------------------------------------------------------------------
function httprequest__communiquer( url, methode, fonction, infos )
{
	// --------------
	// initialisation
	// --------------
	var httprequest__ptr = false;
	var vars = null;


	// ------------------------------------
	// vérification des paramètres d'entrée
	// ------------------------------------
	// vérification du paramètre url
	if( url == "" )
		return null;

	// vérification du paramètre methode
	if( ( methode != "GET" ) && ( methode != "POST" ) )
		methode = "GET";

	// vérification du paramètre infos
	if( ( typeof( infos ) != "array" ) && ( typeof( infos ) != "object" ) )
		infos = new Array();


	// -----------
	// traitements
	// -----------
	if( httprequest__communication == null )
		httprequest();

	// création de l'objet httprequest
	/*@cc_on @*/
	/*@if (@_jscript_version >= 5)
	// JScript gives us Conditional compilation, we can cope with old IE versions.
	// and security blocked creation of the objects.
	try
		{
		httprequest__ptr = new ActiveXObject("Msxml2.XMLHTTP");
		}
	catch( e )
		{
		try
			{
			httprequest__ptr = new ActiveXObject("Microsoft.XMLHTTP");
			}
		catch( E )
			{
			httprequest__ptr = false;
			}
		}
	@end @*/
	if( !httprequest__ptr
		&& ( typeof( XMLHttpRequest ) != "undefined" ) )
		httprequest__ptr = new XMLHttpRequest();
	
	// communication synchrone (attente de la réponse avant de sortir de la fonction)
	if( typeof( fonction ) != "function" )
		httprequest__ptr.open( methode, url, false );
	// communication asynchrone (sortie immédiate de la fonction et l'objet httprequest poursuit son action tout seul)
	else
		{
		// gestion du calque de communication
		httprequest__nombre_de_communication++;
		httprequest__communication.style.display = "block";

		// création de la requete en précisant la fonction anonyme de traitement de la réponse
		httprequest__ptr.open( methode, url, true );
		httprequest__ptr.onreadystatechange = function()
			{
				// si la communication est finie (etat=4)
				if( httprequest__ptr.readyState == 4 )
					{
					// gestion du calque de communication
					httprequest__nombre_de_communication--;
					if( httprequest__nombre_de_communication == 0 )
					httprequest__communication.style.display = "none";

					// si le code de réponse est bien 200
					if( httprequest__ptr.status == 200 )
						// on appelle la fonction de traitement avec la réponse
						fonction( httprequest__ptr.responseText );
					else
						// on appelle la fonction de traitement avec une chaine vide
						fonction( '""' );
					}
			}
		}

	if( methode == "POST" )
		{
		// on crée le header indiquant le codage des éléments fournis
		httprequest__ptr.setRequestHeader( "Method", "POST " + url + " HTTP/1.0" );
		httprequest__ptr.setRequestHeader( "Content-Type", "application/x-www-form-urlencoded" );
		vars = "";

		// ajout des différents éléments dans le header (en codant les éléments)
		for( var i in infos )
			vars += encodeURI( i ) + "=" + encodeURI( infos[i] ) + "&";
		}

	// envoi du header
	httprequest__ptr.send( vars );

	// communication synchrone (attente de la réponse avant de sortir de la fonction)
	if( typeof( fonction ) != "function" )
// ajouter un test sur le code de retour de la page web
		return httprequest__ptr.responseText;


	// ---------------------
	// sortie de la fonction
	// ---------------------
	// null : aucune erreur
	return null;
}