1 /******************************************************************************
2 * Copyright 2012 Intel Corporation.
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
8 * http://www.apache.org/licenses/LICENSE-2.0
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 *****************************************************************************/
19 /*****************************************************************************/
21 var dbus = { // hook object for dbus types not translated by python-json
22 Double: function(value, level) {
29 /*****************************************************************************/
31 var cloudeebus = window.cloudeebus = {
36 cloudeebus.reset = function() {
37 cloudeebus.sessionBus = null;
38 cloudeebus.systemBus = null;
39 cloudeebus.wampSession = null;
40 cloudeebus.uri = null;
44 cloudeebus.log = function(msg) {
47 cloudeebus.getError = function(error) {
48 if (error.desc && error.uri)
49 return error.desc + " : " + error.uri; // error cloudeebus (from python)
54 if (error.name && error.message)
55 return error.name + " : " + error.message;
60 return error; // error from Autobahn
63 cloudeebus.versionCheck = function(version) {
64 var ver = version.split(".");
65 var min = cloudeebus.minVersion.split(".");
66 for (var i=0; i<ver.length; i++) {
67 if (Number(ver[i]) > Number(min[i]))
69 if (Number(ver[i]) < Number(min[i]))
76 cloudeebus.connect = function(uri, manifest, successCB, errorCB) {
80 function onCloudeebusVersionCheckCB(version) {
81 if (cloudeebus.versionCheck(version)) {
82 cloudeebus.log("Connected to " + cloudeebus.uri);
86 var errorMsg = "Cloudeebus server version " + version + " unsupported, need version " + cloudeebus.minVersion + " or superior";
87 cloudeebus.log(errorMsg);
93 function onWAMPSessionAuthErrorCB(error) {
94 var errorStr = cloudeebus.getError(error);
95 cloudeebus.log("Authentication error: " + errorStr);
100 function onWAMPSessionAuthenticatedCB(permissions) {
101 cloudeebus.sessionBus = new cloudeebus.BusConnection("session", cloudeebus.wampSession);
102 cloudeebus.systemBus = new cloudeebus.BusConnection("system", cloudeebus.wampSession);
103 cloudeebus.wampSession.call("getVersion").then(onCloudeebusVersionCheckCB, errorCB);
106 function onWAMPSessionChallengedCB(challenge) {
107 var signature = cloudeebus.wampSession.authsign(challenge, manifest.key);
108 cloudeebus.wampSession.auth(signature).then(onWAMPSessionAuthenticatedCB, onWAMPSessionAuthErrorCB);
111 function onWAMPSessionConnectedCB(session) {
112 cloudeebus.wampSession = session;
114 cloudeebus.wampSession.authreq(
116 {permissions: manifest.permissions,
117 services: manifest.services}
118 ).then(onWAMPSessionChallengedCB, onWAMPSessionAuthErrorCB);
121 cloudeebus.wampSession.authreq().then(function() {
122 cloudeebus.wampSession.auth().then(onWAMPSessionAuthenticatedCB, onWAMPSessionAuthErrorCB);
123 }, onWAMPSessionAuthErrorCB);
126 function onWAMPSessionErrorCB(code, reason) {
127 if (code == ab.CONNECTION_UNSUPPORTED) {
128 cloudeebus.log("Browser is not supported");
131 cloudeebus.log("Failed to open session, code = " + code + ", reason = " + reason);
137 return ab.connect(cloudeebus.uri, onWAMPSessionConnectedCB, onWAMPSessionErrorCB);
141 cloudeebus.SessionBus = function() {
142 return cloudeebus.sessionBus;
146 cloudeebus.SystemBus = function() {
147 return cloudeebus.systemBus;
152 /*****************************************************************************/
154 cloudeebus.BusConnection = function(name, session) {
156 this.wampSession = session;
161 cloudeebus.BusConnection.prototype.getObject = function(busName, objectPath, introspectCB, errorCB) {
162 var proxy = new cloudeebus.ProxyObject(this.wampSession, this, busName, objectPath);
164 proxy._introspect(introspectCB, errorCB);
169 cloudeebus.BusConnection.prototype.addService = function(serviceName) {
175 var promise = new cloudeebus.Promise(function (resolver) {
176 var cloudeebusService = new cloudeebus.Service(self.wampSession, self, serviceName);
178 function ServiceAddedSuccessCB(serviceName) {
179 try { // calling dbus hook object function for un-translated types
180 cloudeebusService.isCreated = true;
181 resolver.fulfill(cloudeebusService, true);
184 var errorStr = cloudeebus.getError(e);
185 cloudeebus.log("Method callback exception: " + errorStr);
186 resolver.reject(errorStr, true);
190 function ServiceAddedErrorCB(error) {
191 var errorStr = cloudeebus.getError(error);
192 cloudeebus.log("Error adding service method: " + self.name + ", error: " + errorStr);
193 resolver.reject(errorStr, true);
201 // call dbusSend with bus type, destination, object, message and arguments
202 self.wampSession.call("serviceAdd", arglist).then(ServiceAddedSuccessCB, ServiceAddedErrorCB);
210 /*****************************************************************************/
211 //Generic definition for an agent. An agent needs :
212 //srvDbusName : the DBus parent service
213 //objPath : a DBus path to access it
214 //jsHdl : a Javascript handler to process methods,
215 //xml : the xml which describe interface/methods/signals...
216 cloudeebus.Agent = function(srvDbusName, objPath, jsHdl, xml) {
217 this.srvName = srvDbusName;
218 this.registered = false;
220 this.objectPath = objPath;
226 cloudeebus.Service = function(session, busConnection, name) {
227 this.wampSession = session;
228 this.busConnection = busConnection;
231 this.isCreated = false;
236 cloudeebus.Service.prototype.remove = function() {
239 var promise = new cloudeebus.Promise(function (resolver) {
240 function ServiceRemovedSuccessCB(serviceName) {
242 resolver.fulfill(serviceName, true);
245 var errorStr = cloudeebus.getError(e);
246 cloudeebus.log("Method callback exception: " + errorStr);
247 resolver.reject(errorStr, true);
251 function ServiceRemovedErrorCB(error) {
252 var errorStr = cloudeebus.getError(error);
253 cloudeebus.log("Error removing service : " + self.name + ", error: " + errorStr);
254 self.promise.resolver.reject(errorStr, true);
257 for (var idx in self.agents) {
258 if (self.agents[idx]) {
259 self.removeAgent(self.agents[idx]);
267 // call dbusSend with bus type, destination, object, message and arguments
268 self.wampSession.call("serviceRelease", arglist).then(ServiceRemovedSuccessCB, ServiceRemovedErrorCB);
275 cloudeebus.Service.prototype._searchMethod = function(ifName, method, objectJS) {
277 var funcToCall = null;
279 // Check if 'objectJS' has a member 'interfaceProxies' with an interface named 'ifName'
280 // and a method named 'method'
281 if (objectJS.interfaceProxies && objectJS.interfaceProxies[ifName] &&
282 objectJS.interfaceProxies[ifName][method]) {
283 funcToCall = objectJS.interfaceProxies[ifName][method];
285 // retrieve the method directly from 'root' of objectJs
286 funcToCall = objectJS[method];
293 cloudeebus.Service.prototype._addMethod = function(ifName, method, agent) {
296 var methodId = this.name + "#" + agent.objectPath + "#" + ifName + "#" + method;
297 var funcToCall = this._searchMethod(ifName, method, agent.jsHdl);
299 if (funcToCall == null)
300 cloudeebus.log("Method " + method + " doesn't exist in Javascript object");
302 agent.jsHdl.wrapperFunc[method] = function() {
304 var methodId = arguments[0];
306 // affectation of callDict in eval, otherwise dictionary(='{}') interpreted as block of code by eval
307 eval("callDict = " + arguments[1]);
309 result = funcToCall.apply(agent.jsHdl, callDict.args);
310 service._returnMethod(methodId, callDict.callIndex, true, result);
313 var errorStr = cloudeebus.getError(e);
314 cloudeebus.log("Method " + ifName + "." + method + " call on " + agent.objectPath + " exception: " + errorStr);
315 service._returnMethod(methodId, callDict.callIndex, false, errorStr);
318 agent.jsHdl.methodId[agent.objectPath].push(methodId);
319 this.wampSession.subscribe(methodId, agent.jsHdl.wrapperFunc[method]);
324 cloudeebus.Service.prototype._addSignal = function(ifName, signal, agent) {
326 var methodExist = false;
328 if (agent.jsHdl.interfaceProxies && agent.jsHdl.interfaceProxies[ifName])
329 if (agent.jsHdl.interfaceProxies[ifName][signal]) {
332 agent.jsHdl.interfaceProxies[ifName][signal] = function() {
333 service._emitSignal(agent.objectPath, signal, arguments[0]);
338 if ((agent.jsHdl[signal] == undefined || agent.jsHdl[signal] == null) && !methodExist)
339 agent.jsHdl[signal] = function() {
340 service._emitSignal(agent.objectPath, signal, arguments[0]);
343 cloudeebus.log("Can not create new method to emit signal '" + signal + "' in object JS this method already exist!");
347 cloudeebus.Service.prototype._createWrapper = function(agent) {
349 var parser = new DOMParser();
350 var xmlDoc = parser.parseFromString(agent.xml, "text/xml");
351 var ifXml = xmlDoc.getElementsByTagName("interface");
352 agent.jsHdl.wrapperFunc = [];
353 agent.jsHdl.methodId = [];
354 agent.jsHdl.methodId[agent.objectPath] = [];
355 for (var i=0; i < ifXml.length; i++) {
356 var ifName = ifXml[i].attributes.getNamedItem("name").value;
357 var ifChild = ifXml[i].firstChild;
359 if (ifChild.nodeName == "method") {
360 var metName = ifChild.attributes.getNamedItem("name").value;
361 self._addMethod(ifName, metName, agent);
363 if (ifChild.nodeName == "signal") {
364 var metName = ifChild.attributes.getNamedItem("name").value;
365 self._addSignal(ifName, metName, agent);
367 ifChild = ifChild.nextSibling;
373 cloudeebus.Service.prototype.addAgent = function(agent) {
376 var promise = new cloudeebus.Promise(function (resolver) {
377 function ServiceAddAgentSuccessCB(objPath) {
378 try { // calling dbus hook object function for un-translated types
379 self.agents.push(agent);
380 agent.registered = true;
381 var result = [ objPath ];
382 resolver.fulfill(result[0], true);
385 var errorStr = cloudeebus.getError(e);
386 cloudeebus.log("Method callback exception: " + errorStr);
387 resolver.reject(errorStr, true);
391 function ServiceAddAgenterrorCB(error) {
392 var errorStr = cloudeebus.getError(error);
393 cloudeebus.log("Error adding agent : " + agent.objectPath + ", error: " + errorStr);
394 self.promise.resolver.reject(errorStr, true);
398 self._createWrapper(agent);
401 var errorStr = cloudeebus.getError(e);
402 cloudeebus.log("Exception creating agent wrapper " + agent.objectPath + " : " + errorStr);
403 resolver.reject(errorStr, true);
412 // call dbusSend with bus type, destination, object, message and arguments
413 self.wampSession.call("serviceAddAgent", arglist).then(ServiceAddAgentSuccessCB, ServiceAddAgenterrorCB);
420 cloudeebus.Service.prototype._deleteWrapper = function(agent) {
421 var objJs = agent.jsHdl;
422 if (objJs.methodId[agent.objectPath]) {
423 for (var idx in objJs.methodId[agent.objectPath]) {
425 cloudeebus.log("unsubscribe " + objJs.methodId[agent.objectPath][idx]);
426 this.wampSession.unsubscribe(objJs.methodId[agent.objectPath][idx]);
427 objJs.methodId[agent.objectPath][idx] = null;
430 cloudeebus.log("Unsubscribe error: " + cloudeebus.getError(e));
433 delete objJs.methodId[agent.objectPath];
438 cloudeebus.Service.prototype.removeAgent = function(rmAgent) {
441 var promise = new cloudeebus.Promise(function (resolver) {
442 function ServiceRemoveAgentSuccessCB(agent) {
443 try { // calling dbus hook object function for un-translated types
444 self.agents.pop(agent);
445 agent.registered = false;
446 resolver.fulfill(agent, true);
449 var errorStr = cloudeebus.getError(e);
450 cloudeebus.log("Method callback exception: " + errorStr);
451 resolver.reject(errorStr, true);
455 function ServiceRemoveAgentErrorCB(error) {
456 var errorStr = cloudeebus.getError(error);
457 cloudeebus.log("Error removing agent : " + rmAgent.objectPath + ", error: " + errorStr);
458 self.promise.resolver.reject(errorStr, true);
462 self._deleteWrapper(rmAgent);
465 var errorStr = cloudeebus.getError(e);
466 cloudeebus.log("Exception removing wrapper of agent " + rmAgent.objectPath + " : " + errorStr);
474 // call dbusSend with bus type, destination, object, message and arguments
475 self.wampSession.call("serviceDelAgent", arglist).then(ServiceRemoveAgentSuccessCB, ServiceRemoveAgentErrorCB);
482 cloudeebus.Service.prototype._returnMethod = function(methodId, callIndex, success, result, successCB, errorCB) {
490 this.wampSession.call("returnMethod", arglist).then(successCB, errorCB);
494 cloudeebus.Service.prototype._emitSignal = function(objectPath, signalName, result, successCB, errorCB) {
501 this.wampSession.call("emitSignal", arglist).then(successCB, errorCB);
506 /*****************************************************************************/
508 function _processWrappers(wrappers, value) {
509 for (var i=0; i<wrappers.length; i++)
514 function _processWrappersAsync(wrappers, value) {
516 function processAsyncOnce() {
517 _processWrappers(wrappers, value);
518 clearInterval(taskid);
520 taskid = setInterval(processAsyncOnce, 200);
525 /*****************************************************************************/
527 cloudeebus.PromiseResolver = function(promise) {
528 this.promise = promise;
529 this.resolved = null;
534 cloudeebus.PromiseResolver.prototype.resolve = function(value, sync) {
538 var then = (value && value.then && value.then.apply) ? value.then : null;
541 var fulfillCallback = function(arg) {
542 self.resolve(arg, true);
544 var rejectCallback = function(arg) {
545 self.reject(arg, true);
548 then.apply(value, [fulfillCallback, rejectCallback]);
551 this.reject(cloudeebus.getError(e), true);
555 this.fulfill(value, sync);
559 cloudeebus.PromiseResolver.prototype.fulfill = function(value, sync) {
563 var promise = this.promise;
564 promise.state = "fulfilled";
565 promise.result = value;
567 this.resolved = true;
569 _processWrappers(promise._fulfillWrappers, value);
571 _processWrappersAsync(promise._fulfillWrappers, value);
575 cloudeebus.PromiseResolver.prototype.reject = function(value, sync) {
579 var promise = this.promise;
580 promise.state = "rejected";
581 promise.result = value;
583 this.resolved = true;
585 _processWrappers(promise._rejectWrappers, value);
587 _processWrappersAsync(promise._rejectWrappers, value);
592 /*****************************************************************************/
594 cloudeebus.Promise = function(init) {
595 this.state = "pending";
597 this._fulfillWrappers = [];
598 this._rejectWrappers = [];
599 this.resolver = new cloudeebus.PromiseResolver(this);
602 init.apply(this, [this.resolver]);
605 this.resolver.reject(cloudeebus.getError(e), true);
612 cloudeebus.Promise.prototype.appendWrappers = function(fulfillWrapper, rejectWrapper) {
614 this._fulfillWrappers.push(fulfillWrapper);
616 this._rejectWrappers.push(rejectWrapper);
617 if (this.state == "fulfilled")
618 _processWrappersAsync(this._fulfillWrappers, this.result);
619 if (this.state == "rejected")
620 _processWrappersAsync(this._rejectWrappers, this.result);
624 cloudeebus.Promise.prototype.then = function(fulfillCB, rejectCB) {
625 var promise = new cloudeebus.Promise();
626 var resolver = promise.resolver;
627 var fulfillWrapper, rejectWrapper;
630 fulfillWrapper = function(arg) {
632 var value = fulfillCB.apply(promise, [arg]);
633 resolver.resolve(value, true);
636 resolver.reject(cloudeebus.getError(e), true);
640 fulfillWrapper = function(arg) {
641 resolver.fulfill(arg, true);
645 rejectWrapper = function(arg) {
647 var value = rejectCB.apply(promise, [arg]);
648 resolver.resolve(value, true);
651 resolver.reject(cloudeebus.getError(e), true);
655 rejectWrapper = function(arg) {
656 resolver.reject(arg, true);
659 this.appendWrappers(fulfillWrapper,rejectWrapper);
664 cloudeebus.Promise.prototype["catch"] = function(rejectCB) {
665 return this.then(undefined,rejectCB);
669 cloudeebus.Promise.prototype.done = function(fulfillCB, rejectCB) {
670 this.appendWrappers(fulfillCB,rejectCB);
674 cloudeebus.Promise.resolve = function(value) {
675 var promise = new cloudeebus.Promise();
676 promise.resolver.resolve(value);
681 cloudeebus.Promise.fulfill = function(value) {
682 var promise = new cloudeebus.Promise();
683 promise.resolver.fulfill(value);
688 cloudeebus.Promise.reject = function(value) {
689 var promise = new cloudeebus.Promise();
690 promise.resolver.reject(value);
695 cloudeebus.Promise.any = function() {
696 var promise = new cloudeebus.Promise();
697 var resolver = promise.resolver;
698 var fulfillCallback = function(arg) {
699 resolver.resolve(arg, true);
701 var rejectCallback = function(arg) {
702 resolver.reject(arg, true);
704 if (arguments.length == 0)
705 resolver.resolve(undefined, true);
708 Promise.resolve(arguments[i]).appendWrappers(fulfillCallback,rejectCallback);
713 cloudeebus.Promise.every = function() {
714 var promise = new cloudeebus.Promise();
715 var resolver = promise.resolver;
717 var countdown = arguments.length;
718 var args = new Array(countdown);
719 var rejectCallback = function(arg) {
720 resolver.reject(arg, true);
722 if (arguments.length == 0)
723 resolver.resolve(undefined, true);
725 for (i in arguments) {
726 var fulfillCallback = function(arg) {
730 resolver.resolve(args, true);
733 Promise.resolve(arguments[i]).appendWrappers(fulfillCallback,rejectCallback);
740 cloudeebus.Promise.some = function() {
741 var promise = new cloudeebus.Promise();
742 var resolver = promise.resolver;
744 var countdown = arguments.length;
745 var args = new Array(countdown);
746 var fulfillCallback = function(arg) {
747 resolver.resolve(arg, true);
749 if (arguments.length == 0)
750 resolver.resolve(undefined, true);
752 for (i in arguments) {
753 var rejectCallback = function(arg) {
757 resolver.reject(args, true);
760 Promise.resolve(arguments[i]).appendWrappers(fulfillCallback,rejectCallback);
768 /*****************************************************************************/
770 cloudeebus.ProxyObject = function(session, busConnection, busName, objectPath) {
771 this.wampSession = session;
772 this.busConnection = busConnection;
773 this.busName = busName;
774 this.objectPath = objectPath;
775 this.interfaceProxies = {};
780 cloudeebus.ProxyObject.prototype.getInterface = function(ifName) {
781 return this.interfaceProxies[ifName];
785 cloudeebus.ProxyObject.prototype._introspect = function(successCB, errorCB) {
789 function getAllPropertiesSuccessCB(props) {
790 var ifProxy = self.interfaceProxies[self.propInterfaces[self.propInterfaces.length-1]];
791 for (var prop in props)
792 ifProxy[prop] = self[prop] = props[prop];
793 getAllPropertiesNextInterfaceCB();
796 function getAllPropertiesNextInterfaceCB() {
797 self.propInterfaces.pop();
798 if (self.propInterfaces.length > 0)
799 self.callMethod("org.freedesktop.DBus.Properties",
801 [self.propInterfaces[self.propInterfaces.length-1]]).then(getAllPropertiesSuccessCB,
802 errorCB ? errorCB : getAllPropertiesNextInterfaceCB);
804 self.propInterfaces = null;
810 function introspectSuccessCB(str) {
811 var parser = new DOMParser();
812 var xmlDoc = parser.parseFromString(str, "text/xml");
813 var interfaces = xmlDoc.getElementsByTagName("interface");
814 self.propInterfaces = [];
815 var supportDBusProperties = false;
816 for (var i=0; i < interfaces.length; i++) {
817 var ifName = interfaces[i].attributes.getNamedItem("name").value;
818 self.interfaceProxies[ifName] = new cloudeebus.ProxyObject(self.wampSession, self.busConnection, self.busName, self.objectPath);
819 if (ifName == "org.freedesktop.DBus.Properties")
820 supportDBusProperties = true;
821 var hasProperties = false;
822 var ifChild = interfaces[i].firstChild;
824 if (ifChild.nodeName == "method") {
827 var metChild = ifChild.firstChild;
829 if (metChild.nodeName == "arg" &&
830 metChild.attributes.getNamedItem("direction").value == "in") {
831 signature += metChild.attributes.getNamedItem("type").value;
834 metChild = metChild.nextSibling;
836 var metName = ifChild.attributes.getNamedItem("name").value;
838 self._addMethod(ifName, metName, nArgs, signature);
839 self.interfaceProxies[ifName]._addMethod(ifName, metName, nArgs, signature);
841 else if (ifChild.nodeName == "property") {
843 self.propInterfaces.push(ifName);
844 hasProperties = true;
846 ifChild = ifChild.nextSibling;
849 if (supportDBusProperties && self.propInterfaces.length > 0) {
850 self.callMethod("org.freedesktop.DBus.Properties",
852 [self.propInterfaces[self.propInterfaces.length-1]]).then(getAllPropertiesSuccessCB,
853 errorCB ? errorCB : getAllPropertiesNextInterfaceCB);
856 self.propInterfaces = null;
862 // call Introspect on self
863 self.callMethod("org.freedesktop.DBus.Introspectable", "Introspect", []).then(introspectSuccessCB, errorCB);
867 cloudeebus.ProxyObject.prototype._addMethod = function(ifName, method, nArgs, signature) {
871 self[method] = function() {
873 for (var i=0; i < nArgs; i++ )
874 args.push(arguments[i]);
875 return self.callMethod(ifName, method, args, signature);
880 cloudeebus.ProxyObject.prototype.callMethod = function(ifName, method, args, signature) {
884 var promise = new cloudeebus.Promise(function (resolver) {
885 function callMethodSuccessCB(str) {
886 try { // calling dbus hook object function for un-translated types
887 var result = eval(str);
888 resolver.fulfill(result[0], true);
891 var errorStr = cloudeebus.getError(e);
892 cloudeebus.log("Method callback exception: " + errorStr);
893 resolver.reject(errorStr, true);
897 function callMethodErrorCB(error) {
898 var errorStr = cloudeebus.getError(error);
899 cloudeebus.log("Error calling method: " + method + " on object: " + self.objectPath + " : " + errorStr);
900 resolver.reject(errorStr, true);
904 self.busConnection.name,
912 // call dbusSend with bus type, destination, object, message and arguments
913 self.wampSession.call("dbusSend", arglist).then(callMethodSuccessCB, callMethodErrorCB);
920 cloudeebus.ProxyObject.prototype.connectToSignal = function(ifName, signal, handlerCB, errorCB) {
924 function signalHandler(id, data) {
926 try { // calling dbus hook object function for un-translated types
927 handlerCB.apply(self, eval(data));
930 var errorStr = cloudeebus.getError(e);
931 cloudeebus.log("Signal handler exception: " + errorStr);
938 function connectToSignalSuccessCB(str) {
940 self.wampSession.subscribe(str, signalHandler);
943 cloudeebus.log("Subscribe error: " + cloudeebus.getError(e));
947 function connectToSignalErrorCB(error) {
948 var errorStr = cloudeebus.getError(error);
949 cloudeebus.log("Error connecting to signal: " + signal + " on object: " + self.objectPath + " : " + errorStr);
955 self.busConnection.name,
962 // call dbusSend with bus type, destination, object, message and arguments
963 self.wampSession.call("dbusRegister", arglist).then(connectToSignalSuccessCB, connectToSignalErrorCB);
967 cloudeebus.ProxyObject.prototype.disconnectSignal = function(ifName, signal) {
969 this.wampSession.unsubscribe(this.busConnection.name + "#" + this.busName + "#" + this.objectPath + "#" + ifName + "#" + signal);
972 cloudeebus.log("Unsubscribe error: " + cloudeebus.getError(e));