f326f8aa9b53414be7b3eac1459ecad785b51225
[contrib/cloudeebus.git] / cloudeebus / cloudeebus.js
1 /******************************************************************************
2  * Copyright 2012 Intel Corporation.
3  * 
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  * 
8  * http://www.apache.org/licenses/LICENSE-2.0
9  * 
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  *****************************************************************************/
16
17
18
19 /*****************************************************************************/
20
21 var dbus = { // hook object for dbus types not translated by python-json
22                 Double: function(value, level) {
23                         return value;
24                 }
25 };
26
27
28
29 /*****************************************************************************/
30
31 var cloudeebus = window.cloudeebus = {
32                 version: "0.5.1",
33                 minVersion: "0.3.2"
34 };
35
36 cloudeebus.reset = function() {
37         cloudeebus.sessionBus = null;
38         cloudeebus.systemBus = null;
39         cloudeebus.wampSession = null;
40         cloudeebus.uri = null;
41 };
42
43
44 cloudeebus.log = function(msg) { 
45 };
46
47 cloudeebus.getError = function(error) {
48         if (error.desc && error.uri)
49                 return error.desc + " : " + error.uri;
50         if (error.desc)
51                 return error.desc;
52         if (error.uri)
53                 return error.uri;
54         if (error.name && error.message)
55                 return error.name + " : " + error.message;
56         if (error.message)
57                 return error.message;
58         return error;
59 };
60
61 cloudeebus.versionCheck = function(version) {
62         var ver = version.split(".");
63         var min = cloudeebus.minVersion.split(".");
64         for (var i=0; i<ver.length; i++) {
65                 if (Number(ver[i]) > Number(min[i]))
66                         return true;
67                 if (Number(ver[i]) < Number(min[i]))
68                         return false;
69         }
70         return true;
71 };
72
73
74 cloudeebus.connect = function(uri, manifest, successCB, errorCB) {
75         cloudeebus.reset();
76         cloudeebus.uri = uri;
77         
78         function onCloudeebusVersionCheckCB(version) {
79                 if (cloudeebus.versionCheck(version)) {
80                         cloudeebus.log("Connected to " + cloudeebus.uri);
81                         if (successCB)
82                                 successCB();
83                 } else {
84                         var errorMsg = "Cloudeebus server version " + version + " unsupported, need version " + cloudeebus.minVersion + " or superior";
85                         cloudeebus.log(errorMsg);
86                         if (errorCB)
87                                 errorCB(errorMsg);
88                 }
89         }
90         
91         function onWAMPSessionAuthErrorCB(error) {
92                 var errorStr = cloudeebus.getError(error);
93                 cloudeebus.log("Authentication error: " + errorStr);
94                 if (errorCB)
95                         errorCB(errorStr);
96         }
97         
98         function onWAMPSessionAuthenticatedCB(permissions) {
99                 cloudeebus.sessionBus = new cloudeebus.BusConnection("session", cloudeebus.wampSession);
100                 cloudeebus.systemBus = new cloudeebus.BusConnection("system", cloudeebus.wampSession);
101                 cloudeebus.wampSession.call("getVersion").then(onCloudeebusVersionCheckCB, errorCB);
102         }
103         
104         function onWAMPSessionChallengedCB(challenge) {
105                 var signature = cloudeebus.wampSession.authsign(challenge, manifest.key);
106                 cloudeebus.wampSession.auth(signature).then(onWAMPSessionAuthenticatedCB, onWAMPSessionAuthErrorCB);
107         }
108         
109         function onWAMPSessionConnectedCB(session) {
110                 cloudeebus.wampSession = session;
111                 if (manifest)
112                         cloudeebus.wampSession.authreq(
113                                         manifest.name, 
114                                         {permissions: manifest.permissions}
115                                 ).then(onWAMPSessionChallengedCB, onWAMPSessionAuthErrorCB);
116                 else
117                         cloudeebus.wampSession.authreq().then(function() {
118                                 cloudeebus.wampSession.auth().then(onWAMPSessionAuthenticatedCB, onWAMPSessionAuthErrorCB);
119                                 }, onWAMPSessionAuthErrorCB);
120         }
121
122         function onWAMPSessionErrorCB(code, reason) {
123                 if (code == ab.CONNECTION_UNSUPPORTED) {
124                         cloudeebus.log("Browser is not supported");
125                 }
126                 else {
127                         cloudeebus.log("Failed to open session, code = " + code + ", reason = " + reason);
128                 }
129                 if (errorCB)
130                         errorCB(reason);
131         }
132
133         return ab.connect(cloudeebus.uri, onWAMPSessionConnectedCB, onWAMPSessionErrorCB);
134 };
135
136
137 cloudeebus.SessionBus = function() {
138         return cloudeebus.sessionBus;
139 };
140
141
142 cloudeebus.SystemBus = function() {
143         return cloudeebus.systemBus;
144 };
145
146
147
148 /*****************************************************************************/
149
150 cloudeebus.BusConnection = function(name, session) {
151         this.name = name;
152         this.wampSession = session;
153         return this;
154 };
155
156
157 cloudeebus.BusConnection.prototype.getObject = function(busName, objectPath, introspectCB, errorCB) {
158         var proxy = new cloudeebus.ProxyObject(this.wampSession, this, busName, objectPath);
159         if (introspectCB)
160                 proxy._introspect(introspectCB, errorCB);
161         return proxy;
162 };
163
164
165 cloudeebus.BusConnection.prototype.addService = function(serviceName) {
166         var self = this;
167         
168         var promise = new cloudeebus.Promise(function (resolver) {
169           cloudeebusService = new cloudeebus.Service(self.wampSession, self, serviceName);
170         
171                 function ServiceAddedSuccessCB(serviceName) {
172                         try { // calling dbus hook object function for un-translated types
173                                 cloudeebusService.isCreated = true;
174                                 var result = [ cloudeebusService ];
175                                 resolver.fulfill(result[0], true);
176                         }
177                         catch (e) {
178                                 var errorStr = cloudeebus.getError(e);
179                                 cloudeebus.log("Method callback exception: " + errorStr);
180                                 resolver.reject(errorStr, true);
181                         }               
182                 }
183                 
184                 function ServiceAddedErrorCB(error) {
185                         var errorStr = cloudeebus.getError(error);
186                         cloudeebus.log("Error adding service method: " + self.name + ", error: " + errorStr);
187                         self.promise.resolver.reject(errorStr, true);
188                 }
189
190                 var arglist = [
191                     self.name,
192                     serviceName
193                     ];
194
195                 // call dbusSend with bus type, destination, object, message and arguments
196                 self.wampSession.call("serviceAdd", arglist).then(ServiceAddedSuccessCB, ServiceAddedErrorCB);
197         });
198         
199         return promise;
200 };
201
202
203 /*****************************************************************************/
204 //Generic definition for an agent. An agent need :
205 //srvDbusName : the DBus parent service
206 //objPath : a DBus path to access it
207 //jsHdl : a Javascript handler to process methods, 
208 //xml : the xml which describe interface/methods/signals...
209 cloudeebus.Agent = function(srvDbusName, objPath, jsHdl, xml) {
210         this.srvName = srvDbusName;
211         this.registered = false;
212         this.xml = xml;
213         this.objectPath = objPath;
214         this.jsHdl = jsHdl;
215         return this;
216 };
217
218
219 cloudeebus.Service = function(session, busConnection, name) {
220         this.wampSession = session;
221         this.busConnection = busConnection; 
222         this.name = name;
223         this.agents = [];
224         this.isCreated = false;
225         return this;
226 };
227
228 cloudeebus.Service.prototype.remove = function() {
229         var self = this;
230         
231         var promise = new cloudeebus.Promise(function (resolver) {
232                 function ServiceRemovedSuccessCB(serviceName) {
233                         try { // calling dbus hook object function for un-translated types
234                                 var result = [ serviceName ];
235                                 resolver.fulfill(result[0], true);
236                         }
237                         catch (e) {
238                                 var errorStr = cloudeebus.getError(e);
239                                 cloudeebus.log("Method callback exception: " + errorStr);
240                                 resolver.reject(errorStr, true);
241                         }               
242                 }
243                 
244                 function ServiceRemovedErrorCB(error) {
245                         var errorStr = cloudeebus.getError(error);
246                         cloudeebus.log("Error removing service : " + self.name + ", error: " + errorStr);
247                         self.promise.resolver.reject(errorStr, true);
248                 }
249                 
250                 for (var idx in self.agents) {
251                         if (self.agents[idx]) {
252                                 cloudeebus.log("Removing agent : " + JSON.stringify(self.agents[idx]));
253                                 self.delAgent(self.agents[idx]);
254                         }
255                 }
256                 
257                 var arglist = [
258                     self.name
259                     ];
260         
261                 // call dbusSend with bus type, destination, object, message and arguments
262                 self.wampSession.call("serviceRelease", arglist).then(ServiceRemovedSuccessCB, ServiceRemovedErrorCB);
263         });
264         
265         return promise;
266 };
267
268 cloudeebus.Service.prototype._searchMethod = function(ifName, method, objectJS) {
269
270         var funcToCall = null;
271         
272         // Check if 'objectJS' has a member 'interfaceProxies' with an interface named 'ifName' 
273         // and a method named 'method'
274         if (objectJS.interfaceProxies && objectJS.interfaceProxies[ifName] &&
275                 objectJS.interfaceProxies[ifName][method]) {
276                 funcToCall = objectJS.interfaceProxies[ifName][method];
277         } else {
278                 // retrieve the method directly from 'root' of objectJs
279                 funcToCall = objectJS[method];
280         }
281
282         return funcToCall;
283 };
284
285 cloudeebus.Service.prototype._addMethod = function(ifName, method, agent) {
286
287         var service = this;
288         var methodId = this.name + "#" + agent.objectPath + "#" + ifName + "#" + method;
289         var funcToCall = this._searchMethod(ifName, method, agent.jsHdl);
290
291         if (funcToCall == null)
292                 cloudeebus.log("Method " + method + " doesn't exist in Javascript object");
293         else {
294                 agent.jsHdl.wrapperFunc[method] = function() {
295                         var result;
296                         var methodId = arguments[0];
297                         var callDict = {};
298                         // affectation of callDict in eval, otherwise dictionary(='{}') interpreted as block of code by eval
299                         eval("callDict = " + arguments[1]);
300                         try {
301                                 result = funcToCall.apply(agent.jsHdl, callDict.args);
302                                 service._returnMethod(methodId, callDict.callIndex, true, result);
303                         }
304                         catch (e) {
305                                 var errorStr = cloudeebus.getError(e);
306                                 cloudeebus.log("Method " + ifName + "." + method + " call on " + agent.objectPath + " exception: " + errorStr);
307                                 service._returnMethod(methodId, callDict.callIndex, false, errorStr);
308                         }
309                 };
310                 agent.jsHdl.methodId[agent.objectPath].push(methodId);
311                 cloudeebus.log("subscribe " + methodId);
312                 this.wampSession.subscribe(methodId, agent.jsHdl.wrapperFunc[method]);
313         }
314 };
315
316 cloudeebus.Service.prototype._addSignal = function(ifName, signal, agent) {
317         var service = this;
318         var methodExist = false;
319
320         if (agent.jsHdl.interfaceProxies && agent.jsHdl.interfaceProxies[ifName])
321                 if (agent.jsHdl.interfaceProxies[ifName][signal]) {
322                         methodExist = true;
323                 } else {
324                         agent.jsHdl.interfaceProxies[ifName][signal] = function() {
325                                 service._emitSignal(agent.objectPath, signal, arguments[0]);
326                         };
327                 return;
328         }
329                 
330         if ((agent.jsHdl[signal] == undefined || agent.jsHdl[signal] == null) && !methodExist) 
331                 agent.jsHdl[signal] = function() {
332                         service._emitSignal(agent.objectPath, signal, arguments[0]);
333                 };
334         else
335                 cloudeebus.log("Can not create new method to emit signal '" + signal + "' in object JS this method already exist!");
336 };
337
338 cloudeebus.Service.prototype._createWrapper = function(agent) {
339         var self = this;
340         var parser = new DOMParser();
341         var xmlDoc = parser.parseFromString(agent.xml, "text/xml");
342         var ifXml = xmlDoc.getElementsByTagName("interface");
343         agent.jsHdl.wrapperFunc = [];
344         agent.jsHdl.methodId = [];
345         agent.jsHdl.methodId[agent.objectPath] = [];
346         for (var i=0; i < ifXml.length; i++) {
347                 var ifName = ifXml[i].attributes.getNamedItem("name").value;
348                 var ifChild = ifXml[i].firstChild;
349                 while (ifChild) {
350                         if (ifChild.nodeName == "method") {
351                                 var metName = ifChild.attributes.getNamedItem("name").value;
352                                 self._addMethod(ifName, metName, agent);
353                         }
354                         if (ifChild.nodeName == "signal") {
355                                 var metName = ifChild.attributes.getNamedItem("name").value;
356                                 self._addSignal(ifName, metName, agent);
357                         }
358                         ifChild = ifChild.nextSibling;
359                 }
360         }
361 };
362
363 cloudeebus.Service.prototype.addAgent = function(agent, successCB, errorCB) {
364         var self = this;
365         
366         function ServiceAddAgentSuccessCB(objPath) {
367                 self.agents.push(agent);
368                 agent.registered = true;
369                 cloudeebus.log("Agent pushed : " + JSON.stringify(agent))
370                 if (successCB) {
371                         try {
372                                 successCB(objPath);
373                         }
374                         catch (e) {
375                                 alert("Exception adding agent " + agent.objectPath + " : " + cloudeebus.getError(e));
376                         }
377                 }
378         }
379         
380         try {
381                 this._createWrapper(agent);
382         }
383         catch (e) {
384                 var errorStr = cloudeebus.getError(e);
385                 alert("Exception creating agent wrapper " + agent.objectPath + " : " + errorStr);
386                 errorCB(errorStr);
387                 return;
388         }
389         
390         var arglist = [
391             agent.objectPath,
392             agent.xml
393             ];
394
395         // call dbusSend with bus type, destination, object, message and arguments
396         this.wampSession.call("serviceAddAgent", arglist).then(ServiceAddAgentSuccessCB, errorCB);
397 };
398
399 cloudeebus.Service.prototype._deleteWrapper = function(agent) {
400         var objJs = agent.jsHdl;
401         if (objJs.methodId[agent.objectPath]) {
402                 for (var idx in objJs.methodId[agent.objectPath]) {
403                         try {
404                                 cloudeebus.log("unsubscribe " + objJs.methodId[agent.objectPath][idx]);
405                                 this.wampSession.unsubscribe(objJs.methodId[agent.objectPath][idx]);
406                                 objJs.methodId[agent.objectPath][idx] = null;
407                         }
408                         catch (e) {
409                                 cloudeebus.log("Unsubscribe error: " + cloudeebus.getError(e));
410                         }
411                 }
412                 delete objJs.methodId[agent.objectPath];
413         }
414 };
415
416 cloudeebus.Service.prototype.delAgent = function(rmAgent, successCB, errorCB) {
417         function ServiceDelAgentSuccessCB(agent) {
418                 if (successCB) {
419                         try {
420                                 successCB(agent);
421                         }
422                         catch (e) {
423                                 var errorStr = cloudeebus.getError(e);
424                                 alert("Exception deleting agent " + rmAgent.objectPath + " : " + errorStr);
425                                 errorCB(errorStr);
426                         }
427                 }
428         }
429
430         try {
431                 this._deleteWrapper(rmAgent);
432         }
433         catch (e) {
434                 var errorStr = cloudeebus.getError(e);
435                 alert("Exception deleting agent wrapper " + rmAgent.objectPath + " : " + errorStr);
436                 errorCB(errorStr);
437         }
438         
439         var arglist = [
440             rmAgent.objectPath
441             ];
442
443         // call dbusSend with bus type, destination, object, message and arguments
444         this.wampSession.call("serviceDelAgent", arglist).then(ServiceDelAgentSuccessCB, errorCB);
445 };
446
447 cloudeebus.Service.prototype._returnMethod = function(methodId, callIndex, success, result, successCB, errorCB) {
448         var arglist = [
449             methodId,
450             callIndex,
451             success,
452             result
453             ];
454
455         this.wampSession.call("returnMethod", arglist).then(successCB, errorCB);
456 };
457
458 cloudeebus.Service.prototype._emitSignal = function(objectPath, signalName, result, successCB, errorCB) {
459         var arglist = [
460             objectPath,
461             signalName,
462             result
463             ];
464
465         this.wampSession.call("emitSignal", arglist).then(successCB, errorCB);
466 };
467
468
469
470 /*****************************************************************************/
471
472 function _processWrappers(wrappers, value) {
473         for (var i=0; i<wrappers.length; i++)
474                 wrappers[i](value);
475 }
476
477
478 function _processWrappersAsync(wrappers, value) {
479         var taskid = -1;
480         function processAsyncOnce() {
481                 _processWrappers(wrappers, value);
482                 clearInterval(taskid);
483         }
484         taskid = setInterval(processAsyncOnce, 200);
485 }
486
487
488
489 /*****************************************************************************/
490
491 cloudeebus.PromiseResolver = function(promise) {
492         this.promise = promise;
493         this.resolved = null;
494     return this;
495 };
496
497
498 cloudeebus.PromiseResolver.prototype.resolve = function(value, sync) {
499         if (this.resolved)
500                 return;
501         
502         var then = (value && value.then && value.then.apply) ? value.then : null;
503         if (then) {
504                 var self = this;                
505                 var fulfillCallback = function(arg) {
506                         self.resolve(arg, true);
507                 };      
508                 var rejectCallback = function(arg) {
509                         self.reject(arg, true);
510                 };
511                 try {
512                         then.apply(value, [fulfillCallback, rejectCallback]);
513                 }
514                 catch (e) {
515                         this.reject(cloudeebus.getError(e), true);
516                 }
517         }
518         
519         this.fulfill(value, sync);
520 };
521
522
523 cloudeebus.PromiseResolver.prototype.fulfill = function(value, sync) {
524         if (this.resolved)
525                 return;
526         
527         var promise = this.promise;
528         promise.state = "fulfilled";
529         promise.result = value;
530         
531         this.resolved = true;
532         if (sync)
533                 _processWrappers(promise._fulfillWrappers, value);
534         else
535                 _processWrappersAsync(promise._fulfillWrappers, value);
536 };
537
538
539 cloudeebus.PromiseResolver.prototype.reject = function(value, sync) {
540         if (this.resolved)
541                 return;
542         
543         var promise = this.promise;
544         promise.state = "rejected";
545         promise.result = value;
546         
547         this.resolved = true;
548         if (sync)
549                 _processWrappers(promise._rejectWrappers, value);
550         else
551                 _processWrappersAsync(promise._rejectWrappers, value);
552 };
553
554
555
556 /*****************************************************************************/
557
558 cloudeebus.Promise = function(init) {
559         this.state = "pending";
560         this.result = null;
561         this._fulfillWrappers = [];
562         this._rejectWrappers = [];
563         this.resolver = new cloudeebus.PromiseResolver(this);
564         if (init) {
565                 try {
566                         init.apply(this, [this.resolver]);
567                 }
568                 catch (e) {
569                         this.resolver.reject(cloudeebus.getError(e), true);
570                 }
571         }
572     return this;
573 };
574
575
576 cloudeebus.Promise.prototype.appendWrappers = function(fulfillWrapper, rejectWrapper) {
577         if (fulfillWrapper)
578                 this._fulfillWrappers.push(fulfillWrapper);
579         if (rejectWrapper)
580                 this._rejectWrappers.push(rejectWrapper);
581         if (this.state == "fulfilled")
582                 _processWrappersAsync(this._fulfillWrappers, this.result);
583         if (this.state == "rejected")
584                 _processWrappersAsync(this._rejectWrappers, this.result);
585 };
586
587
588 cloudeebus.Promise.prototype.then = function(fulfillCB, rejectCB) {
589         var promise = new cloudeebus.Promise();
590         var resolver = promise.resolver;
591         var fulfillWrapper, rejectWrapper;
592         
593         if (fulfillCB)
594                 fulfillWrapper = function(arg) {
595                         try {
596                                 var value = fulfillCB.apply(promise, [arg]);
597                                 resolver.resolve(value, true);
598                         }
599                         catch (e) {
600                                 resolver.reject(cloudeebus.getError(e), true);
601                         }
602                 };
603         else
604                 fulfillWrapper = function(arg) {
605                         resolver.fulfill(arg, true);
606                 };
607         
608         if (rejectCB)
609                 rejectWrapper = function(arg) {
610                         try {
611                                 var value = rejectCB.apply(promise, [arg]);
612                                 resolver.resolve(value, true);
613                         }
614                         catch (e) {
615                                 resolver.reject(cloudeebus.getError(e), true);
616                         }
617                 };
618         else
619                 rejectWrapper = function(arg) {
620                         resolver.reject(arg, true);
621                 };
622         
623         this.appendWrappers(fulfillWrapper,rejectWrapper);
624         return promise;
625 };
626
627
628 cloudeebus.Promise.prototype["catch"] = function(rejectCB) {
629         return this.then(undefined,rejectCB);
630 };
631
632
633 cloudeebus.Promise.prototype.done = function(fulfillCB, rejectCB) {
634         this.appendWrappers(fulfillCB,rejectCB);
635 };
636
637
638 cloudeebus.Promise.resolve = function(value) {
639         var promise = new cloudeebus.Promise();
640         promise.resolver.resolve(value);
641         return promise;
642 };
643
644
645 cloudeebus.Promise.fulfill = function(value) {
646         var promise = new cloudeebus.Promise();
647         promise.resolver.fulfill(value);
648         return promise;
649 };
650
651
652 cloudeebus.Promise.reject = function(value) {
653         var promise = new cloudeebus.Promise();
654         promise.resolver.reject(value);
655         return promise;
656 };
657
658
659 cloudeebus.Promise.any = function() {
660         var promise = new cloudeebus.Promise();
661         var resolver = promise.resolver;
662         var fulfillCallback = function(arg) {
663                 resolver.resolve(arg, true);
664         };
665         var rejectCallback = function(arg) {
666                 resolver.reject(arg, true);
667         };
668         if (arguments.length == 0)
669                 resolver.resolve(undefined, true);
670         else
671                 for (i in arguments) 
672                         Promise.resolve(arguments[i]).appendWrappers(fulfillCallback,rejectCallback);
673         return promise;
674 };
675
676
677 cloudeebus.Promise.every = function() {
678         var promise = new cloudeebus.Promise();
679         var resolver = promise.resolver;
680         var index = 0;
681         var countdown = arguments.length;
682         var args = new Array(countdown);
683         var rejectCallback = function(arg) {
684                 resolver.reject(arg, true);
685         };
686         if (arguments.length == 0)
687                 resolver.resolve(undefined, true);
688         else
689                 for (i in arguments) {
690                         var fulfillCallback = function(arg) {
691                                 args[index] = arg;
692                                 countdown--;
693                                 if (countdown == 0)
694                                         resolver.resolve(args, true);
695                         };
696                         index++;
697                         Promise.resolve(arguments[i]).appendWrappers(fulfillCallback,rejectCallback);
698                 }
699         
700         return promise;
701 };
702
703
704 cloudeebus.Promise.some = function() {
705         var promise = new cloudeebus.Promise();
706         var resolver = promise.resolver;
707         var index = 0;
708         var countdown = arguments.length;
709         var args = new Array(countdown);
710         var fulfillCallback = function(arg) {
711                 resolver.resolve(arg, true);
712         };
713         if (arguments.length == 0)
714                 resolver.resolve(undefined, true);
715         else
716                 for (i in arguments) {
717                         var rejectCallback = function(arg) {
718                                 args[index] = arg;
719                                 countdown--;
720                                 if (countdown == 0)
721                                         resolver.reject(args, true);
722                         };
723                         index++;
724                         Promise.resolve(arguments[i]).appendWrappers(fulfillCallback,rejectCallback);
725                 }
726         
727         return promise;
728 };
729
730
731
732 /*****************************************************************************/
733
734 cloudeebus.ProxyObject = function(session, busConnection, busName, objectPath) {
735         this.wampSession = session; 
736         this.busConnection = busConnection; 
737         this.busName = busName; 
738         this.objectPath = objectPath; 
739         this.interfaceProxies = {};
740         return this;
741 };
742
743
744 cloudeebus.ProxyObject.prototype.getInterface = function(ifName) {
745         return this.interfaceProxies[ifName];
746 };
747
748
749 cloudeebus.ProxyObject.prototype._introspect = function(successCB, errorCB) {
750         
751         var self = this; 
752
753         function getAllPropertiesSuccessCB(props) {
754                 var ifProxy = self.interfaceProxies[self.propInterfaces[self.propInterfaces.length-1]];
755                 for (var prop in props)
756                         ifProxy[prop] = self[prop] = props[prop];
757                 getAllPropertiesNextInterfaceCB();
758         }
759         
760         function getAllPropertiesNextInterfaceCB() {
761                 self.propInterfaces.pop();
762                 if (self.propInterfaces.length > 0) 
763                         self.callMethod("org.freedesktop.DBus.Properties", 
764                                 "GetAll", 
765                                 [self.propInterfaces[self.propInterfaces.length-1]]).then(getAllPropertiesSuccessCB, 
766                                 errorCB ? errorCB : getAllPropertiesNextInterfaceCB);
767                 else {
768                         self.propInterfaces = null;
769                         if (successCB)
770                                 successCB(self);
771                 }
772         }
773         
774         function introspectSuccessCB(str) {
775                 var parser = new DOMParser();
776                 var xmlDoc = parser.parseFromString(str, "text/xml");
777                 var interfaces = xmlDoc.getElementsByTagName("interface");
778                 self.propInterfaces = [];
779                 var supportDBusProperties = false;
780                 for (var i=0; i < interfaces.length; i++) {
781                         var ifName = interfaces[i].attributes.getNamedItem("name").value;
782                         self.interfaceProxies[ifName] = new cloudeebus.ProxyObject(self.wampSession, self.busConnection, self.busName, self.objectPath);
783                         if (ifName == "org.freedesktop.DBus.Properties")
784                                 supportDBusProperties = true;
785                         var hasProperties = false;
786                         var ifChild = interfaces[i].firstChild;
787                         while (ifChild) {
788                                 if (ifChild.nodeName == "method") {
789                                         var nArgs = 0;
790                                         var signature = "";
791                                         var metChild = ifChild.firstChild;
792                                         while (metChild) {
793                                                 if (metChild.nodeName == "arg" &&
794                                                         metChild.attributes.getNamedItem("direction").value == "in") {
795                                                                 signature += metChild.attributes.getNamedItem("type").value;
796                                                                 nArgs++;
797                                                 }
798                                                 metChild = metChild.nextSibling;
799                                         }
800                                         var metName = ifChild.attributes.getNamedItem("name").value;
801                                         if (!self[metName])
802                                                 self._addMethod(ifName, metName, nArgs, signature);
803                                         self.interfaceProxies[ifName]._addMethod(ifName, metName, nArgs, signature);
804                                 }
805                                 else if (ifChild.nodeName == "property") {
806                                         if (!hasProperties)
807                                                 self.propInterfaces.push(ifName);
808                                         hasProperties = true;
809                                 }
810                                 ifChild = ifChild.nextSibling;
811                         }
812                 }
813                 if (supportDBusProperties && self.propInterfaces.length > 0) {
814                         self.callMethod("org.freedesktop.DBus.Properties", 
815                                 "GetAll", 
816                                 [self.propInterfaces[self.propInterfaces.length-1]]).then(getAllPropertiesSuccessCB, 
817                                 errorCB ? errorCB : getAllPropertiesNextInterfaceCB);
818                 }
819                 else {
820                         self.propInterfaces = null;
821                         if (successCB)
822                                 successCB(self);
823                 }
824         }
825
826         // call Introspect on self
827         self.callMethod("org.freedesktop.DBus.Introspectable", "Introspect", []).then(introspectSuccessCB, errorCB);
828 };
829
830
831 cloudeebus.ProxyObject.prototype._addMethod = function(ifName, method, nArgs, signature) {
832
833         var self = this;
834         
835         self[method] = function() {
836                 var args = [];
837                 for (var i=0; i < nArgs; i++ )
838                         args.push(arguments[i]);
839                 return self.callMethod(ifName, method, args, signature);
840         };      
841 };
842
843
844 cloudeebus.ProxyObject.prototype.callMethod = function(ifName, method, args, signature) {
845         
846         var self = this;
847         
848         var promise = new cloudeebus.Promise(function (resolver) {
849                 function callMethodSuccessCB(str) {
850                         try { // calling dbus hook object function for un-translated types
851                                 var result = eval(str);
852                                 resolver.fulfill(result[0], true);
853                         }
854                         catch (e) {
855                                 var errorStr = cloudeebus.getError(e);
856                                 cloudeebus.log("Method callback exception: " + errorStr);
857                                 resolver.reject(errorStr, true);
858                         }
859                 }
860
861                 function callMethodErrorCB(error) {
862                         var errorStr = cloudeebus.getError(error);
863                         cloudeebus.log("Error calling method: " + method + " on object: " + self.objectPath + " : " + errorStr);
864                         resolver.reject(errorStr, true);
865                 }
866
867                 var arglist = [
868                         self.busConnection.name,
869                         self.busName,
870                         self.objectPath,
871                         ifName,
872                         method,
873                         JSON.stringify(args)
874                 ];
875
876                 // call dbusSend with bus type, destination, object, message and arguments
877                 self.wampSession.call("dbusSend", arglist).then(callMethodSuccessCB, callMethodErrorCB);
878         });
879         
880         return promise;
881 };
882
883
884 cloudeebus.ProxyObject.prototype.connectToSignal = function(ifName, signal, handlerCB, errorCB) {
885         
886         var self = this; 
887
888         function signalHandler(id, data) {
889                 if (handlerCB) {
890                         try { // calling dbus hook object function for un-translated types
891                                 handlerCB.apply(self, eval(data));
892                         }
893                         catch (e) {
894                                 var errorStr = cloudeebus.getError(e);
895                                 cloudeebus.log("Signal handler exception: " + errorStr);
896                                 if (errorCB)
897                                         errorCB(errorStr);
898                         }
899                 }
900         }
901         
902         function connectToSignalSuccessCB(str) {
903                 try {
904                         self.wampSession.subscribe(str, signalHandler);
905                 }
906                 catch (e) {
907                         cloudeebus.log("Subscribe error: " + cloudeebus.getError(e));
908                 }
909         }
910
911         function connectToSignalErrorCB(error) {
912                 var errorStr = cloudeebus.getError(error);
913                 cloudeebus.log("Error connecting to signal: " + signal + " on object: " + self.objectPath + " : " + errorStr);
914                 if (errorCB)
915                         errorCB(cloudeebus.getError(errorStr));
916         }
917
918         var arglist = [
919                 self.busConnection.name,
920                 self.busName,
921                 self.objectPath,
922                 ifName,
923                 signal
924         ];
925
926         // call dbusSend with bus type, destination, object, message and arguments
927         self.wampSession.call("dbusRegister", arglist).then(connectToSignalSuccessCB, connectToSignalErrorCB);
928 };
929
930
931 cloudeebus.ProxyObject.prototype.disconnectSignal = function(ifName, signal) {
932         try {
933                 this.wampSession.unsubscribe(this.busConnection.name + "#" + this.busName + "#" + this.objectPath + "#" + ifName + "#" + signal);
934         }
935         catch (e) {
936                 cloudeebus.log("Unsubscribe error: " + cloudeebus.getError(e));
937         }
938 };