HTTPRequest v2.0 -- AJAX könyvtár

A kezdet

Elsõnek, be kell tölteni a könyvtárat, hogy használni tudjuk azt. Ennek a legegyszerûbb módja:

<script type="text/javascript" src="http://blog.underconstruction.hu/scripts/HTTPRequest/HTTPRequest2.js"></script>

Tesztelés

Ezután teszteljük a különféle funkciókat, amikre a könyvtár képes.

Teszt 1

Az elsõ teszt során egy szöveget kérünk le a szerverrõl a követkeõ kóddal:

var myText = HTTPRequest('test1.txt',null,null,'text',true);

ez ugyanaz, mint:

var req = HTTPRequest();
req.setAction('szoveg.txt');
req.setReturnMode('text');
var mytext = req.send();

Teszt 2

Adat küldése a szerver felé:

var myText = HTTPRequest('test2.php','POST',{var1:'string1',var2:'string2'},'text',true);

Teszt 3

var postData = {
	var1: ['aaa', ['bbb', 'ccc', {key1: 'ddd', key2: 'eee'}, 'fff', 'ggg']],
	var2: 'string'
};

var myText = HTTPRequest('test3.php','POST',postData,'text',true);

Dokumentáció

A HTTPRequest2 osztály legfrissebb verzióját innen [http://blog.underconstruction.hu/scripts/HTTPRequest/HTTPRequest2.js] lehet mindig letölteni.

Paraméterek

readonly string   version
                  Visszaadja az osztály verziószámát.
         boolean  debug
                  Ha (true), akkor hiba esetén alert-et ad.
@todo    function onstart
                  Küldés elején az itt beállított függvényt futtatja le.
@todo    function onend
                  Küldés után az itt beállított függvényt futtatja le.

Metódusok

mixed   HTTPRequest ( [string action], [POST,GET method], [object parameters], [Text,XML,JSON returnMode], [boolean sendNow] )
        Konstruktor.
string  setReturnMode ( [string returnMode] )
        Lehetséges módok: Text, XML vagy JSON.
        Visszatérési értéke az elõzõleg beállított érték.
string  setMethod ( [string method] )
        Az adat küldésének módját állítja be, lehetséges értékek: POST vagy GET. Az alapértelmezett: GET.
        Visszatérési értéke az elõzõleg beállított érték.
string  setAction ( [string action] )
        Az URL, ahova a kérést küldje.
        Visszatérési értéke az elõzõleg beállított érték.
boolean add ( string name, string value )
        Hozzáadja a megadott névvel és értékkel a paramétert a gyûjtõhöz.
boolean addParameters ( hash parameters )
        Az átadott object vagy array értékeit beleteszi a paraméter gyûjtõbe. A paraméter neve a hash kulcsa lesz.
mixed   send ( [hash parameters] )
        Az átadott object vagy array értékeit beleteszi a paraméter gyûjtõbe. A paraméter neve a hash kulcsa lesz.
        Visszaadja a szerver válaszát (amennyiben volt). Hiba esetén 'null'-lal tér vissza.
void    setToDefault ( )
        Minden beállítást az eredetire állít vissza. (Beleértve a paramétereket is!)
boolean wasError ( )
        TRUE-val tér vissza, ha elõzõleg hiba történt. (A setToDefault() ezt az értéket FALSE-ra állítja!)
string  errorMsg ( )
        Visszaadja az utolsó hibaüzenetet (angol nyelven).

A HTTPRequest v2.0 Creative Common 2.5 Attribution-NoDerive licensz alatt áll.

Ahova a kommenteket, ötleteket, bugokat várom: underconstruction blog