2 ** $Id: pz2.js,v 1.66 2007-11-13 12:51:29 jakub Exp $
3 ** pz2.js - pazpar2's javascript client library.
6 //since explorer is flawed
8 window.Node = new Object();
10 Node.ATTRIBUTE_NODE = 2;
12 Node.CDATA_SECTION_NODE = 4;
13 Node.ENTITY_REFERENCE_NODE = 5;
15 Node.PROCESSING_INSTRUCTION_NODE = 7;
16 Node.COMMENT_NODE = 8;
17 Node.DOCUMENT_NODE = 9;
18 Node.DOCUMENT_TYPE_NODE = 10;
19 Node.DOCUMENT_FRAGMENT_NODE = 11;
20 Node.NOTATION_NODE = 12;
23 // prevent execution of more than once
24 if(typeof window.pz2 == "undefined") {
25 window.undefined = window.undefined;
27 var pz2 = function ( paramArray )
30 // at least one callback required
32 throw new Error("Pz2.js: Array with parameters has to be suplied.");
34 //supported pazpar2's protocol version
35 this.suppProtoVer = '1';
36 if (typeof paramArray.pazpar2path != "undefined")
37 this.pz2String = paramArray.pazpar2path;
39 this.pz2String = "/pazpar2/search.pz2";
40 this.useSessions = true;
42 this.stylesheet = paramArray.detailstylesheet || null;
43 //load stylesheet if required in async mode
44 if( this.stylesheet ) {
46 var request = new pzHttpRequest( this.stylesheet );
47 request.get( {}, function ( doc ) { context.xslDoc = doc; } );
50 this.errorHandler = paramArray.errorhandler || null;
53 this.initCallback = paramArray.oninit || null;
54 this.statCallback = paramArray.onstat || null;
55 this.showCallback = paramArray.onshow || null;
56 this.termlistCallback = paramArray.onterm || null;
57 this.recordCallback = paramArray.onrecord || null;
58 this.bytargetCallback = paramArray.onbytarget || null;
59 this.resetCallback = paramArray.onreset || null;
62 this.termKeys = paramArray.termlist || "subject";
64 // some configurational stuff
65 this.keepAlive = 50000;
67 if ( paramArray.keepAlive < this.keepAlive )
68 this.keepAlive = paramArray.keepAlive;
70 this.sessionID = null;
71 this.initStatusOK = false;
72 this.pingStatusOK = false;
73 this.searchStatusOK = false;
76 this.currentSort = "relevance";
79 this.currentStart = 0;
82 // last full record retrieved
83 this.currRecID = null;
86 this.currQuery = null;
89 this.statTime = paramArray.stattime || 1000;
90 this.statTimer = null;
91 this.termTime = paramArray.termtime || 1000;
92 this.termTimer = null;
93 this.showTime = paramArray.showtime || 1000;
94 this.showTimer = null;
95 this.showFastCount = 4;
96 this.bytargetTime = paramArray.bytargettime || 1000;
97 this.bytargetTimer = null;
99 // counters for each command and applied delay
100 this.dumpFactor = 500;
101 this.showCounter = 0;
102 this.termCounter = 0;
103 this.statCounter = 0;
104 this.bytargetCounter = 0;
106 // active clients, updated by stat and show
107 // might be an issue since bytarget will poll accordingly
108 this.activeClients = 1;
110 // if in proxy mode no need to init
111 if (paramArray.usesessions != undefined) {
112 this.useSessions = paramArray.usesessions;
113 this.initStatusOK = true;
115 // else, auto init session or wait for a user init?
116 if (this.useSessions && paramArray.autoInit !== false) {
123 //error handler for async error throws
124 throwError: function (errMsg, errCode)
126 var err = new Error(errMsg);
127 if (errCode) err.code = errCode;
129 if (this.errorHandler) {
130 this.errorHandler(err);
137 // stop activity by clearing tiemouts
140 clearTimeout(this.statTimer);
141 clearTimeout(this.showTimer);
142 clearTimeout(this.termTimer);
143 clearTimeout(this.bytargetTimer);
146 // reset status variables
149 if ( this.useSessions ) {
150 this.sessionID = null;
151 this.initStatusOK = false;
152 this.pingStatusOK = false;
154 this.searchStatusOK = false;
157 if ( this.resetCallback )
158 this.resetCallback();
161 init: function ( sessionId )
165 // session id as a param
166 if ( sessionId != undefined && this.useSessions ) {
167 this.initStatusOK = true;
168 this.sessionID = sessionId;
170 // old school direct pazpar2 init
171 } else if (this.useSessions) {
173 var request = new pzHttpRequest(this.pz2String, this.errorHandler);
175 { "command": "init" },
177 if ( data.getElementsByTagName("status")[0]
178 .childNodes[0].nodeValue == "OK" ) {
179 if ( data.getElementsByTagName("protocol")[0]
180 .childNodes[0].nodeValue
181 != context.suppProtoVer )
183 "Server's protocol not supported by the client"
185 context.initStatusOK = true;
187 data.getElementsByTagName("session")[0]
188 .childNodes[0].nodeValue;
195 if ( context.initCallback )
196 context.initCallback();
199 context.throwError('Init failed. Malformed WS resonse.',
203 // when through proxy no need to init
205 this.initStatusOK = true;
208 // no need to ping explicitly
211 // pinging only makes sense when using pazpar2 directly
212 if( !this.initStatusOK || !this.useSessions )
214 'Pz2.js: Ping not allowed (proxy mode) or session not initialized.'
217 var request = new pzHttpRequest(this.pz2String, this.errorHandler);
219 { "command": "ping", "session": this.sessionID },
221 if ( data.getElementsByTagName("status")[0]
222 .childNodes[0].nodeValue == "OK" ) {
223 context.pingStatusOK = true;
232 context.throwError('Ping failed. Malformed WS resonse.',
237 search: function (query, num, sort, filter, showfrom)
239 clearTimeout(this.statTimer);
240 clearTimeout(this.showTimer);
241 clearTimeout(this.termTimer);
242 clearTimeout(this.bytargetTimer);
244 this.showCounter = 0;
245 this.termCounter = 0;
246 this.bytargetCounter = 0;
247 this.statCounter = 0;
250 if( !this.initStatusOK )
251 throw new Error('Pz2.js: session not initialized.');
253 if( query !== undefined )
254 this.currQuery = query;
256 throw new Error("Pz2.js: no query supplied to the search command.");
258 if ( showfrom !== undefined )
259 var start = showfrom;
265 "query": this.currQuery,
266 "session": this.sessionID
269 if (filter !== undefined)
270 searchParams["filter"] = filter;
273 var request = new pzHttpRequest(this.pz2String, this.errorHandler);
277 if ( data.getElementsByTagName("status")[0]
278 .childNodes[0].nodeValue == "OK" ) {
279 context.searchStatusOK = true;
281 context.show(start, num, sort);
282 if ( context.statCallback )
284 if ( context.termlistCallback )
286 if ( context.bytargetCallback )
290 context.throwError('Search failed. Malformed WS resonse.',
297 if( !this.initStatusOK )
298 throw new Error('Pz2.js: session not initialized.');
300 // if called explicitly takes precedence
301 clearTimeout(this.statTimer);
304 var request = new pzHttpRequest(this.pz2String, this.errorHandler);
306 { "command": "stat", "session": this.sessionID },
308 if ( data.getElementsByTagName("stat") ) {
310 Number( data.getElementsByTagName("activeclients")[0]
311 .childNodes[0].nodeValue );
312 context.activeClients = activeClients;
314 "activeclients": activeClients,
316 Number( data.getElementsByTagName("hits")[0]
317 .childNodes[0].nodeValue ),
319 Number( data.getElementsByTagName("records")[0]
320 .childNodes[0].nodeValue ),
322 Number( data.getElementsByTagName("clients")[0]
323 .childNodes[0].nodeValue ),
325 Number( data.getElementsByTagName("initializing")[0]
326 .childNodes[0].nodeValue ),
328 Number( data.getElementsByTagName("searching")[0]
329 .childNodes[0].nodeValue ),
331 Number( data.getElementsByTagName("presenting")[0]
332 .childNodes[0].nodeValue ),
334 Number( data.getElementsByTagName("idle")[0]
335 .childNodes[0].nodeValue ),
337 Number( data.getElementsByTagName("failed")[0]
338 .childNodes[0].nodeValue ),
340 Number( data.getElementsByTagName("error")[0]
341 .childNodes[0].nodeValue )
344 context.statCounter++;
345 var delay = context.statTime
346 + context.statCounter * context.dumpFactor;
348 if ( activeClients > 0 )
356 context.statCallback(stat);
359 context.throwError('Stat failed. Malformed WS resonse.',
364 show: function(start, num, sort)
366 if( !this.searchStatusOK && this.useSessions )
368 'Pz2.js: show command has to be preceded with a search command.'
371 // if called explicitly takes precedence
372 clearTimeout(this.showTimer);
374 if( sort !== undefined )
375 this.currentSort = sort;
376 if( start !== undefined )
377 this.currentStart = Number( start );
378 if( num !== undefined )
379 this.currentNum = Number( num );
382 var request = new pzHttpRequest(this.pz2String, this.errorHandler);
386 "session": this.sessionID,
387 "start": this.currentStart,
388 "num": this.currentNum,
389 "sort": this.currentSort,
393 if ( data.getElementsByTagName("status")[0]
394 .childNodes[0].nodeValue == "OK" ) {
395 // first parse the status data send along with records
396 // this is strictly bound to the format
398 Number( data.getElementsByTagName("activeclients")[0]
399 .childNodes[0].nodeValue );
400 context.activeClients = activeClients;
402 "activeclients": activeClients,
404 Number( data.getElementsByTagName("merged")[0]
405 .childNodes[0].nodeValue ),
407 Number( data.getElementsByTagName("total")[0]
408 .childNodes[0].nodeValue ),
410 Number( data.getElementsByTagName("start")[0]
411 .childNodes[0].nodeValue ),
413 Number( data.getElementsByTagName("num")[0]
414 .childNodes[0].nodeValue ),
417 // parse all the first-level nodes for all <hit> tags
418 var hits = data.getElementsByTagName("hit");
419 var hit = new Array();
420 for (i = 0; i < hits.length; i++) {
421 show.hits[i] = new Array();
422 show.hits[i]['location'] = new Array();
424 for ( j = 0; j < hits[i].childNodes.length; j++) {
425 if ( hits[i].childNodes[j].nodeType
426 == Node.ELEMENT_NODE ) {
427 if (hits[i].childNodes[j].nodeName
429 var locNode = hits[i].childNodes[j];
430 var id = locNode.getAttribute('id');
431 show.hits[i]['location'][locCount] = {
432 "id": locNode.getAttribute("id"),
433 "name": locNode.getAttribute("name")
439 hits[i].childNodes[j].nodeName;
440 var nodeText = 'ERROR'
441 if ( hits[i].childNodes[j].firstChild )
443 hits[i].childNodes[j]
444 .firstChild.nodeValue;
445 show.hits[i][nodeName] = nodeText;
450 context.showCounter++;
451 var delay = context.showTime;
452 if (context.showCounter > context.showFastCount)
453 delay += context.showCounter * context.dumpFactor;
454 if ( activeClients > 0 )
455 context.showTimer = setTimeout(
461 context.showCallback(show);
464 context.throwError('Show failed. Malformed WS resonse.',
469 record: function(id, offset, params)
471 // we may call record with no previous search if in proxy mode
472 if( !this.searchStatusOK && this.useSessions)
474 'Pz2.js: record command has to be preceded with a search command.'
476 if ( params == undefined )
479 if ( params.callback != undefined ) {
480 callback = params.callback;
482 callback = this.recordCallback;
486 if ( params['handle'] == undefined )
489 handle = params['handle'];
491 if( id !== undefined )
495 var request = new pzHttpRequest(this.pz2String, this.errorHandler);
497 var recordParams = { "command": "record",
498 "session": this.sessionID,
499 "id": this.currRecID };
501 if (offset !== undefined) {
502 recordParams["offset"] = offset;
505 if (params.syntax != undefined) {
506 recordParams['syntax'] = params.syntax;
509 this.currRecOffset = offset;
515 var record = new Array();
516 record['xmlDoc'] = data;
517 if (context.currRecOffset !== undefined) {
518 record['offset'] = context.currRecOffset;
519 callback(record, handle);
520 } else if ( recordNode =
521 data.getElementsByTagName("record")[0] ) {
522 // if stylesheet was fetched do not parse the response
523 if ( context.xslDoc ) {
525 recordNode.getElementsByTagName("recid")[0]
526 .firstChild.nodeValue;
530 for ( i = 0; i < recordNode.childNodes.length; i++) {
531 if ( recordNode.childNodes[i].nodeType
533 && recordNode.childNodes[i].nodeName
536 recordNode.childNodes[i].nodeName;
538 if (recordNode.childNodes[i].firstChild)
539 nodeText = recordNode.childNodes[i]
540 .firstChild.nodeValue;
541 record[nodeName] = nodeText;
544 // the location might be empty!!
546 recordNode.getElementsByTagName("location");
547 record["location"] = new Array();
548 for ( i = 0; i < locationNodes.length; i++ ) {
549 record["location"][i] = {
550 "id": locationNodes[i].getAttribute("id"),
551 "name": locationNodes[i].getAttribute("name")
555 j < locationNodes[i].childNodes.length;
557 if ( locationNodes[i].childNodes[j].nodeType
558 == Node.ELEMENT_NODE ) {
560 locationNodes[i].childNodes[j].nodeName;
562 if (locationNodes[i].childNodes[j]
565 locationNodes[i].childNodes[j]
566 .firstChild.nodeValue;
568 if (nodeName == 'md-subject') {
569 if (record["location"][i]['nodeName']) {
570 record["location"][i][nodeName]
573 record["location"][i][nodeName]
575 record["location"][i][nodeName]
579 record["location"][i][nodeName]
587 callback(record, handle);
590 context.throwError('Record failed. Malformed WS resonse.',
598 if( !this.searchStatusOK && this.useSessions )
600 'Pz2.js: termlist command has to be preceded with a search command.'
603 // if called explicitly takes precedence
604 clearTimeout(this.termTimer);
607 var request = new pzHttpRequest(this.pz2String, this.errorHandler);
610 "command": "termlist",
611 "session": this.sessionID,
612 "name": this.termKeys
615 if ( data.getElementsByTagName("termlist") ) {
617 Number( data.getElementsByTagName("activeclients")[0]
618 .childNodes[0].nodeValue );
619 context.activeClients = activeClients;
620 var termList = { "activeclients": activeClients };
621 var termLists = data.getElementsByTagName("list");
623 for (i = 0; i < termLists.length; i++) {
624 var listName = termLists[i].getAttribute('name');
625 termList[listName] = new Array();
626 var terms = termLists[i].getElementsByTagName('term');
627 //for each term in the list
628 for (j = 0; j < terms.length; j++) {
631 (terms[j].getElementsByTagName("name")[0]
633 ? terms[j].getElementsByTagName("name")[0]
634 .childNodes[0].nodeValue
638 .getElementsByTagName("frequency")[0]
639 .childNodes[0].nodeValue || 'ERROR'
643 terms[j].getElementsByTagName("id");
644 if(terms[j].getElementsByTagName("id").length)
646 termIdNode[0].childNodes[0].nodeValue;
647 termList[listName][j] = term;
651 context.termCounter++;
652 var delay = context.termTime
653 + context.termCounter * context.dumpFactor;
654 if ( activeClients > 0 )
663 context.termlistCallback(termList);
666 context.throwError('Termlist failed. Malformed WS resonse.',
674 if( !this.initStatusOK && this.useSessions )
676 'Pz2.js: bytarget command has to be preceded with a search command.'
679 // no need to continue
680 if( !this.searchStatusOK )
683 // if called explicitly takes precedence
684 clearTimeout(this.bytargetTimer);
687 var request = new pzHttpRequest(this.pz2String, this.errorHandler);
689 { "command": "bytarget", "session": this.sessionID },
691 if ( data.getElementsByTagName("status")[0]
692 .childNodes[0].nodeValue == "OK" ) {
693 var targetNodes = data.getElementsByTagName("target");
694 var bytarget = new Array();
695 for ( i = 0; i < targetNodes.length; i++) {
696 bytarget[i] = new Array();
697 for( j = 0; j < targetNodes[i].childNodes.length; j++ ) {
698 if ( targetNodes[i].childNodes[j].nodeType
699 == Node.ELEMENT_NODE ) {
701 targetNodes[i].childNodes[j].nodeName;
703 targetNodes[i].childNodes[j]
704 .firstChild.nodeValue;
705 bytarget[i][nodeName] = nodeText;
710 context.bytargetCounter++;
711 var delay = context.bytargetTime
712 + context.bytargetCounter * context.dumpFactor;
713 if ( context.activeClients > 0 )
714 context.bytargetTimer =
722 context.bytargetCallback(bytarget);
725 context.throwError('Bytarget failed. Malformed WS resonse.',
731 // just for testing, probably shouldn't be here
732 showNext: function(page)
734 var step = page || 1;
735 this.show( ( step * this.currentNum ) + this.currentStart );
738 showPrev: function(page)
740 if (this.currentStart == 0 )
742 var step = page || 1;
743 var newStart = this.currentStart - (step * this.currentNum );
744 this.show( newStart > 0 ? newStart : 0 );
747 showPage: function(pageNum)
749 //var page = pageNum || 1;
750 this.show(pageNum * this.currentNum);
755 ********************************************************************************
756 ** AJAX HELPER CLASS ***********************************************************
757 ********************************************************************************
759 var pzHttpRequest = function ( url, errorHandler ) {
762 this.errorHandler = errorHandler || null;
765 if ( window.XMLHttpRequest ) {
766 this.request = new XMLHttpRequest();
767 } else if ( window.ActiveXObject ) {
769 this.request = new ActiveXObject( 'Msxml2.XMLHTTP' );
771 this.request = new ActiveXObject( 'Microsoft.XMLHTTP' );
776 pzHttpRequest.prototype =
778 get: function ( params, callback )
780 this._send( 'GET', params, '', callback );
783 post: function ( params, data, callback )
785 this._send( 'POST', params, data, callback );
791 this.request.open( 'GET', this.url, this.async );
792 this.request.send('');
793 if ( this.request.status == 200 )
794 return this.request.responseXML;
797 _send: function ( type, params, data, callback )
799 this.callback = callback;
802 this.request.open( type, this._urlAppendParams(params), this.async );
803 this.request.onreadystatechange = function () {
804 context._handleResponse();
806 this.request.send(data);
809 _urlAppendParams: function (params)
811 var getUrl = this.url;
815 for (var key in el) {
816 if (el[key] != null) {
817 getUrl += sep + key + '=' + encodeURIComponent(el[key]);
824 _handleResponse: function ()
826 if ( this.request.readyState == 4 ) {
827 // pick up pazpr2 errors first
828 if ( this.request.responseXML
829 && this.request.responseXML.documentElement.nodeName == 'error'
830 && this.request.responseXML.getElementsByTagName("error")
833 if ( this.request.responseXML.getElementsByTagName("error")[0]
836 this.request.responseXML
837 .getElementsByTagName("error")[0]
838 .childNodes[0].nodeValue;
840 this.request.responseXML.getElementsByTagName("error")[0]
841 .getAttribute("msg");
843 this.request.responseXML.getElementsByTagName("error")[0]
844 .getAttribute("code");
846 var err = new Error(errMsg + errAddInfo);
849 if (this.errorHandler) {
850 this.errorHandler(err);
855 } else if ( this.request.status == 200 ) {
856 this.callback( this.request.responseXML );
858 var err = new Error("Pz2.js: HTTP request error (AJAX). Code: "
859 + this.request.status + " Info: "
860 + this.request.statusText );
863 if (this.errorHandler) {
864 this.errorHandler(err);
875 ********************************************************************************
876 ** XML HELPER FUNCTIONS ********************************************************
877 ********************************************************************************
882 if ( window.ActiveXObject) {
883 var DOMDoc = document;
885 var DOMDoc = Document.prototype;
888 DOMDoc.newXmlDoc = function ( root )
892 if (document.implementation && document.implementation.createDocument) {
893 doc = document.implementation.createDocument('', root, null);
894 } else if ( window.ActiveXObject ) {
895 doc = new ActiveXObject("MSXML2.DOMDocument");
896 doc.loadXML('<' + root + '/>');
898 throw new Error ('No XML support in this browser');
905 DOMDoc.parseXmlFromString = function ( xmlString )
909 if ( window.DOMParser ) {
910 var parser = new DOMParser();
911 doc = parser.parseFromString( xmlString, "text/xml");
912 } else if ( window.ActiveXObject ) {
913 doc = new ActiveXObject("MSXML2.DOMDocument");
914 doc.loadXML( xmlString );
916 throw new Error ("No XML parsing support in this browser.");
922 DOMDoc.transformToDoc = function (xmlDoc, xslDoc)
924 if ( window.XSLTProcessor ) {
925 var proc = new XSLTProcessor();
926 proc.importStylesheet( xslDoc );
927 return proc.transformToDocument(xmlDoc);
928 } else if ( window.ActiveXObject ) {
929 return document.parseXmlFromString(xmlDoc.transformNode(xslDoc));
931 alert( 'Unable to perform XSLT transformation in this browser' );
937 Element_removeFromDoc = function (DOM_Element)
939 DOM_Element.parentNode.removeChild(DOM_Element);
942 Element_emptyChildren = function (DOM_Element)
944 while( DOM_Element.firstChild ) {
945 DOM_Element.removeChild( DOM_Element.firstChild )
949 Element_appendTransformResult = function ( DOM_Element, xmlDoc, xslDoc )
951 if ( window.XSLTProcessor ) {
952 var proc = new XSLTProcessor();
953 proc.importStylesheet( xslDoc );
955 docFrag = proc.transformToFragment( xmlDoc, DOM_Element.ownerDocument );
956 DOM_Element.appendChild(docFrag);
957 } else if ( window.ActiveXObject ) {
958 DOM_Element.innerHTML = xmlDoc.transformNode( xslDoc );
960 alert( 'Unable to perform XSLT transformation in this browser' );
964 Element_appendTextNode = function (DOM_Element, tagName, textContent )
966 var node = DOM_Element.ownerDocument.createElement(tagName);
967 var text = DOM_Element.ownerDocument.createTextNode(textContent);
969 DOM_Element.appendChild(node);
970 node.appendChild(text);
975 Element_setTextContent = function ( DOM_Element, textContent )
977 if (typeof DOM_Element.textContent !== "undefined") {
978 DOM_Element.textContent = textContent;
979 } else if (typeof DOM_Element.innerText !== "undefined" ) {
980 DOM_Element.innerText = textContent;
982 throw new Error("Cannot set text content of the node, no such method.");
986 Element_getTextContent = function (DOM_Element)
988 if ( typeof DOM_Element.textContent != 'undefined' ) {
989 return DOM_Element.textContent;
990 } else if (typeof DOM_Element.text != 'undefined') {
991 return DOM_Element.text;
993 throw new Error("Cannot get text content of the node, no such method.");
997 /* do not remove trailing bracket */