// // jsrsClient.js - javascript remote scripting client include // // Author: Brent Ashley [jsrs@megahuge.com] // // make asynchronous remote calls to server without client page refresh // // see license.txt for copyright and license information /* see history.txt for full history 2.0 26 Jul 2001 - added POST capability for IE/MOZ 2.2 10 Aug 2003 - added Opera support 2.3(beta) 10 Oct 2003 - added Konqueror support - **needs more testing** */ // callback pool needs global scope var jsrsContextPoolSize = 0; var jsrsContextMaxPool = 20; var jsrsContextPool = new Array(); var jsrsBrowser = jsrsBrowserSniff(); var jsrsPOST = true; var containerName; // constructor for context object function jsrsContextObj( contextID ){ // properties this.id = contextID; this.busy = true; this.callback = null; this.container = contextCreateContainer( contextID ); // methods this.GET = contextGET; this.POST = contextPOST; this.getPayload = contextGetPayload; this.setVisibility = contextSetVisibility; this.errFunc = null; } // method functions are not privately scoped // because Netscape's debugger chokes on private functions function contextCreateContainer( containerName ){ // creates hidden container to receive server data var container; switch( jsrsBrowser ) { case 'NS': container = new Layer(100); container.name = containerName; container.visibility = 'hidden'; container.clip.width = 100; container.clip.height = 100; break; case 'IE': document.body.insertAdjacentHTML( "afterBegin", '' ); var span = document.all( "SPAN" + containerName ); //var html = ''; //fix for IE message ("mix of secure/non secure"), see http://www.ashleyit.com/forums/read.php?6,91,92#msg-92 : var prefix = window.location.protocol + '//'; var host = window.location.host; var html = ''; span.innerHTML = html; span.style.display = 'none'; container = window.frames[ containerName ]; break; case 'MOZ': var span = document.createElement('SPAN'); span.id = "SPAN" + containerName; document.body.appendChild( span ); var iframe = document.createElement('IFRAME'); iframe.name = containerName; iframe.id = containerName; span.appendChild( iframe ); container = iframe; break; case 'OPR': var span = document.createElement('SPAN'); span.id = "SPAN" + containerName; document.body.appendChild( span ); var iframe = document.createElement('IFRAME'); iframe.name = containerName; iframe.id = containerName; span.appendChild( iframe ); container = iframe; break; case 'KONQ': var span = document.createElement('SPAN'); span.id = "SPAN" + containerName; document.body.appendChild( span ); var iframe = document.createElement('IFRAME'); iframe.name = containerName; iframe.id = containerName; span.appendChild( iframe ); container = iframe; // Needs to be hidden for Konqueror, otherwise it'll appear on the page span.style.display = none; iframe.style.display = none; iframe.style.visibility = hidden; iframe.height = 0; iframe.width = 0; break; } return container; } function contextPOST( rsPage, func, parms ){ var d = new Date(); var unique = d.getTime() + '' + Math.floor(1000 * Math.random()); var doc = (jsrsBrowser == "IE") ? this.container.document : this.container.contentDocument; if (!doc) { doc = window.frames[this.container.id].document; }//try one last thing... esp for: safari, 2006-05 - on a "reload", doc is undefined doc.open(); doc.write(''); doc.write('
'); doc.write(''); // func and parms are optional if (func != null){ doc.write(''); if (parms != null){ if (typeof(parms) == "string"){ // single parameter doc.write( ''); } else { // assume parms is array of strings for( var i=0; i < parms.length; i++ ){ doc.write( ''); } } // parm type } // parms } // func doc.write('
'); doc.close(); doc.forms['jsrsForm'].submit(); } function contextGET( rsPage, func, parms ){ // build URL to call var URL = rsPage; // always send context URL += "?C=" + this.id; // func and parms are optional if (func != null){ URL += "&F=" + escape(func); if (parms != null){ if (typeof(parms) == "string"){ // single parameter URL += "&P0=[" + escape(parms+'') + "]"; } else { // assume parms is array of strings for( var i=0; i < parms.length; i++ ){ URL += "&P" + i + "=[" + escape(parms[i]+'') + "]"; } } // parm type } // parms } // func // unique string to defeat cache var d = new Date(); URL += "&U=" + d.getTime(); // make the call switch( jsrsBrowser ) { case 'NS': this.container.src = URL; break; case 'IE': this.container.document.location.replace(URL); break; case 'MOZ': this.container.src = ''; this.container.src = URL; break; case 'OPR': this.container.src = ''; this.container.src = URL; break; case 'KONQ': this.container.src = ''; this.container.src = URL; break; } } function contextGetPayload(){ switch( jsrsBrowser ) { case 'NS': return this.container.document.forms['jsrs_Form'].elements['jsrs_Payload'].value; case 'IE': return this.container.document.forms['jsrs_Form']['jsrs_Payload'].value; case 'MOZ': return window.frames[this.container.name].document.forms['jsrs_Form']['jsrs_Payload'].value; case 'OPR': var textElement = window.frames[this.container.name].document.getElementById("jsrs_Payload"); case 'KONQ': var textElement = window.frames[this.container.name].document.getElementById("jsrs_Payload"); return textElement.value; } } function contextSetVisibility( vis ){ switch( jsrsBrowser ) { case 'NS': this.container.visibility = (vis)? 'show' : 'hidden'; break; case 'IE': document.all("SPAN" + this.id ).style.display = (vis)? '' : 'none'; break; case 'MOZ': document.getElementById("SPAN" + this.id).style.visibility = (vis)? '' : 'hidden'; case 'OPR': document.getElementById("SPAN" + this.id).style.visibility = (vis)? '' : 'hidden'; this.container.width = (vis)? 250 : 0; this.container.height = (vis)? 100 : 0; break; } } // end of context constructor //recycling, see: http://www.blogchat.com/blogchat/include/jsrsClient.js - slows script down though.... function jsrsGetContextID(){ var contextObj; //var d = new Date(); //var oldestTime = d.getTime(); //var oldestContext = 1; for (var i = 1; i <= jsrsContextPoolSize; i++){ contextObj = jsrsContextPool[ 'jsrs' + i ]; if ( !contextObj.busy ){ contextObj.busy = true; return contextObj.id; //} else { // if( contextObj.callTime < oldestTime ){ // oldestContext = i; // oldestTime = contextObj.callTime; // } } } // if we got here, there are no existing free contexts if ( jsrsContextPoolSize <= jsrsContextMaxPool ){ // create new context var contextID = "jsrs" + (jsrsContextPoolSize + 1); jsrsContextPool[ contextID ] = new jsrsContextObj( contextID ); jsrsContextPoolSize++; return contextID; } else { // start recycling contexts window.status = 'jsrs warning: context pool full (' + oldestContext + ')';// - recycling'; //return 'jsrs' + oldestContext; } } function jsrsExecute( rspage, callback, func, parms, visibility, errFunc ) { // call a server routine from client code // // rspage - href to asp file // callback - function to call on return // or null if no return needed // (passes returned string to callback) // func - sub or function name to call // parm - string parameter to function // or array of string parameters if more than one // visibility - optional boolean to make container visible for debugging // errFunc - optional error handling function. if passed, an alert isn't displayed // get context var contextObj = jsrsContextPool[ jsrsGetContextID() ]; contextObj.callback = callback; // New alternate error handler - TS 8/22/2006 if (errFunc != null) { contextObj.errFunc = errFunc; } else { contextObj.errFunc = null; } var vis = (visibility == null)? false : visibility; contextObj.setVisibility( vis ); if ( jsrsPOST && ((jsrsBrowser == 'IE') || (jsrsBrowser == 'MOZ'))){ contextObj.POST( rspage, func, parms ); } else { contextObj.GET( rspage, func, parms ); } return contextObj.id; } function jsrsLoaded( contextID ){ // get context object and invoke callback var contextObj = jsrsContextPool[ contextID ]; if( contextObj.callback != null){ contextObj.callback( jsrsUnescape( contextObj.getPayload() ), contextID ); } // clean up and return context to pool contextObj.callback = null; contextObj.busy = false; //fixes progress bar continual loading in IE - see http://www.ashleyit.com/forums/read.php?6,185,185#msg-185, http://www.ashleyit.com/forums/read.php?6,91,508#msg-508 //if ( (contextObj.debug != true) && (jsrsBrowser == 'IE') ) { contextObj.container.location = 'about:blank'; }//breaks back button if ( (contextObj.debug != true) && (jsrsBrowser == 'IE')) { var prefix = window.location.protocol + '//'; var host = window.location.host; contextObj.container.location = prefix + host + '/library/script/jsrsBlank.html'; } } function jsrsError( contextID, str ) { var contextObj = jsrsContextPool[contextID]; contextObj.busy = false; //str = str.replace("'",""); if (contextObj.errFunc != null) { contextObj.errFunc(unescape(str)); } else { alert( unescape(str) ); } //fixes progress bar continual loading in IE - see http://www.ashleyit.com/forums/read.php?6,185,185#msg-185, http://www.ashleyit.com/forums/read.php?6,91,508#msg-508 //if ( (contextObj.debug != true) && (jsrsBrowser == 'IE') ) { contextObj.container.location = 'about:blank'; }//breaks back button if ( (contextObj.debug != true) && (jsrsBrowser == 'IE')) { var prefix = window.location.protocol + '//'; var host = window.location.host; contextObj.container.location = prefix + host + '/library/script/jsrsBlank.html'; } } function jsrsEscapeQQ( thing ) { return thing.replace(/'"'/g, '\\"'); } function jsrsEscapeQQCust( thing ) { //var strOut = thing.replace(/{|}/g, '---'); return thing.replace(/"/g, '%22'); } function jsrsUnescape( str ) { // payload has slashes escaped with whacks return str.replace( /\\\//g, "/" ); } function jsrsBrowserSniff(){ if (document.layers) return "NS"; if (document.all) { // But is it really IE? // convert all characters to lowercase to simplify testing var agt=navigator.userAgent.toLowerCase(); var is_opera = (agt.indexOf("opera") != -1); var is_konq = (agt.indexOf("konqueror") != -1); if(is_opera) { return "OPR"; } else { if(is_konq) { return "KONQ"; } else { // Really is IE return "IE"; } } } if (document.getElementById) return "MOZ"; return "OTHER"; } ///////////////////////////////////////////////// // // user functions function jsrsArrayFromString( s, delim ){ // rebuild an array returned from server as string // optional delimiter defaults to ~ var d = (delim == null)? '~' : delim; return s.split(d); } function jsrsDebugInfo(){ // use for debugging by attaching to f1 (works with IE) // with onHelp = "return jsrsDebugInfo();" in the body tag var doc = window.open().document; doc.open; doc.write( 'Pool Size: ' + jsrsContextPoolSize + '
' ); for( var i in jsrsContextPool ){ var contextObj = jsrsContextPool[i]; doc.write( '
' + contextObj.id + ' : ' + (contextObj.busy ? 'busy' : 'available') + '
'); doc.write( contextObj.container.document.location.pathname + '
'); doc.write( contextObj.container.document.location.search + '
'); doc.write( '
' + contextObj.container.document.body.innerHTML + '
' ); } doc.write(''); doc.close(); return false; }