/*
-** $Id: pz2.js,v 1.48 2007-07-18 13:40:56 adam Exp $
** pz2.js - pazpar2's javascript client library.
*/
if(typeof window.pz2 == "undefined") {
window.undefined = window.undefined;
-var pz2 = function(paramArray) {
- //for convenience
- __myself = this;
+var pz2 = function ( paramArray )
+{
+
+ // at least one callback required
+ if ( !paramArray )
+ throw new Error("Pz2.js: Array with parameters has to be suplied.");
//supported pazpar2's protocol version
- __myself.suppProtoVer = '1';
- __myself.pz2String = paramArray.pazpar2path || "/pazpar2/search.pz2";
- __myself.stylesheet = paramArray.detailstylesheet || null;
- __myself.useSessions = true;
- if (paramArray.usesessions != undefined) {
- __myself.useSessions = paramArray.usesessions;
- }
-
+ this.suppProtoVer = '1';
+ if (typeof paramArray.pazpar2path != "undefined")
+ this.pz2String = paramArray.pazpar2path;
+ else
+ this.pz2String = "/pazpar2/search.pz2";
+ this.useSessions = true;
+
+ this.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; } );
+ if( this.stylesheet ) {
+ var context = this;
+ var request = new pzHttpRequest( this.stylesheet );
+ request.get( {}, function ( doc ) { context.xslDoc = doc; } );
}
-
- // at least one callback required
- if ( !paramArray )
- throw new Error("An array with parameters has to be suplied when instantiating a class");
- __myself.errorHandler = paramArray.errorhandler || null;
+ this.errorHandler = paramArray.errorhandler || null;
// function callbacks
- __myself.statCallback = paramArray.onstat || null;
- __myself.showCallback = paramArray.onshow || null;
- __myself.termlistCallback = paramArray.onterm || null;
- __myself.recordCallback = paramArray.onrecord || null;
- __myself.bytargetCallback = paramArray.onbytarget || null;
- __myself.resetCallback = paramArray.onreset || null;
+ this.initCallback = paramArray.oninit || null;
+ this.statCallback = paramArray.onstat || null;
+ this.showCallback = paramArray.onshow || null;
+ this.termlistCallback = paramArray.onterm || null;
+ this.recordCallback = paramArray.onrecord || null;
+ this.bytargetCallback = paramArray.onbytarget || null;
+ this.resetCallback = paramArray.onreset || null;
// termlist keys
- __myself.termKeys = paramArray.termlist || "subject";
+ this.termKeys = paramArray.termlist || "subject";
// some configurational stuff
- __myself.keepAlive = 50000;
-
- __myself.sessionID = null;
- __myself.initStatusOK = false;
- __myself.pingStatusOK = false;
- __myself.searchStatusOK = false;
-
- if ( paramArray.keepAlive < __myself.keepAlive )
- __myself.keepAlive = paramArray.keepAlive;
+ this.keepAlive = 50000;
+
+ if ( paramArray.keepAlive < this.keepAlive )
+ this.keepAlive = paramArray.keepAlive;
+ this.sessionID = null;
+ this.initStatusOK = false;
+ this.pingStatusOK = false;
+ this.searchStatusOK = false;
+
// for sorting
- __myself.currentSort = "relevance";
+ this.currentSort = "relevance";
+
// where are we?
- __myself.currentStart = 0;
- __myself.currentNum = 20;
+ this.currentStart = 0;
+ this.currentNum = 20;
// last full record retrieved
- __myself.currRecID = null;
+ this.currRecID = null;
+
// current query
- __myself.currQuery = null;
+ this.currQuery = null;
+
+ //current raw record offset
+ this.currRecOffset = null;
//timers
- __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;
+ this.statTime = paramArray.stattime || 1000;
+ this.statTimer = null;
+ this.termTime = paramArray.termtime || 1000;
+ this.termTimer = null;
+ this.showTime = paramArray.showtime || 1000;
+ this.showTimer = null;
+ this.showFastCount = 4;
+ this.bytargetTime = paramArray.bytargettime || 1000;
+ this.bytargetTimer = null;
+ this.recordTime = paramArray.recordtime || 500;
+ this.recordTimer = null;
// counters for each command and applied delay
- __myself.dumpFactor = 500;
- __myself.showCounter = 0;
- __myself.termCounter = 0;
- __myself.statCounter = 0;
- __myself.bytargetCounter = 0;
+ this.dumpFactor = 500;
+ this.showCounter = 0;
+ this.termCounter = 0;
+ this.statCounter = 0;
+ this.bytargetCounter = 0;
+ this.recordCounter = 0;
// active clients, updated by stat and show
// might be an issue since bytarget will poll accordingly
- __myself.activeClients = 1;
-
- // auto init session?
- if (paramArray.autoInit !== false)
- __myself.init();
+ this.activeClients = 1;
+
+ // if in proxy mode no need to init
+ if (paramArray.usesessions != undefined) {
+ this.useSessions = paramArray.usesessions;
+ this.initStatusOK = true;
+ }
+ // else, auto init session or wait for a user init?
+ if (this.useSessions && paramArray.autoInit !== false) {
+ this.init();
+ }
};
+
pz2.prototype =
{
+ //error handler for async error throws
+ throwError: function (errMsg, errCode)
+ {
+ var err = new Error(errMsg);
+ if (errCode) err.code = errCode;
+
+ if (this.errorHandler) {
+ this.errorHandler(err);
+ }
+ else {
+ throw err;
+ }
+ },
+
+ // stop activity by clearing tiemouts
stop: function ()
{
- clearTimeout(__myself.statTimer);
- clearTimeout(__myself.showTimer);
- clearTimeout(__myself.termTimer);
- clearTimeout(__myself.bytargetTimer);
+ clearTimeout(this.statTimer);
+ clearTimeout(this.showTimer);
+ clearTimeout(this.termTimer);
+ clearTimeout(this.bytargetTimer);
},
+ // reset status variables
reset: function ()
- {
- __myself.sessionID = null;
- __myself.initStatusOK = false;
- __myself.pingStatusOK = false;
- __myself.searchStatusOK = false;
-
- __myself.stop();
+ {
+ if ( this.useSessions ) {
+ this.sessionID = null;
+ this.initStatusOK = false;
+ this.pingStatusOK = false;
+ }
+ this.searchStatusOK = false;
+ this.stop();
- if ( __myself.resetCallback )
- __myself.resetCallback();
+ if ( this.resetCallback )
+ this.resetCallback();
},
+
init: function ( sessionId )
{
- __myself.reset();
-
- if ( sessionId != undefined ) {
- __myself.initStatusOK = true;
- __myself.sessionID = sessionId;
- __myself.ping();
- } else if (__myself.useSessions) {
- var request = new pzHttpRequest(__myself.pz2String, __myself.errorHandler);
- request.get(
+ this.reset();
+
+ // session id as a param
+ if ( sessionId != undefined && this.useSessions ) {
+ this.initStatusOK = true;
+ this.sessionID = sessionId;
+ this.ping();
+ // old school direct pazpar2 init
+ } else if (this.useSessions) {
+ var context = this;
+ var request = new pzHttpRequest(this.pz2String, this.errorHandler);
+ request.safeGet(
{ "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);
+ if ( data.getElementsByTagName("status")[0]
+ .childNodes[0].nodeValue == "OK" ) {
+ if ( data.getElementsByTagName("protocol")[0]
+ .childNodes[0].nodeValue
+ != context.suppProtoVer )
+ throw new Error(
+ "Server's protocol not supported by the client"
+ );
+ context.initStatusOK = true;
+ context.sessionID =
+ data.getElementsByTagName("session")[0]
+ .childNodes[0].nodeValue;
+ setTimeout(
+ function () {
+ context.ping();
+ },
+ context.keepAlive
+ );
+ if ( context.initCallback )
+ context.initCallback();
}
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);
+ context.throwError('Init failed. Malformed WS resonse.',
+ 110);
}
);
+ // when through proxy no need to init
} else {
- __myself.initStatusOK = true;
+ this.initStatusOK = true;
}
},
// no need to ping explicitly
ping: function ()
{
- if( !__myself.initStatusOK )
- return;
- // session is not initialized code here
- var request = new pzHttpRequest(__myself.pz2String, __myself.errorHandler);
- request.get(
- { "command": "ping", "session": __myself.sessionID },
+ // pinging only makes sense when using pazpar2 directly
+ if( !this.initStatusOK || !this.useSessions )
+ throw new Error(
+ 'Pz2.js: Ping not allowed (proxy mode) or session not initialized.'
+ );
+ var context = this;
+ var request = new pzHttpRequest(this.pz2String, this.errorHandler);
+ request.safeGet(
+ { "command": "ping", "session": this.sessionID },
function(data) {
- if ( data.getElementsByTagName("status")[0].childNodes[0].nodeValue == "OK" ) {
- __myself.pingStatusOK = true;
- setTimeout("__myself.ping()", __myself.keepAlive);
+ if ( data.getElementsByTagName("status")[0]
+ .childNodes[0].nodeValue == "OK" ) {
+ context.pingStatusOK = true;
+ setTimeout(
+ function () {
+ context.ping();
+ },
+ context.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.ping()", 1000);
+ context.throwError('Ping failed. Malformed WS resonse.',
+ 111);
}
);
},
- search: function (query, num, sort, filter)
+ search: function (query, num, sort, filter, showfrom, addParamsArr)
{
- clearTimeout(__myself.statTimer);
- clearTimeout(__myself.showTimer);
- clearTimeout(__myself.termTimer);
- clearTimeout(__myself.bytargetTimer);
+ clearTimeout(this.statTimer);
+ clearTimeout(this.showTimer);
+ clearTimeout(this.termTimer);
+ clearTimeout(this.bytargetTimer);
- __myself.showCounter = 0;
- __myself.termCounter = 0;
- __myself.bytargetCounter = 0;
- __myself.statCounter = 0;
+ this.showCounter = 0;
+ this.termCounter = 0;
+ this.bytargetCounter = 0;
+ this.statCounter = 0;
+ this.activeClients = 1;
- if( !__myself.initStatusOK )
- return;
+ // no proxy mode
+ if( !this.initStatusOK )
+ throw new Error('Pz2.js: session not initialized.');
if( query !== undefined )
- __myself.currQuery = query;
+ this.currQuery = query;
+ else
+ throw new Error("Pz2.js: no query supplied to the search command.");
+
+ if ( showfrom !== undefined )
+ var start = showfrom;
else
- throw new Error("You need to supply query to the search command");
+ var start = 0;
- var searchParams = { "command": "search", "query": __myself.currQuery, "session": __myself.sessionID };
+ var searchParams = {
+ "command": "search",
+ "query": this.currQuery,
+ "session": this.sessionID
+ };
if (filter !== undefined)
searchParams["filter"] = filter;
+
+ // copy additional parmeters, do not overwrite
+ if (addParamsArr != undefined) {
+ for (var prop in addParamsArr) {
+ if (!searchParams.hasOwnProperty(prop))
+ searchParams[prop] = addParamsArr[prop];
+ }
+ }
- var request = new pzHttpRequest(__myself.pz2String, __myself.errorHandler);
- request.get(
+ var context = this;
+ var request = new pzHttpRequest(this.pz2String, this.errorHandler);
+ request.safeGet(
searchParams,
function(data) {
- if ( data.getElementsByTagName("status")[0].childNodes[0].nodeValue == "OK" ) {
- __myself.searchStatusOK = true;
+ if ( data.getElementsByTagName("status")[0]
+ .childNodes[0].nodeValue == "OK" ) {
+ context.searchStatusOK = true;
//piggyback search
- __myself.show(0, num, sort);
- if ( __myself.statCallback )
- __myself.stat();
- //__myself.statTimer = setTimeout("__myself.stat()", __myself.statTime / 4);
- if ( __myself.termlistCallback )
- __myself.termlist();
- //__myself.termTimer = setTimeout("__myself.termlist()", __myself.termTime / 4);
- if ( __myself.bytargetCallback )
- __myself.bytarget();
- //__myself.bytargetTimer = setTimeout("__myself.bytarget()", __myself.bytargetTime / 4);
+ context.show(start, num, sort);
+ if ( context.statCallback )
+ context.stat();
+ if ( context.termlistCallback )
+ context.termlist();
+ if ( context.bytargetCallback )
+ context.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
- setTimeout("__myself.search(__myself.currQuery)", 500);
+ context.throwError('Search failed. Malformed WS resonse.',
+ 112);
}
);
},
stat: function()
{
- if( !__myself.initStatusOK )
- return;
+ if( !this.initStatusOK )
+ throw new Error('Pz2.js: session not initialized.');
+
// if called explicitly takes precedence
- clearTimeout(__myself.statTimer);
- var request = new pzHttpRequest(__myself.pz2String, __myself.errorHandler);
- request.get(
- { "command": "stat", "session": __myself.sessionID },
+ clearTimeout(this.statTimer);
+
+ var context = this;
+ var request = new pzHttpRequest(this.pz2String, this.errorHandler);
+ request.safeGet(
+ { "command": "stat", "session": this.sessionID },
function(data) {
if ( data.getElementsByTagName("stat") ) {
- var activeClients = Number( data.getElementsByTagName("activeclients")[0].childNodes[0].nodeValue );
- __myself.activeClients = activeClients;
- var stat = {
- "activeclients": activeClients,
- "hits": Number( data.getElementsByTagName("hits")[0].childNodes[0].nodeValue ),
- "records": Number( data.getElementsByTagName("records")[0].childNodes[0].nodeValue ),
- "clients": Number( data.getElementsByTagName("clients")[0].childNodes[0].nodeValue ),
- "initializing": Number( data.getElementsByTagName("initializing")[0].childNodes[0].nodeValue ),
- "searching": Number( data.getElementsByTagName("searching")[0].childNodes[0].nodeValue ),
- "presenting": Number( data.getElementsByTagName("presenting")[0].childNodes[0].nodeValue ),
- "idle": Number( data.getElementsByTagName("idle")[0].childNodes[0].nodeValue ),
- "failed": Number( data.getElementsByTagName("failed")[0].childNodes[0].nodeValue ),
- "error": Number( data.getElementsByTagName("error")[0].childNodes[0].nodeValue )
- };
+ var activeClients =
+ Number( data.getElementsByTagName("activeclients")[0]
+ .childNodes[0].nodeValue );
+ context.activeClients = activeClients;
+
+ var stat = Element_parseChildNodes(data.documentElement);
+
+ context.statCounter++;
+ var delay = context.statTime
+ + context.statCounter * context.dumpFactor;
- __myself.statCounter++;
- var delay = __myself.statTime + __myself.statCounter * __myself.dumpFactor;
if ( activeClients > 0 )
- __myself.statTimer = setTimeout("__myself.stat()", delay);
-
- __myself.statCallback(stat);
+ context.statTimer =
+ setTimeout(
+ function () {
+ context.stat();
+ },
+ delay
+ );
+ context.statCallback(stat);
}
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);
+ context.throwError('Stat failed. Malformed WS resonse.',
+ 113);
}
);
},
show: function(start, num, sort)
{
- if( !__myself.searchStatusOK )
- return;
+ if( !this.searchStatusOK && this.useSessions )
+ throw new Error(
+ 'Pz2.js: show command has to be preceded with a search command.'
+ );
+
// if called explicitly takes precedence
- clearTimeout(__myself.showTimer);
+ clearTimeout(this.showTimer);
if( sort !== undefined )
- __myself.currentSort = sort;
+ this.currentSort = sort;
if( start !== undefined )
- __myself.currentStart = Number( start );
+ this.currentStart = Number( start );
if( num !== undefined )
- __myself.currentNum = Number( num );
- var request = new pzHttpRequest(__myself.pz2String, __myself.errorHandler);
+ this.currentNum = Number( num );
+
var context = this;
- request.get(
- { "command": "show", "session": __myself.sessionID, "start": __myself.currentStart,
- "num": __myself.currentNum, "sort": __myself.currentSort, "block": 1 },
+ var request = new pzHttpRequest(this.pz2String, this.errorHandler);
+ request.safeGet(
+ {
+ "command": "show",
+ "session": this.sessionID,
+ "start": this.currentStart,
+ "num": this.currentNum,
+ "sort": this.currentSort,
+ "block": 1
+ },
function(data) {
- if ( data.getElementsByTagName("status")[0].childNodes[0].nodeValue == "OK" ) {
+ if ( data.getElementsByTagName("status")[0]
+ .childNodes[0].nodeValue == "OK" ) {
// 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 activeClients =
+ Number( data.getElementsByTagName("activeclients")[0]
+ .childNodes[0].nodeValue );
+ context.activeClients = activeClients;
var show = {
- "activeclients": activeClients,
- "merged": Number( data.getElementsByTagName("merged")[0].childNodes[0].nodeValue ),
- "total": Number( data.getElementsByTagName("total")[0].childNodes[0].nodeValue ),
- "start": Number( data.getElementsByTagName("start")[0].childNodes[0].nodeValue ),
- "num": Number( data.getElementsByTagName("num")[0].childNodes[0].nodeValue ),
- "hits": []
+ "activeclients": activeClients,
+ "merged":
+ Number( data.getElementsByTagName("merged")[0]
+ .childNodes[0].nodeValue ),
+ "total":
+ Number( data.getElementsByTagName("total")[0]
+ .childNodes[0].nodeValue ),
+ "start":
+ Number( data.getElementsByTagName("start")[0]
+ .childNodes[0].nodeValue ),
+ "num":
+ Number( data.getElementsByTagName("num")[0]
+ .childNodes[0].nodeValue ),
+ "hits": []
};
// parse all the first-level nodes for all <hit> tags
var hits = data.getElementsByTagName("hit");
- 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 ) {
- 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.showCounter++;
- var delay = __myself.showTime;
- if (__myself.showCounter > __myself.showFastCount)
- delay += __myself.showCounter * __myself.dumpFactor;
+ for (i = 0; i < hits.length; i++)
+ show.hits[i] = Element_parseChildNodes(hits[i]);
+
+ context.showCounter++;
+ var delay = context.showTime;
+ if (context.showCounter > context.showFastCount)
+ delay += context.showCounter * context.dumpFactor;
if ( activeClients > 0 )
- __myself.showTimer = setTimeout("__myself.show()", delay);
-
- __myself.showCallback(show);
+ context.showTimer = setTimeout(
+ function () {
+ context.show();
+ },
+ delay);
+ global_show = show;
+ context.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);
+ context.throwError('Show failed. Malformed WS resonse.',
+ 114);
}
);
},
- record: function(id,offset, params)
+ record: function(id, offset, syntax, handler)
{
- if ( params == undefined )
- params = {};
-
- if ( params.callback != undefined ) {
- callback = params.callback;
- } else {
- callback = __myself.recordCallback;
- }
-
- if ( params['handle'] == undefined )
- handle = {};
- else
- handle = params['handle'];
-
- if( !__myself.searchStatusOK && __myself.useSessions)
- return;
-
+ // we may call record with no previous search if in proxy mode
+ if(!this.searchStatusOK && this.useSessions)
+ throw new Error(
+ 'Pz2.js: record command has to be preceded with a search command.'
+ );
+
if( id !== undefined )
- __myself.currRecID = id;
- var request = new pzHttpRequest(__myself.pz2String, __myself.errorHandler);
+ this.currRecID = id;
+
+ var recordParams = {
+ "command": "record",
+ "session": this.sessionID,
+ "id": this.currRecID
+ };
+
+ this.currRecOffset = null;
+ if (offset != undefined) {
+ recordParams["offset"] = offset;
+ this.currRecOffset = offset;
+ }
- var recordParams = { "command": "record", "session": __myself.sessionID, "id": __myself.currRecID };
- if (offset !== undefined) {
- recordParams["offset"] = offset;
- }
+ if (syntax != undefined)
+ recordParams['syntax'] = syntax;
- if (params.syntax != undefined) {
- recordParams['syntax'] = params.syntax;
+ //overwrite default callback id needed
+ var callback = this.recordCallback;
+ var args = undefined;
+ if (handler != undefined) {
+ callback = handler['callback'];
+ args = handler['args'];
}
+
+ var context = this;
+ var request = new pzHttpRequest(this.pz2String, this.errorHandler);
- __myself.currRecOffset = offset;
- request.get(
+ request.safeGet(
recordParams,
function(data) {
var recordNode;
- var record = new Array();
- record['xmlDoc'] = data;
- if (__myself.currRecOffset !== undefined) {
- record['offset'] = __myself.currRecOffset;
- callback(record, handle);
- } else if ( recordNode = data.getElementsByTagName("record")[0] ) {
+ var record;
+ //raw record
+ if (context.currRecOffset !== null) {
+ record = new Array();
+ record['xmlDoc'] = data;
+ record['offset'] = context.currRecOffset;
+ callback(record, args);
+ //pz2 record
+ } 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;
+ if ( context.xslDoc ) {
+ record = new Array();
+ record['xmlDoc'] = data;
+ record['xslDoc'] = context.xslDoc;
+ record['recid'] =
+ recordNode.getElementsByTagName("recid")[0]
+ .firstChild.nodeValue;
+ //parse record
} 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 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;
- }
- }
- }
- }
-
- callback(record, handle);
+ record = Element_parseChildNodes(recordNode);
+ }
+ var activeClients =
+ Number( data.getElementsByTagName("activeclients")[0]
+ .childNodes[0].nodeValue );
+ context.activeClients = activeClients;
+ context.recordCounter++;
+ var delay = context.recordTime + context.recordCounter * context.dumpFactor;
+ if ( activeClients > 0 )
+ context.recordTimer =
+ setTimeout (
+ function() {
+ context.record(id, offset, syntax, handler);
+ },
+ delay
+ );
+ callback(record, args);
}
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)", 500);
+ context.throwError('Record failed. Malformed WS resonse.',
+ 115);
}
);
},
+
termlist: function()
{
- if( !__myself.searchStatusOK )
- return;
+ if( !this.searchStatusOK && this.useSessions )
+ throw new Error(
+ 'Pz2.js: termlist command has to be preceded with a search command.'
+ );
+
// if called explicitly takes precedence
- clearTimeout(__myself.termTimer);
- var request = new pzHttpRequest(__myself.pz2String, __myself.errorHandler);
- request.get(
- { "command": "termlist", "session": __myself.sessionID, "name": __myself.termKeys },
+ clearTimeout(this.termTimer);
+
+ var context = this;
+ var request = new pzHttpRequest(this.pz2String, this.errorHandler);
+ request.safeGet(
+ {
+ "command": "termlist",
+ "session": this.sessionID,
+ "name": this.termKeys
+ },
function(data) {
if ( data.getElementsByTagName("termlist") ) {
- var activeClients = Number( data.getElementsByTagName("activeclients")[0].childNodes[0].nodeValue );
- __myself.activeClients = activeClients;
+ var activeClients =
+ Number( data.getElementsByTagName("activeclients")[0]
+ .childNodes[0].nodeValue );
+ context.activeClients = activeClients;
var termList = { "activeclients": activeClients };
var termLists = data.getElementsByTagName("list");
//for each termlist
//for each term in the list
for (j = 0; j < terms.length; j++) {
var term = {
- "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'
+ "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");
+ var termIdNode =
+ terms[j].getElementsByTagName("id");
if(terms[j].getElementsByTagName("id").length)
- term["id"] = termIdNode[0].childNodes[0].nodeValue;
-
+ term["id"] =
+ termIdNode[0].childNodes[0].nodeValue;
termList[listName][j] = term;
}
}
- __myself.termCounter++;
- var delay = __myself.termTime + __myself.termCounter * __myself.dumpFactor;
+ context.termCounter++;
+ var delay = context.termTime
+ + context.termCounter * context.dumpFactor;
if ( activeClients > 0 )
- __myself.termTimer = setTimeout("__myself.termlist()", delay);
+ context.termTimer =
+ setTimeout(
+ function () {
+ context.termlist();
+ },
+ delay
+ );
- __myself.termlistCallback(termList);
+ context.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);
+ context.throwError('Termlist failed. Malformed WS resonse.',
+ 116);
}
);
},
bytarget: function()
{
- if( !__myself.searchStatusOK )
+ if( !this.initStatusOK && this.useSessions )
+ throw new Error(
+ 'Pz2.js: bytarget command has to be preceded with a search command.'
+ );
+
+ // no need to continue
+ if( !this.searchStatusOK )
return;
+
// if called explicitly takes precedence
- clearTimeout(__myself.bytargetTimer);
- var request = new pzHttpRequest(__myself.pz2String, __myself.errorHandler);
- request.get(
- { "command": "bytarget", "session": __myself.sessionID },
+ clearTimeout(this.bytargetTimer);
+
+ var context = this;
+ var request = new pzHttpRequest(this.pz2String, this.errorHandler);
+ request.safeGet(
+ { "command": "bytarget", "session": this.sessionID },
function(data) {
- if ( data.getElementsByTagName("status")[0].childNodes[0].nodeValue == "OK" ) {
+ if ( data.getElementsByTagName("status")[0]
+ .childNodes[0].nodeValue == "OK" ) {
var targetNodes = data.getElementsByTagName("target");
var bytarget = new Array();
for ( i = 0; i < targetNodes.length; i++) {
bytarget[i] = new Array();
for( j = 0; j < targetNodes[i].childNodes.length; j++ ) {
- if ( targetNodes[i].childNodes[j].nodeType == Node.ELEMENT_NODE ) {
- var nodeName = targetNodes[i].childNodes[j].nodeName;
- var nodeText = targetNodes[i].childNodes[j].firstChild.nodeValue;
+ if ( targetNodes[i].childNodes[j].nodeType
+ == Node.ELEMENT_NODE ) {
+ var nodeName =
+ targetNodes[i].childNodes[j].nodeName;
+ var nodeText =
+ targetNodes[i].childNodes[j]
+ .firstChild.nodeValue;
bytarget[i][nodeName] = nodeText;
}
}
}
- __myself.bytargetCounter++;
- var delay = __myself.bytargetTime + __myself.bytargetCounter * __myself.dumpFactor;
- if ( __myself.activeClients > 0 )
- __myself.bytargetTimer = setTimeout("__myself.bytarget()", delay);
-
- __myself.bytargetCallback(bytarget);
+ context.bytargetCounter++;
+ var delay = context.bytargetTime
+ + context.bytargetCounter * context.dumpFactor;
+ if ( context.activeClients > 0 )
+ context.bytargetTimer =
+ setTimeout(
+ function () {
+ context.bytarget();
+ },
+ delay
+ );
+
+ context.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);
+ context.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 );
+ this.show( ( step * this.currentNum ) + this.currentStart );
},
+
showPrev: function(page)
{
- if (__myself.currentStart == 0 )
+ if (this.currentStart == 0 )
return false;
var step = page || 1;
- var newStart = __myself.currentStart - (step * __myself.currentNum );
- __myself.show( newStart > 0 ? newStart : 0 );
+ var newStart = this.currentStart - (step * this.currentNum );
+ this.show( newStart > 0 ? newStart : 0 );
},
+
showPage: function(pageNum)
{
//var page = pageNum || 1;
- __myself.show(pageNum * __myself.currentNum);
+ this.show(pageNum * this.currentNum);
}
};
/*
-*********************************************************************************
-** AJAX HELPER CLASS ************************************************************
-*********************************************************************************
+********************************************************************************
+** AJAX HELPER CLASS ***********************************************************
+********************************************************************************
*/
var pzHttpRequest = function ( url, errorHandler ) {
+ this.maxUrlLength = 2048;
this.request = null;
this.url = url;
this.errorHandler = errorHandler || null;
this.async = true;
+ this.requestHeaders = {};
if ( window.XMLHttpRequest ) {
this.request = new XMLHttpRequest();
pzHttpRequest.prototype =
{
+ safeGet: function ( params, callback )
+ {
+ var encodedParams = this.encodeParams(params);
+ var url = this._urlAppendParams(encodedParams);
+ if (url.length >= this.maxUrlLength) {
+ this.requestHeaders["Content-Type"]
+ = "application/x-www-form-urlencoded";
+ this._send( 'POST', this.url, encodedParams, callback );
+ } else {
+ this._send( 'GET', url, '', callback );
+ }
+ },
+
get: function ( params, callback )
{
- this._send( 'GET', params, '', callback );
+ this._send( 'GET', this._urlAppendParams(this.encodeParams(params)),
+ '', callback );
},
post: function ( params, data, callback )
{
- this._send( 'POST', params, data, callback );
+ this._send( 'POST', this._urlAppendParams(this.encodeParams(params)),
+ data, callback );
},
load: function ()
return this.request.responseXML;
},
- _send: function ( type, params, data, callback )
+ encodeParams: function (params)
{
- this.callback = callback;
- var context = this;
- this.async = true;
- this.request.open( type, this._urlAppendParams(params), this.async );
- this.request.onreadystatechange = function () {
- context._handleResponse();
+ var sep = "";
+ var encoded = "";
+ for (var key in params) {
+ if (params[key] != null) {
+ encoded += sep + key + '=' + encodeURIComponent(params[key]);
+ sep = '&';
+ }
}
- this.request.send(data);
+ return encoded;
},
- _urlAppendParams: function (params)
+ _send: function ( type, url, data, callback)
{
- var getUrl = this.url;
-
- var sep = '?';
- var el = params;
- for (var key in el) {
- if (el[key] != null) {
- getUrl += sep + key + '=' + encodeURI(el[key]);
- sep = '&';
- }
+ var context = this;
+ this.callback = callback;
+ this.async = true;
+ this.request.open( type, url, this.async );
+ for (var key in this.requestHeaders)
+ this.request.setRequestHeader(key, this.requestHeaders[key]);
+ this.request.onreadystatechange = function () {
+ context._handleResponse(url); /// url used ONLY for error reporting
}
- return getUrl;
+ this.request.send(data);
},
- _handleResponse: function ()
+ _urlAppendParams: function (encodedParams)
{
- if ( this.request.readyState == 4 ) {
- if ( this.request.status == 200 ) {
- this.callback( this.request.responseXML );
- }
- // pz errors
- else if ( this.request.status == 417 ) {
- var errMsg = this.request.responseXML.getElementsByTagName("error")[0].childNodes[0].nodeValue;
- var errCode = this.request.responseXML.getElementsByTagName("error")[0].getAttribute("code");
-
- var err = new Error(errMsg);
+ if (encodedParams)
+ return this.url + "?" + encodedParams;
+ else
+ return this.url;
+ },
+
+ _handleResponse: function (savedUrlForErrorReporting)
+ {
+ if ( this.request.readyState == 4 ) {
+ // pick up appplication errors first
+ var errNode = null;
+ if (this.request.responseXML &&
+ (errNode = this.request.responseXML.documentElement)
+ && errNode.nodeName == 'error') {
+ var errMsg = errNode.getAttribute("msg");
+ var errCode = errNode.getAttribute("code");
+ var errAddInfo = '';
+ if (errNode.childNodes.length)
+ errAddInfo = ': ' + errNode.childNodes[0].nodeValue;
+
+ var err = new Error(errMsg + errAddInfo);
err.code = errCode;
if (this.errorHandler) {
else {
throw err;
}
- }
- else {
- var err = new Error("XMLHttpRequest error. STATUS: "
- + this.request.status + " STATUS TEXT: "
+ } else if (this.request.status == 200 &&
+ this.request.responseXML == null) {
+ var err = new Error("XML response is empty but no error " +
+ "for " + savedUrlForErrorReporting);
+ err.code = -1;
+ 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("HTTP response not OK: "
+ + this.request.status + " - "
+ this.request.statusText );
- err.code = 'HTTP';
+ err.code = '00' + this.request.status;
if (this.errorHandler) {
this.errorHandler(err);
};
/*
-*********************************************************************************
-** QUERY CLASS ******************************************************************
-*********************************************************************************
+********************************************************************************
+** XML HELPER FUNCTIONS ********************************************************
+********************************************************************************
*/
-var pzQuery = function()
+
+// DOMDocument
+
+if ( window.ActiveXObject) {
+ var DOMDoc = document;
+} else {
+ var DOMDoc = Document.prototype;
+}
+
+DOMDoc.newXmlDoc = function ( root )
{
- this.simpleQuery = '';
- this.singleFilter = null;
- this.advTerms = new Array();
- this.filterHash = new Array();
- this.numTerms = 0;
- this.filterNums = 0;
-};
-pzQuery.prototype = {
- reset: function()
- {
- this.simpleQuery = '';
- this.advTerms = new Array();
- this.simpleFilter = null;
- this.numTerms = 0;
- },
- clearSimpleQuery: function()
- {
- this.simpleQuery = '';
- },
- addTerm: function(field, value)
- {
- var term = {"field": field, "value": value};
- this.advTerms[this.numTerms] = term;
- this.numTerms++;
- },
- getTermValueByIdx: function(index)
- {
- return this.advTerms[index].value;
- },
- getTermFieldByIdx: function(index)
- {
- return this.advTerms[index].field;
- },
- /* semicolon separated list of terms for given field*/
- getTermsByField: function(field)
- {
- var terms = '';
- for(var i = 0; i < this.advTerms.length; i++)
- {
- if( this.advTerms[i].field == field )
- terms = terms + this.queryHas[i].value + ';';
- }
- return terms;
- },
- addTermsFromList: function(inputString, field)
- {
- var inputArr = inputString.split(';');
- for(var i=0; i < inputArr.length; i++)
- {
- if(inputArr[i].length < 3) continue;
- this.advTerms[this.numTerms] = {"field": field, "value": inputArr[i] };
- this.numTerms++;
- }
- },
- removeTermByIdx: function(index)
- {
- this.advTerms.splice(index, 1);
- this.numTerms--;
- },
- toCCL: function()
- {
- var ccl = '';
- if( this.simpleQuery != '')
- ccl = this.simpleQuery;
- for(var i = 0; i < this.advTerms.length; i++)
- {
- if (ccl != '') ccl = ccl + ' and ';
- ccl = ccl + this.advTerms[i].field+'="'+this.advTerms[i].value+'"';
- }
- return ccl;
- },
- addFilter: function(name, value)
- {
- var filter = {"name": name, "id": value };
- this.filterHash[this.filterHash.length] = filter;
- this.filterNums++
- return this.filterHash.length - 1;
- },
- setFilter: function(name, value)
- {
- this.filterHash = new Array();
- this.filterNums = 0;
- this.addFilter(name, value);
- },
- getFilter: function(index)
- {
- return this.filterHash[index].id;
- },
- getFilterName: function(index)
- {
- return this.filterHash[index].name;
- },
- removeFilter: function(index)
- {
- delete this.filterHash[index];
- this.filterNums--;
- },
- clearFilter: function()
- {
- this.filterHash = new Array();
- this.filterNums = 0;
- },
- getFilterString: function()
- {
- //temporary
- if( this.singleFilter != null ) {
- return 'pz:id='+this.singleFilter.id;
- }
- else if( this.filterNums <= 0 ) {
- return undefined;
- }
+ 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);
- var filter = 'pz:id=';
- for(var i = 0; i < this.filterHash.length; i++)
- {
- if (this.filterHash[i] == undefined) continue;
- if (filter > 'pz:id=') filter = filter + '|';
- filter += this.filterHash[i].id;
+ 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.");
+ }
+}
+
+Element_parseChildNodes = function (node)
+{
+ var parsed = {};
+ var hasChildElems = false;
+
+ if (node.hasChildNodes()) {
+ var children = node.childNodes;
+ for (var i = 0; i < children.length; i++) {
+ var child = children[i];
+ if (child.nodeType == Node.ELEMENT_NODE) {
+ hasChildElems = true;
+ var nodeName = child.nodeName;
+ if (!(nodeName in parsed))
+ parsed[nodeName] = [];
+ parsed[nodeName].push(Element_parseChildNodes(child));
+ }
}
- return filter;
- },
- totalLength: function()
- {
- var simpleLength = this.simpleQuery != '' ? 1 : 0;
- return this.advTerms.length + simpleLength;
- },
- clearSingleFilter: function()
- {
- this.singleFilter = null;
- },
- setSingleFilter: function(name, value)
- {
- this.singleFilter = {"name": name, "id": value };
- },
- getSingleFilterName: function()
- {
- return this.singleFilter.name;
}
+
+ var attrs = node.attributes;
+ for (var i = 0; i < attrs.length; i++) {
+ var attrName = '@' + attrs[i].nodeName;
+ var attrValue = attrs[i].nodeValue;
+ parsed[attrName] = attrValue;
+ }
+
+ // if no nested elements, get text content
+ if (node.hasChildNodes() && !hasChildElems) {
+ if (node.attributes.length)
+ parsed['#text'] = node.firstChild.nodeValue;
+ else
+ parsed = node.firstChild.nodeValue;
+ }
+
+ return parsed;
}
+/* do not remove trailing bracket */
}