Removing mk related classes.
[pazpar2-moved-to-github.git] / js / pz2.js
index 2cacae9..cb19e78 100644 (file)
--- a/js/pz2.js
+++ b/js/pz2.js
@@ -1,5 +1,5 @@
 /*
-** $Id: pz2.js,v 1.6 2007-04-13 17:19:53 quinn Exp $
+** $Id: pz2.js,v 1.60 2007-10-02 10:33:18 jakub Exp $
 ** pz2.js - pazpar2's javascript client library.
 */
 
@@ -19,21 +19,37 @@ if (!window['Node']) {
     Node.DOCUMENT_FRAGMENT_NODE = 11;
     Node.NOTATION_NODE = 12;
 }
-// check for jQuery
-if(typeof window.jQuery == "undefined"){
-    throw new Error("pz2.js requires jQuery library");
-}
+
 // prevent execution of more than once
 if(typeof window.pz2 == "undefined") {
 window.undefined = window.undefined;
 
-var pz2 = function(paramArray) {
+var pz2 = function ( paramArray )
+{
+    
+    // at least one callback required
+    if ( !paramArray )
+        throw new Error("Pz2.js: An array with parameters has to be suplied when instantiating a class");
+    
     //for convenience
     __myself = this;
 
-    // at least one callback required
-    if ( !paramArray )
-        throw new Error("An array with parameters has to be suplied when instantiating a class");   
+    //supported pazpar2's protocol version
+    __myself.suppProtoVer = '1';
+    if (typeof paramArray.pazpar2path != "undefined")
+        __myself.pz2String = paramArray.pazpar2path;
+    else
+        __myself.pz2String = "/pazpar2/search.pz2";
+    __myself.useSessions = true;
+    
+    __myself.stylesheet = paramArray.detailstylesheet || null;
+    //load stylesheet if required in async mode
+    if( __myself.stylesheet ) {
+        var request = new pzHttpRequest( __myself.stylesheet );
+        request.get( {}, function ( doc ) { __myself.xslDoc = doc; } );
+    }
+    
+    __myself.errorHandler = paramArray.errorhandler || null;
     
     // function callbacks
     __myself.statCallback = paramArray.onstat || null;
@@ -41,92 +57,153 @@ var pz2 = function(paramArray) {
     __myself.termlistCallback = paramArray.onterm || null;
     __myself.recordCallback = paramArray.onrecord || null;
     __myself.bytargetCallback = paramArray.onbytarget || null;
+    __myself.resetCallback = paramArray.onreset || null;
 
     // termlist keys
     __myself.termKeys = paramArray.termlist || "subject";
     
     // some configurational stuff
-    __myself.pz2String = "search.pz2";
     __myself.keepAlive = 50000;
+    
+    if ( paramArray.keepAlive < __myself.keepAlive )
+        __myself.keepAlive = paramArray.keepAlive;
 
     __myself.sessionID = null;
     __myself.initStatusOK = false;
     __myself.pingStatusOK = false;
     __myself.searchStatusOK = false;
-
-    if ( paramArray.keepAlive < __myself.keepAlive )
-        __myself.keepAlive = paramArray.keepAlive;
-
+    
     // for sorting
     __myself.currentSort = "relevance";
+
     // where are we?
     __myself.currentStart = 0;
     __myself.currentNum = 20;
 
     // last full record retrieved
     __myself.currRecID = null;
+    
     // current query
     __myself.currQuery = null;
 
     //timers
-    __myself.statTime = paramArray.stattime || 2000;
+    __myself.statTime = paramArray.stattime || 1000;
     __myself.statTimer = null;
     __myself.termTime = paramArray.termtime || 1000;
     __myself.termTimer = null;
     __myself.showTime = paramArray.showtime || 1000;
     __myself.showTimer = null;
+    __myself.showFastCount = 4;
     __myself.bytargetTime = paramArray.bytargettime || 1000;
     __myself.bytargetTimer = null;
 
-    //useful?
+    // counters for each command and applied delay
     __myself.dumpFactor = 500;
     __myself.showCounter = 0;
     __myself.termCounter = 0;
+    __myself.statCounter = 0;
+    __myself.bytargetCounter = 0;
 
     // active clients, updated by stat and show
     // might be an issue since bytarget will poll accordingly
     __myself.activeClients = 1;
 
-    // error handling
-    $(document).ajaxError( 
-    function (request, settings, exception) {
-        if ( settings.responseXML && settings.responseXML.getElementsByTagName("error") )
-            throw new Error( settings.responseXML.getElementsByTagName("error")[0].childNodes[0].nodeValue);
-    });
-    
-    // auto init session?
-    if (paramArray.autoInit !== false)
-        __myself.init(__myself.keepAlive);
+    // if in proxy mode no need to init
+    if (paramArray.usesessions != undefined) {
+         __myself.useSessions = paramArray.usesessions;
+        __myself.initStatusOK = true;
+    }
+    // else, auto init session or wait for a user init?
+    if (__myself.useSessions && paramArray.autoInit !== false) {
+        __myself.init();
+    }
 };
-pz2.prototype = {
-    init: function(keepAlive) 
+
+pz2.prototype = 
+{
+    //error handler for async error throws
+   throwError: function (errMsg, errCode)
+   {
+        var err = new Error(errMsg);
+        if (errCode) err.code = errCode;
+                
+        if (__myself.errorHandler) {
+            __myself.errorHandler(err);
+        }
+        else {
+            throw err;
+        }
+   },
+
+    // stop activity by clearing tiemouts 
+   stop: function ()
+   {
+       clearTimeout(__myself.statTimer);
+       clearTimeout(__myself.showTimer);
+       clearTimeout(__myself.termTimer);
+       clearTimeout(__myself.bytargetTimer);
+    },
+    
+    // reset status variables
+    reset: function ()
+    {   
+        if ( __myself.useSessions ) {
+            __myself.sessionID = null;
+            __myself.initStatusOK = false;
+            __myself.pingStatusOK = false;
+        }
+        __myself.searchStatusOK = false;
+        __myself.stop();
+            
+        if ( __myself.resetCallback )
+                __myself.resetCallback();
+    },
+
+    init: function ( sessionId ) 
     {
-        if ( keepAlive < __myself.keepAlive )
-            __myself.keepAlive = keepAlive;  
+        __myself.reset();
         
-        $.get( __myself.pz2String,
-            { "command": "init" },
-            function(data) {
-                if ( data.getElementsByTagName("status")[0].childNodes[0].nodeValue == "OK" ) {
-                    __myself.initStatusOK = true;
-                    __myself.sessionID = data.getElementsByTagName("session")[0].childNodes[0].nodeValue;
-                    setTimeout(__myself.ping, __myself.keepAlive);
+        // session id as a param
+        if ( sessionId != undefined && __myself.useSessions ) {
+            __myself.initStatusOK = true;
+            __myself.sessionID = sessionId;
+            __myself.ping();
+        // old school direct pazpar2 init
+        } else if (__myself.useSessions) {
+            var request = new pzHttpRequest(__myself.pz2String, __myself.errorHandler);
+            request.get(
+                { "command": "init" },
+                function(data) {
+                    if ( data.getElementsByTagName("status")[0].childNodes[0].nodeValue == "OK" ) {
+                        if ( data.getElementsByTagName("protocol")[0].childNodes[0].nodeValue 
+                            != __myself.suppProtoVer )
+                            throw new Error("Server's protocol not supported by the client");
+                        __myself.initStatusOK = true;
+                        __myself.sessionID = data.getElementsByTagName("session")[0].childNodes[0].nodeValue;
+                        setTimeout("__myself.ping()", __myself.keepAlive);
+                    }
+                    else
+                        // if it gets here the http return code was 200 (pz2 errors are 417)
+                        // but the response was invalid, it should never occur
+                        // setTimeout("__myself.init()", 1000);
+                        __myself.throwError('Init failed. Malformed WS resonse.', 110);
                 }
-                else
-                    // if it gets here the http return code was 200 (pz2 errors are 417)
-                    // but the response was invalid, it should never occur
-                    setTimeout("__myself.init()", 1000);
-            }
-        );
+            );
+        // when through proxy no need to init
+        } else {
+            __myself.initStatusOK = true;
+       }
     },
     // no need to ping explicitly
-    ping: function() 
+    ping: function () 
     {
-        if( !__myself.initStatusOK )
-            return;
+        // pinging only makes sense when using pazpar2 directly
+        if( !__myself.initStatusOK || !__myself.useSessions )
+            throw new Error('Pz2.js: Ping not allowed (proxy mode) or session not initialized.');
             // session is not initialized code here
-
-        $.get( __myself.pz2String,
+        
+        var request = new pzHttpRequest(__myself.pz2String, __myself.errorHandler);
+        request.get(
             { "command": "ping", "session": __myself.sessionID },
             function(data) {
                 if ( data.getElementsByTagName("status")[0].childNodes[0].nodeValue == "OK" ) {
@@ -136,11 +213,12 @@ pz2.prototype = {
                 else
                     // if it gets here the http return code was 200 (pz2 errors are 417)
                     // but the response was invalid, it should never occur
-                    setTimeout("__myself.ping()", 1000);
+                    // setTimeout("__myself.ping()", 1000);
+                    __myself.throwError('Ping failed. Malformed WS resonse.', 111);
             }
         );
     },
-    search: function(query, num, sort, filter)
+    search: function (query, num, sort, filter, showfrom)
     {
         clearTimeout(__myself.statTimer);
         clearTimeout(__myself.showTimer);
@@ -149,50 +227,64 @@ pz2.prototype = {
         
         __myself.showCounter = 0;
         __myself.termCounter = 0;
+        __myself.bytargetCounter = 0;
+        __myself.statCounter = 0;
         
+        // no proxy mode
         if( !__myself.initStatusOK )
-            return;
+            throw new Error('Pz2.js: session not initialized.');
         
         if( query !== undefined )
             __myself.currQuery = query;
         else
-            throw new Error("You need to supply query to the search command");
-
-        if( filter !== undefined )
-            var searchParams = { "command": "search", "session": __myself.sessionID, "query": __myself.currQuery, "filter": filter };
+            throw new Error("Pz2.js: no query supplied to the search command.");
+        
+        if ( showfrom !== undefined )
+            var start = showfrom;
         else
-            var searchParams = { "command": "search", "session": __myself.sessionID, "query": __myself.currQuery };
+            var start = 0;
 
-        $.get( __myself.pz2String,
+       var searchParams = { "command": "search", "query": __myself.currQuery, "session": __myself.sessionID };
+       
+        if (filter !== undefined)
+           searchParams["filter"] = filter;
+        
+        var request = new pzHttpRequest(__myself.pz2String, __myself.errorHandler);
+        request.get(
             searchParams,
             function(data) {
                 if ( data.getElementsByTagName("status")[0].childNodes[0].nodeValue == "OK" ) {
                     __myself.searchStatusOK = true;
                     //piggyback search
-                    __myself.show(0, num, sort);
+                    __myself.show(start, num, sort);
                     if ( __myself.statCallback )
-                        __myself.statTimer = setTimeout("__myself.stat()", __myself.statTime / 2);
+                        __myself.stat();
+                        //__myself.statTimer = setTimeout("__myself.stat()", __myself.statTime / 4);
                     if ( __myself.termlistCallback )
-                        //__myself.termlist();
-                        __myself.termTimer = setTimeout("__myself.termlist()", __myself.termTime / 2);
+                        __myself.termlist();
+                        //__myself.termTimer = setTimeout("__myself.termlist()", __myself.termTime / 4);
                     if ( __myself.bytargetCallback )
-                        __myself.bytargetTimer = setTimeout("__myself.bytarget()", __myself.bytargetTime / 2);
+                        __myself.bytarget();
+                        //__myself.bytargetTimer = setTimeout("__myself.bytarget()", __myself.bytargetTime / 4);
                 }
                 else
                     // if it gets here the http return code was 200 (pz2 errors are 417)
                     // but the response was invalid, it should never occur
-                    setTimeout("__myself.search(__myself.currQuery)", 1000);
+                    // setTimeout("__myself.search(__myself.currQuery)", 500);
+                    __myself.throwError('Search failed. Malformed WS resonse.', 112);
             }
         );
     },
     stat: function()
     {
-        if( !__myself.searchStatusOK )
-            return;
+        if( !__myself.initStatusOK )
+            throw new Error('Pz2.js: session not initialized.');
+        
         // if called explicitly takes precedence
         clearTimeout(__myself.statTimer);
-
-        $.get( __myself.pz2String,
+        
+        var request = new pzHttpRequest(__myself.pz2String, __myself.errorHandler);
+        request.get(
             { "command": "stat", "session": __myself.sessionID },
             function(data) {
                 if ( data.getElementsByTagName("stat") ) {
@@ -210,21 +302,26 @@ pz2.prototype = {
                     "failed": Number( data.getElementsByTagName("failed")[0].childNodes[0].nodeValue ),
                     "error": Number( data.getElementsByTagName("error")[0].childNodes[0].nodeValue )
                     };
+                    
+                    __myself.statCounter++;
+                   var delay = __myself.statTime + __myself.statCounter * __myself.dumpFactor;
+                    if ( activeClients > 0 )
+                        __myself.statTimer = setTimeout("__myself.stat()", delay);
                     __myself.statCallback(stat);
-                    if (activeClients > 0)
-                        __myself.statTimer = setTimeout("__myself.stat()", __myself.statTime); 
                 }
                 else
                     // if it gets here the http return code was 200 (pz2 errors are 417)
                     // but the response was invalid, it should never occur
-                    __myself.statTimer = setTimeout("__myself.stat()", __myself.statTime / 4);
+                    //__myself.statTimer = setTimeout("__myself.stat()", __myself.statTime / 4);
+                    __myself.throwError('Stat failed. Malformed WS resonse.', 113);
             }
         );
     },
     show: function(start, num, sort)
     {
-        if( !__myself.searchStatusOK )
-            return;
+        if( !__myself.searchStatusOK && __myself.useSessions )
+            throw new Error('Pz2.js: show command has to be preceded with a search command.');
+        
         // if called explicitly takes precedence
         clearTimeout(__myself.showTimer);
         
@@ -234,8 +331,10 @@ pz2.prototype = {
             __myself.currentStart = Number( start );
         if( num !== undefined )
             __myself.currentNum = Number( num );
-        
-        $.get( __myself.pz2String,
+
+        var request = new pzHttpRequest(__myself.pz2String, __myself.errorHandler);
+        var context = this;
+        request.get(
             { "command": "show", "session": __myself.sessionID, "start": __myself.currentStart,
               "num": __myself.currentNum, "sort": __myself.currentSort, "block": 1 },
             function(data) {
@@ -243,6 +342,7 @@ pz2.prototype = {
                     // first parse the status data send along with records
                     // this is strictly bound to the format
                     var activeClients = Number( data.getElementsByTagName("activeclients")[0].childNodes[0].nodeValue );
+                    __myself.activeClients = activeClients; 
                     var show = {
                     "activeclients": activeClients,
                     "merged": Number( data.getElementsByTagName("merged")[0].childNodes[0].nodeValue ),
@@ -256,88 +356,156 @@ pz2.prototype = {
                     var hit = new Array();
                     for (i = 0; i < hits.length; i++) {
                         show.hits[i] = new Array();
+                       show.hits[i]['location'] = new Array();
                         for ( j = 0; j < hits[i].childNodes.length; j++) {
+                           var locCount = 0;
                             if ( hits[i].childNodes[j].nodeType == Node.ELEMENT_NODE ) {
-                                var nodeName = hits[i].childNodes[j].nodeName;
-                                var nodeText = hits[i].childNodes[j].firstChild.nodeValue;
-                                show.hits[i][nodeName] = nodeText;
+                               if (hits[i].childNodes[j].nodeName == 'location') {
+                                   var locNode = hits[i].childNodes[j];
+                                   var id = locNode.getAttribute('id');
+                                   show.hits[i]['location'][id] = {
+                                       "id": locNode.getAttribute("id"),
+                                       "name": locNode.getAttribute("name")
+                                   };
+                               }
+                               else {
+                                   var nodeName = hits[i].childNodes[j].nodeName;
+                                    var nodeText = 'ERROR'
+                                    if ( hits[i].childNodes[j].firstChild )
+                                        nodeText = hits[i].childNodes[j].firstChild.nodeValue;
+                                   show.hits[i][nodeName] = nodeText;
+                               }
                             }
                         }
                     }
-                    __myself.showCallback(show);
                     __myself.showCounter++;
-                    if (activeClients > 0)
-                        __myself.showTimer = setTimeout("__myself.show()", (__myself.showTime + __myself.showCounter*__myself.dumpFactor));
+                   var delay = __myself.showTime;
+                   if (__myself.showCounter > __myself.showFastCount)
+                            delay += __myself.showCounter * __myself.dumpFactor;
+                    if ( activeClients > 0 )
+                        __myself.showTimer = setTimeout("__myself.show()", delay);
+
+                    __myself.showCallback(show);
                 }
                 else
                     // if it gets here the http return code was 200 (pz2 errors are 417)
                     // but the response was invalid, it should never occur
-                    __myself.showTimer = setTimeout("__myself.show()", __myself.showTime / 4);
+                    // __myself.showTimer = setTimeout("__myself.show()", __myself.showTime / 4);
+                    __myself.throwError('Show failed. Malformed WS resonse.', 114);
             }
         );
     },
-    record: function(id)
+    record: function(id, offset, params)
     {
-        if( !__myself.searchStatusOK )
-            return;
+        // we may call record with no previous search if in proxy mode
+        if( !__myself.searchStatusOK && __myself.useSessions)
+           throw new Error('Pz2.js: record command has to be preceded with a search command.'); 
+
+        if ( params == undefined )
+            params = {};
+
+        if ( params.callback != undefined ) {
+            callback = params.callback;
+        } else {
+            callback = __myself.recordCallback;
+        }
+        
+        // what is that?
+        if ( params['handle'] == undefined )
+            handle = {};
+        else
+            handle = params['handle'];
 
         if( id !== undefined )
             __myself.currRecID = id;
+        
+        var request = new pzHttpRequest(__myself.pz2String, __myself.errorHandler);
+
+       var recordParams = { "command": "record", 
+                            "session": __myself.sessionID,
+                            "id": __myself.currRecID };
+       
+        if (offset !== undefined) {
+           recordParams["offset"] = offset;
+       }
+
+        if (params.syntax != undefined) {
+            recordParams['syntax'] = params.syntax;
+        }
+
+       __myself.currRecOffset = offset;
 
-        $.get( __myself.pz2String,
-            { "command": "record", "session": __myself.sessionID, "id": __myself.currRecID },
+        request.get(
+           recordParams,
             function(data) {
                 var recordNode;
                 var record = new Array();
-                if ( recordNode = data.getElementsByTagName("record")[0] ) {
-                    for ( i = 0; i < recordNode.childNodes.length; i++) {
-                        if ( recordNode.childNodes[i].nodeType == Node.ELEMENT_NODE ) {
-                            var nodeName = recordNode.childNodes[i].nodeName;
-                            var nodeText = recordNode.childNodes[i].firstChild.nodeValue;
-                            record[nodeName] = nodeText;                            
+                record['xmlDoc'] = data;
+               if (__myself.currRecOffset !== undefined) {
+                    record['offset'] = __myself.currRecOffset;
+                    callback(record, handle);
+                } else if ( recordNode = data.getElementsByTagName("record")[0] ) {
+                    // if stylesheet was fetched do not parse the response
+                    if ( __myself.xslDoc ) {
+                        record['recid'] = recordNode.getElementsByTagName("recid")[0].firstChild.nodeValue;
+                        record['xslDoc'] = __myself.xslDoc;
+                    } else {
+                        for ( i = 0; i < recordNode.childNodes.length; i++) {
+                            if ( recordNode.childNodes[i].nodeType == Node.ELEMENT_NODE
+                                    && recordNode.childNodes[i].nodeName != 'location' ) {
+                                var nodeName = recordNode.childNodes[i].nodeName;
+                                var nodeText = recordNode.childNodes[i].firstChild.nodeValue;
+                                record[nodeName] = nodeText;                            
+                            }
                         }
-                    }
-                    // the location is hard coded
-                    var locationNodes = recordNode.getElementsByTagName("location");
-                    record["location"] = new Array();
-                    for ( i = 0; i < locationNodes.length; i++ ) {
-                        record["location"][i] = {
-                            "id": locationNodes[i].getAttribute("id"),
-                            "name": locationNodes[i].getAttribute("name")
-                        };
-                        for ( j = 0; j < locationNodes[i].childNodes.length; j++) {
-                            if ( locationNodes[i].childNodes[j].nodeType == Node.ELEMENT_NODE ) {
-                                var nodeName = locationNodes[i].childNodes[j].nodeName;
-                                var nodeText;
-                               if (locationNodes[i].childNodes[j].firstChild)
-                                       nodeText = locationNodes[i].childNodes[j].firstChild.nodeValue;
-                               else
-                                       nodeText = '';
-                                record["location"][i][nodeName] = nodeText;                            
+                        // the location might be empty!!
+                        var locationNodes = recordNode.getElementsByTagName("location");
+                        record["location"] = new Array();
+                        for ( i = 0; i < locationNodes.length; i++ ) {
+                            record["location"][i] = {
+                                "id": locationNodes[i].getAttribute("id"),
+                                "name": locationNodes[i].getAttribute("name")
+                            };
+                            
+                            for ( j = 0; j < locationNodes[i].childNodes.length; j++) {
+                                if ( locationNodes[i].childNodes[j].nodeType == Node.ELEMENT_NODE ) {
+                                    var nodeName = locationNodes[i].childNodes[j].nodeName;
+                                    var nodeText = '';
+                                    if (locationNodes[i].childNodes[j].firstChild)
+                                            nodeText = locationNodes[i].childNodes[j].firstChild.nodeValue;
+                                    record["location"][i][nodeName] = nodeText;                            
+                                }
                             }
                         }
                     }
-                    __myself.recordCallback(record);
+                    
+                    callback(record, handle);
                 }
                 else
                     // if it gets here the http return code was 200 (pz2 errors are 417)
                     // but the response was invalid, it should never occur
-                    setTimeout("__myself.record(__myself.currRecID)", 1000);
+                    // setTimeout("__myself.record(__myself.currRecID)", 500);
+                    __myself.throwError('Record failed. Malformed WS resonse.', 115);
             }
         );
     },
+
     termlist: function()
     {
-        if( !__myself.searchStatusOK )
-            return;
+        if( !__myself.searchStatusOK && __myself.useSessions )
+            throw new Error('Pz2.js: termlist command has to be preceded with a search command.');
+
         // if called explicitly takes precedence
         clearTimeout(__myself.termTimer);
-
-        $.get( __myself.pz2String,
+        
+        var request = new pzHttpRequest(__myself.pz2String, __myself.errorHandler);
+        request.get(
             { "command": "termlist", "session": __myself.sessionID, "name": __myself.termKeys },
             function(data) {
                 if ( data.getElementsByTagName("termlist") ) {
-                    var termList = { "activeclients": Number( data.getElementsByTagName("activeclients")[0].childNodes[0].nodeValue ) };
+                    var activeClients = Number( data.getElementsByTagName("activeclients")[0].childNodes[0].nodeValue );
+                    __myself.activeClients = activeClients;
+                    var termList = { "activeclients":  activeClients };
                     var termLists = data.getElementsByTagName("list");
                     //for each termlist
                     for (i = 0; i < termLists.length; i++) {
@@ -347,8 +515,10 @@ pz2.prototype = {
                         //for each term in the list
                         for (j = 0; j < terms.length; j++) { 
                             var term = {
-                                "name": terms[j].getElementsByTagName("name")[0].childNodes[0].nodeValue,
-                                "freq": terms[j].getElementsByTagName("frequency")[0].childNodes[0].nodeValue
+                                "name": (terms[j].getElementsByTagName("name")[0].childNodes.length 
+                                                ? terms[j].getElementsByTagName("name")[0].childNodes[0].nodeValue
+                                                : 'ERROR'),
+                                "freq": terms[j].getElementsByTagName("frequency")[0].childNodes[0].nodeValue || 'ERROR'
                             };
 
                             var termIdNode = terms[j].getElementsByTagName("id");
@@ -359,27 +529,36 @@ pz2.prototype = {
                         }
                     }
 
-                    __myself.termlistCallback(termList);
                     __myself.termCounter++;
-                    if (termList["activeclients"] > 0)
-                        __myself.termTimer = setTimeout("__myself.termlist()", (__myself.termTime + __myself.termCounter*__myself.dumpFactor)); 
+                    var delay = __myself.termTime + __myself.termCounter * __myself.dumpFactor;
+                    if ( activeClients > 0 )
+                        __myself.termTimer = setTimeout("__myself.termlist()", delay);
+                   
+                   __myself.termlistCallback(termList);
                 }
                 else
                     // if it gets here the http return code was 200 (pz2 errors are 417)
                     // but the response was invalid, it should never occur
-                    __myself.termTimer = setTimeout("__myself.termlist()", __myself.termTime / 4); 
+                    // __myself.termTimer = setTimeout("__myself.termlist()", __myself.termTime / 4); 
+                    __myself.throwError('Termlist failed. Malformed WS resonse.', 116);
             }
         );
 
     },
     bytarget: function()
     {
+        if( !__myself.initStatusOK && __myself.useSessions )
+            throw new Error('Pz2.js: bytarget command has to be preceded with a search command.');
+        
+        // no need to continue
         if( !__myself.searchStatusOK )
             return;
+
         // if called explicitly takes precedence
         clearTimeout(__myself.bytargetTimer);
-
-        $.get( __myself.pz2String,
+        
+        var request = new pzHttpRequest(__myself.pz2String, __myself.errorHandler);
+        request.get(
             { "command": "bytarget", "session": __myself.sessionID },
             function(data) {
                 if ( data.getElementsByTagName("status")[0].childNodes[0].nodeValue == "OK" ) {
@@ -395,23 +574,30 @@ pz2.prototype = {
                             }
                         }
                     }
-                    __myself.bytargetCallback(bytarget);
+                    
+                    __myself.bytargetCounter++;
+                    var delay = __myself.bytargetTime + __myself.bytargetCounter * __myself.dumpFactor;
                     if ( __myself.activeClients > 0 )
-                        __myself.bytargetTimer = setTimeout("__myself.bytarget()", __myself.bytargetTime);
+                        __myself.bytargetTimer = setTimeout("__myself.bytarget()", delay);
+
+                    __myself.bytargetCallback(bytarget);
                 }
                 else
                     // if it gets here the http return code was 200 (pz2 errors are 417)
                     // but the response was invalid, it should never occur
-                    __myself.bytargetTimer = setTimeout("__myself.bytarget()", __myself.bytargetTime / 4);
+                    // __myself.bytargetTimer = setTimeout("__myself.bytarget()", __myself.bytargetTime / 4);
+                    __myself.throwError('Bytarget failed. Malformed WS resonse.', 117);
             }
         );
     },
+    
     // just for testing, probably shouldn't be here
     showNext: function(page)
     {
         var step = page || 1;
         __myself.show( ( step * __myself.currentNum ) + __myself.currentStart );     
     },
+
     showPrev: function(page)
     {
         if (__myself.currentStart == 0 )
@@ -420,10 +606,246 @@ pz2.prototype = {
         var newStart = __myself.currentStart - (step * __myself.currentNum );
         __myself.show( newStart > 0 ? newStart : 0 );
     },
+
     showPage: function(pageNum)
     {
         //var page = pageNum || 1;
         __myself.show(pageNum * __myself.currentNum);
     }
 };
+
+/*
+*********************************************************************************
+** AJAX HELPER CLASS ************************************************************
+*********************************************************************************
+*/
+var pzHttpRequest = function ( url, errorHandler ) {
+        this.request = null;
+        this.url = url;
+        this.errorHandler = errorHandler || null;
+        this.async = true;
+        
+        if ( window.XMLHttpRequest ) {
+            this.request = new XMLHttpRequest();
+        } else if ( window.ActiveXObject ) {
+            try {
+                this.request = new ActiveXObject( 'Msxml2.XMLHTTP' );
+            } catch (err) {
+                this.request = new ActiveXObject( 'Microsoft.XMLHTTP' );
+            }
+        }
+};
+
+pzHttpRequest.prototype = 
+{
+    get: function ( params, callback ) 
+    {
+        this._send( 'GET', params, '', callback );
+    },
+
+    post: function ( params, data, callback )
+    {
+        this._send( 'POST', params, data, callback );
+    },
+
+    load: function ()
+    {
+        this.async = false;
+        this.request.open( 'GET', this.url, this.async );
+        this.request.send('');
+        if ( this.request.status == 200 )
+            return this.request.responseXML;
+    },
+
+    _send: function ( type, params, data, callback )
+    {
+        this.callback = callback;
+        var context = this;
+        this.async = true;
+        this.request.open( type, this._urlAppendParams(params), this.async );
+        this.request.onreadystatechange = function () {
+            context._handleResponse();
+        }
+        this.request.send(data);
+    },
+
+    _urlAppendParams: function (params)
+    {
+        var getUrl = this.url;
+
+       var sep = '?';
+        var el = params;
+        for (var key in el) {
+            if (el[key] != null) {
+                getUrl += sep + key + '=' + encodeURIComponent(el[key]);
+                sep = '&';
+            }
+        }
+        return getUrl;
+    },
+
+    _handleResponse: function ()
+    {
+        if ( this.request.readyState == 4 ) { 
+            // pick up pazpr2 errors first
+            if ( this.request.responseXML 
+                && this.request.responseXML.documentElement.nodeName == 'error'
+                && this.request.responseXML.getElementsByTagName("error").length ) {
+                var errAddInfo = '';
+                if ( this.request.responseXML.getElementsByTagName("error")[0].childNodes.length )
+                    errAddInfo = ': ' + this.request.responseXML.getElementsByTagName("error")[0].childNodes[0].nodeValue;
+                var errMsg = this.request.responseXML.getElementsByTagName("error")[0].getAttribute("msg");
+                var errCode = this.request.responseXML.getElementsByTagName("error")[0].getAttribute("code");
+            
+                var err = new Error(errMsg + errAddInfo);
+                err.code = errCode;
+           
+                if (this.errorHandler) {
+                    this.errorHandler(err);
+                }
+                else {
+                    throw err;
+                }
+            } else if ( this.request.status == 200 ) {
+                this.callback( this.request.responseXML );
+            } else {
+                var err = new Error("Pz2.js: HTTP request error (AJAX). Code: " 
+                            + this.request.status + " Info: " 
+                            + this.request.statusText );
+                err.code = 'HTTP';
+                
+                if (this.errorHandler) {
+                    this.errorHandler(err);
+                }
+                else {
+                    throw err;
+                }
+            }
+        }
+    }
+};
+
+/*
+*********************************************************************************
+** XML HELPER CLASS ************************************************************
+*********************************************************************************
+*/
+
+// DOMDocument
+
+if ( window.ActiveXObject) {
+    var DOMDoc = document;
+} else {
+    var DOMDoc = Document.prototype;
+}
+
+DOMDoc.newXmlDoc = function ( root )
+{
+    var doc;
+
+    if (document.implementation && document.implementation.createDocument) {
+        doc = document.implementation.createDocument('', root, null);
+    } else if ( window.ActiveXObject ) {
+        doc = new ActiveXObject("MSXML2.DOMDocument");
+        doc.loadXML('<' + root + '/>');
+    } else {
+        throw new Error ('No XML support in this browser');
+    }
+
+    return doc;
+}
+
+   
+DOMDoc.parseXmlFromString = function ( xmlString ) 
+{
+    var doc;
+
+    if ( window.DOMParser ) {
+        var parser = new DOMParser();
+        doc = parser.parseFromString( xmlString, "text/xml");
+    } else if ( window.ActiveXObject ) {
+        doc = new ActiveXObject("MSXML2.DOMDocument");
+        doc.loadXML( xmlString );
+    } else {
+        throw new Error ("No XML parsing support in this browser.");
+    }
+
+    return doc;
+}
+
+DOMDoc.transformToDoc = function (xmlDoc, xslDoc)
+{
+    if ( window.XSLTProcessor ) {
+        var proc = new XSLTProcessor();
+        proc.importStylesheet( xslDoc );
+        return proc.transformToDocument(xmlDoc);
+    } else if ( window.ActiveXObject ) {
+        return document.parseXmlFromString(xmlDoc.transformNode(xslDoc));
+    } else {
+        alert( 'Unable to perform XSLT transformation in this browser' );
+    }
+}
+// DOMElement
+
+Element_removeFromDoc = function (DOM_Element)
+{
+    DOM_Element.parentNode.removeChild(DOM_Element);
+}
+
+Element_emptyChildren = function (DOM_Element)
+{
+    while( DOM_Element.firstChild ) {
+        DOM_Element.removeChild( DOM_Element.firstChild )
+    }
+}
+
+Element_appendTransformResult = function ( DOM_Element, xmlDoc, xslDoc )
+{
+    if ( window.XSLTProcessor ) {
+        var proc = new XSLTProcessor();
+        proc.importStylesheet( xslDoc );
+        var docFrag = false;
+        docFrag = proc.transformToFragment( xmlDoc, DOM_Element.ownerDocument );
+        DOM_Element.appendChild(docFrag);
+    } else if ( window.ActiveXObject ) {
+        DOM_Element.innerHTML = xmlDoc.transformNode( xslDoc );
+    } else {
+        alert( 'Unable to perform XSLT transformation in this browser' );
+    }
+}
+Element_appendTextNode = function (DOM_Element, tagName, textContent )
+{
+    var node = DOM_Element.ownerDocument.createElement(tagName);
+    var text = DOM_Element.ownerDocument.createTextNode(textContent);
+
+    DOM_Element.appendChild(node);
+    node.appendChild(text);
+
+    return node;
+}
+
+Element_setTextContent = function ( DOM_Element, textContent )
+{
+    if (typeof DOM_Element.textContent !== "undefined") {
+        DOM_Element.textContent = textContent;
+    } else if (typeof DOM_Element.innerText !== "undefined" ) {
+        DOM_Element.innerText = textContent;
+    } else {
+        throw new Error("Cannot set text content of the node, no such method.");
+    }
+}
+
+Element_getTextContent = function (DOM_Element)
+{
+    if ( typeof DOM_Element.textContent != 'undefined' ) {
+        return DOM_Element.textContent;
+    } else if (typeof DOM_Element.text != 'undefined') {
+        return DOM_Element.text;
+    } else {
+        throw new Error("Cannot get text content of the node, no such method.");
+    }
+}
+
 }