//
// 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
// callback pool needs global scope
var jsrsContextPoolSize=0;
var jsrsContextMaxPool=20;
var jsrsContextPool=new Array();
var jsrsBrowser=jsrsBrowserSniff();
var jsrsPOST=false;
var LENS_HOTUPDATE_LOCK=0
// constructor for context object
function jsrsContextObj( contextID )
{
// properties
this.id=contextID;
this.busy=true;
this.callback=null;
this.callTime = 999999999999; // a time way in the future
this.container=contextCreateContainer( contextID );
// methods
this.GET=contextGET;
this.POST=contextPOST;
this.getPayload=contextGetPayload;
this.setVisibility=contextSetVisibility;
}
// 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='';
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;
}
return container;
}
function contextPOST( rsPage, func, parms )
{
var d=new Date();
var unique=d.getTime() + '' + Math.floor(1000 * Math.random());
var doc=this.container.document;
doc.open();
doc.write('');
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;
default:
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");
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;
default:
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
var jsrsAlert=0;
// does not recycle contexts
function jsrsGetContextID_old()
{
var i,contextObj;
for (var i=1; i <= jsrsContextPoolSize; i++){
contextObj=jsrsContextPool[ 'jsrs' + i ];
if ( !contextObj.busy ){
contextObj.busy=true;
return contextObj.id;
}
}
// 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 {
if (jsrsAlert == 0) {jsrsAlert=1;alert( "jsrs Error: context pool full" );}
return null;
}
}
// recycle contexts
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 )
{
// 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
// get context
var id = jsrsGetContextID(); if (!id) return;
var contextObj=jsrsContextPool[id];
contextObj.callback=callback;
var vis=(visibility == null)? false : visibility;
contextObj.setVisibility( vis );
/* POST does not work for MOZ - jlim 20/1/2002 */
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;
}
function jsrsError( contextID, str )
{
alert( unescape(str) );
jsrsContextPool[ contextID ].busy=false
}
function jsrsEscapeQQ( thing )
{
return thing.replace(/'"'/g, '\\"');
}
function jsrsUnescape( str )
{
// payload has slashes escaped with whacks
return str.replace( /\\\//g, "/" );
}
function jsrsBrowserSniff()
{
if (document.layers) return "NS";
if (document.all) {
if (navigator.userAgent.indexOf("Opera") > -1) return 'OPR';
if (navigator.userAgent.indexOf("Konqueror") > -1) return "MOZ";
return "IE";
}
if (document.getElementById) return "MOZ";
return "OTHER";
}
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( '