Examples

This section gathers sample scripts using ZOO-API, the ZOO-Project server-side JavaScript API.

ZOO-API contains many classes and functions. You can find the description list here.

ZOO.Process example

function SampleService(conf,inputs,outputs){
   var myProcess = new ZOO.Process('http://localhost/cgi-bin-new1/zoo_loader_new1.cgi','Boundary');
   var myInputs = {InputPolygon: { type: 'complex', value: '{"type":"Polygon","coordinates":[[[-106.993853,35.998758],[-107.407233,35.997524],[-107.430525,35.997726],[-107.4824,35.99878],[-108.37013,35.999472],[-109.043633,35.996652],[-109.096265,35.997817],[-109.148763,36.001751],[-109.200981,36.008442],[-109.252775,36.017871],[-109.304,36.030014],[-109.354516,36.044835],[-106.468201,35.991497],[-106.855511,35.989504],[-106.90933,35.990676],[-106.963008,35.994743],[-106.993853,35.998758]]]}', mimeType: "application/json"} };
   var myExecuteResult=myProcess.Execute(myInputs);
   return {result: ZOO.SERVICE_SUCCEEDED, outputs: [ {name:"Result", value: myExecuteResult} ] };
}

In this really short example you can see how to create ZOO.Process class instance and call the Execute method on such an instance. Then you’ll just need to return a JavaScript object containing the attributes result and outputs, which I’m sure you already know what is about. The first is about the status of the process (can be ZOO.SERVICE_SUCEEDED, ZOO.SERVICE_FAILED and so on), the last is obviously the resulting maps (take a look at the maps internal data structure used by ZOO Kernel in service.h).

ZOO.UpdateStatus example

function SampleLongService(conf,inputs,outputs){
   var my_i=0;
   while(my_i<100){
       try{
         conf["lenv"]["status"]=my_i;
       }
       catch(e){
       }
       ZOOUpdateStatus(conf,my_i);
       SampleService(conf,inputs,outputs);
       my_i+=10;
   }
   return SampleService(conf,inputs,outputs);
}

You can see in this sample code how to use the ZOOUpdateStatus function to update the current status of your running process. This information will be really helpfull when the ZOO Kernel will run your JavaScript Service in background mode (if the user set to true the storeExecuteResponse parameter in his request).

Asynchronous ZOO.Process example

function RunAsynchonous(conf,inputs,outputs){
   var formatWPS=new ZOO.Format.WPS();
   var myProcess = new ZOO.Process(conf["main"]["serverAddress"],'Demo',true);
   var myExecuteResult  =myProcess.Execute(myInputs,myOutputs);
   var response=formatWPS.read(myExecuteResult);
   while(response.status){
       sleep(1500);
       var response1 = ZOO.Request.Get(response.status.replace(/amp;/g,""),null);
       response=formatWPS.read(response1);
   }
   conf["lenv"]["message"]="Asyncrhonous Process ended";
   ZOO.UpdateStatus(conf,90);
   return {result: ZOO.SERVICE_SUCCEEDED, outputs: outputs};
 }

In this sample code, by creating the ZOO.Process, providing a third argument set to true, we ensure that the WPS service execution will be run asynchronously. Once the Execute WPS response is fetched, until the service execution ends, the statusLocation is polled every 1,5 second.