joynr.start.InterTabLibjoynrRuntime.js Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of libjoynr-js Show documentation
Show all versions of libjoynr-js Show documentation
JOYnr JavaScript libjoynr-js
/*jslint es5: true, node: true */
/*
* #%L
* %%
* Copyright (C) 2011 - 2017 BMW Car IT GmbH
* %%
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
* #L%
*/
var Promise = require("../../global/Promise");
var Arbitrator = require("../capabilities/arbitration/Arbitrator");
var ProviderBuilder = require("../provider/ProviderBuilder");
var ProxyBuilder = require("../proxy/ProxyBuilder");
var CapabilitiesRegistrar = require("../capabilities/CapabilitiesRegistrar");
var ParticipantIdStorage = require("../capabilities/ParticipantIdStorage");
var RequestReplyManager = require("../dispatching/RequestReplyManager");
var PublicationManager = require("../dispatching/subscription/PublicationManager");
var SubscriptionManager = require("../dispatching/subscription/SubscriptionManager");
var Dispatcher = require("../dispatching/Dispatcher");
var JoynrException = require("../exceptions/JoynrException");
var PlatformSecurityManager = require("../security/PlatformSecurityManagerNode");
var WebMessagingStub = require("../messaging/webmessaging/WebMessagingStub");
var WebMessagingSkeleton = require("../messaging/webmessaging/WebMessagingSkeleton");
var BrowserMessagingStubFactory = require("../messaging/browser/BrowserMessagingStubFactory");
var BrowserMessagingSkeleton = require("../messaging/browser/BrowserMessagingSkeleton");
var BrowserMulticastAddressCalculator = require("../messaging/browser/BrowserMulticastAddressCalculator");
var MessagingSkeletonFactory = require("../messaging/MessagingSkeletonFactory");
var MessagingStubFactory = require("../messaging/MessagingStubFactory");
var MessageRouter = require("../messaging/routing/MessageRouter");
var MessageQueue = require("../messaging/routing/MessageQueue");
var BrowserAddress = require("../system/RoutingTypes/BrowserAddress");
var InProcessMessagingStubFactory = require("../messaging/inprocess/InProcessMessagingStubFactory");
var InProcessMessagingSkeleton = require("../messaging/inprocess/InProcessMessagingSkeleton");
var InProcessMessagingStub = require("../messaging/inprocess/InProcessMessagingStub");
var InProcessAddress = require("../messaging/inprocess/InProcessAddress");
var InProcessStub = require("../util/InProcessStub");
var InProcessSkeleton = require("../util/InProcessSkeleton");
var MessagingQos = require("../messaging/MessagingQos");
var DiscoveryQos = require("../proxy/DiscoveryQos");
var DiscoveryProxy = require("../system/DiscoveryProxy");
var RoutingProxy = require("../system/RoutingProxy");
var TypeRegistrySingleton = require("../types/TypeRegistrySingleton");
var DiscoveryScope = require("../types/DiscoveryScope");
var DiscoveryEntryWithMetaInfo = require("../types/DiscoveryEntryWithMetaInfo");
var Util = require("../util/UtilInternal");
var CapabilitiesUtil = require("../util/CapabilitiesUtil");
var WebWorkerMessagingAppender = require("../system/WebWorkerMessagingAppender");
var uuid = require("../../lib/uuid-annotated");
var LoggingManager = require("../system/LoggingManager");
var LoggerFactory = require("../system/LoggerFactory");
var defaultSettings = require("./settings/defaultSettings");
var defaultInterTabSettings = require("./settings/defaultInterTabSettings");
var defaultLibjoynrSettings = require("./settings/defaultLibjoynrSettings");
var LocalStorage = require("../../global/LocalStorageNode");
var JoynrStates = {
SHUTDOWN: "shut down",
STARTING: "starting",
STARTED: "started",
SHUTTINGDOWN: "shutting down"
};
var TWO_DAYS_IN_MS = 172800000;
var CC_WINDOWID = "ClusterController";
/**
* The InterTabLibjoynrRuntime is the version of the libjoynr-js runtime that
* communicates with a cluster controller over inter tab communication
*
* @name InterTabLibjoynrRuntime
* @constructor
*
* @param provisioning
*/
function InterTabLibjoynrRuntime(provisioning) {
var loggingManager;
var ccAddress;
var initialRoutingTable;
var untypedCapabilities;
var typedCapabilities;
var messagingSkeletonFactory;
var messagingStubFactory;
var messageRouter;
var libjoynrMessagingSkeleton;
var dispatcher;
var typeRegistry;
var requestReplyManager;
var subscriptionManager;
var publicationManager;
var participantIdStorage;
var arbitrator;
var providerBuilder;
var proxyBuilder;
var capabilitiesRegistrar;
var discovery;
var messageQueueSettings;
var webMessagingStub;
var webMessagingSkeleton;
var browserMessagingSkeleton;
var messageRouterSkeleton;
var messageRouterStub;
var persistency;
var libjoynrInterTabAddress;
// this is required at load time of libjoynr
typeRegistry = Object.freeze(TypeRegistrySingleton.getInstance());
/**
* @name InterTabLibjoynrRuntime#typeRegistry
* @type TypeRegistry
*/
Object.defineProperty(this, "typeRegistry", {
get: function() {
return typeRegistry;
},
enumerable: true
});
/**
* @name InterTabLibjoynrRuntime#registration
* @type CapabilitiesRegistrar
*/
Object.defineProperty(this, "registration", {
get: function() {
return capabilitiesRegistrar;
},
enumerable: true
});
/**
* @name InterTabLibjoynrRuntime#providerBuilder
* @type ProviderBuilder
*/
Object.defineProperty(this, "providerBuilder", {
get: function() {
return providerBuilder;
},
enumerable: true
});
/**
* @name InterTabLibjoynrRuntime#proxyBuilder
* @type ProxyBuilder
*/
Object.defineProperty(this, "proxyBuilder", {
get: function() {
return proxyBuilder;
},
enumerable: true
});
/**
* @name InterTabLibjoynrRuntime#participantIdStorage
* @type ParticipantIdStorage
*/
Object.defineProperty(this, "participantIdStorage", {
get: function() {
return participantIdStorage;
},
enumerable: true
});
/**
* @name InterTabLibjoynrRuntime#logging
* @type LoggingManager
*/
Object.defineProperty(this, "logging", {
get: function() {
return loggingManager;
},
enumerable: true
});
var log, relativeTtl;
if (provisioning.logging && provisioning.logging.ttl) {
relativeTtl = provisioning.logging.ttl;
} else {
relativeTtl = TWO_DAYS_IN_MS;
}
var loggingMessagingQos = new MessagingQos({
ttl: relativeTtl
});
loggingManager = Object.freeze(new LoggingManager());
LoggerFactory.init(loggingManager);
var joynrState = JoynrStates.SHUTDOWN;
if (provisioning.capabilities && provisioning.capabilities.discoveryQos) {
var discoveryQos = provisioning.capabilities.discoveryQos;
if (discoveryQos.discoveryExpiryIntervalMs) {
CapabilitiesRegistrar.setDefaultExpiryIntervalMs(discoveryQos.discoveryExpiryIntervalMs);
}
var discoveryQosSettings = {};
if (discoveryQos.discoveryRetryDelayMs) {
discoveryQosSettings.discoveryRetryDelayMs = discoveryQos.discoveryRetryDelayMs;
}
if (discoveryQos.discoveryTimeoutMs) {
discoveryQosSettings.discoveryTimeoutMs = discoveryQos.discoveryTimeoutMs;
}
DiscoveryQos.setDefaultSettings(discoveryQosSettings);
}
/**
* Starts up the libjoynr instance
*
* @name InterTabLibjoynrRuntime#start
* @function
* @returns {Object} an A+ promise object, reporting when libjoynr startup is
* completed or has failed
* @throws {Error}
* if libjoynr is not in SHUTDOWN state
*/
this.start = function start() {
var i, j;
ccAddress = new BrowserAddress({
windowId: CC_WINDOWID
});
if (joynrState !== JoynrStates.SHUTDOWN) {
throw new Error("Cannot start libjoynr because it's currently \"" + joynrState + '"');
}
joynrState = JoynrStates.STARTING;
if (!provisioning) {
throw new Error("Constructor has been invoked without provisioning");
}
// initialize Logger with external logging configuration or default
// values
loggingManager.registerAppenderClass("WebWorker", WebWorkerMessagingAppender);
if (provisioning.logging) {
loggingManager.configure(provisioning.logging);
}
log = LoggerFactory.getLogger("joynr.start.InterTabLibjoynrRuntime");
var persistencyProvisioning = provisioning.persistency || {};
persistency = new LocalStorage({
clearPersistency: persistencyProvisioning.clearPersistency,
location: persistencyProvisioning.location
});
if (Util.checkNullUndefined(provisioning.parentWindow)) {
log.debug(
'provisioning.parentWindow not set. Use default setting "' +
defaultInterTabSettings.parentWindow +
'" instead'
);
}
if (Util.checkNullUndefined(provisioning.windowId)) {
throw new Error("windowId not set in provisioning.windowId");
}
libjoynrInterTabAddress = new BrowserAddress({
windowId: provisioning.windowId
});
initialRoutingTable = {};
untypedCapabilities = provisioning.capabilities || [];
var defaultCapabilities = defaultLibjoynrSettings.capabilities || [];
untypedCapabilities = untypedCapabilities.concat(defaultCapabilities);
typedCapabilities = [];
for (i = 0; i < untypedCapabilities.length; i++) {
var capability = new DiscoveryEntryWithMetaInfo(untypedCapabilities[i]);
initialRoutingTable[capability.participantId] = ccAddress;
typedCapabilities.push(capability);
}
messageQueueSettings = {};
if (provisioning.messaging !== undefined && provisioning.messaging.maxQueueSizeInKBytes !== undefined) {
messageQueueSettings.maxQueueSizeInKBytes = provisioning.messaging.maxQueueSizeInKBytes;
}
webMessagingStub = new WebMessagingStub({
// parent window variable for communication
window: provisioning.parentWindow || defaultInterTabSettings.parentWindow,
// target origin of the parent window
origin: provisioning.parentOrigin || defaultInterTabSettings.parentOrigin
});
webMessagingSkeleton = new WebMessagingSkeleton({
window: provisioning.window || defaultInterTabSettings.window
});
browserMessagingSkeleton = new BrowserMessagingSkeleton({
webMessagingSkeleton: webMessagingSkeleton
});
messagingSkeletonFactory = new MessagingSkeletonFactory();
var messagingStubFactories = {};
/*jslint nomen: true */
messagingStubFactories[InProcessAddress._typeName] = new InProcessMessagingStubFactory();
messagingStubFactories[BrowserAddress._typeName] = new BrowserMessagingStubFactory({
webMessagingStub: webMessagingStub
});
/*jslint nomen: false */
messagingStubFactory = new MessagingStubFactory({
messagingStubFactories: messagingStubFactories
});
messageRouter = new MessageRouter({
initialRoutingTable: initialRoutingTable,
persistency: persistency,
typeRegistry: typeRegistry,
joynrInstanceId: provisioning.windowId,
messagingSkeletonFactory: messagingSkeletonFactory,
messagingStubFactory: messagingStubFactory,
messageQueue: new MessageQueue(messageQueueSettings),
parentMessageRouterAddress: ccAddress,
multicastAddressCalculator: new BrowserMulticastAddressCalculator({
globalAddress: ccAddress
}),
incomingAddress: libjoynrInterTabAddress
});
browserMessagingSkeleton.registerListener(messageRouter.route);
// link up clustercontroller messaging to dispatcher
messageRouterSkeleton = new InProcessMessagingSkeleton();
messageRouterStub = new InProcessMessagingStub(messageRouterSkeleton);
// clustercontroller messaging handled by the messageRouter
messageRouterSkeleton.registerListener(messageRouter.route);
var ttlUpLiftMs =
provisioning.messaging && provisioning.messaging.TTL_UPLIFT ? provisioning.messaging.TTL_UPLIFT : undefined;
dispatcher = new Dispatcher(messageRouterStub, new PlatformSecurityManager(), ttlUpLiftMs);
libjoynrMessagingSkeleton = new InProcessMessagingSkeleton();
libjoynrMessagingSkeleton.registerListener(dispatcher.receive);
var messagingSkeletons = {};
/*jslint nomen: true */
messagingSkeletons[InProcessAddress._typeName] = libjoynrMessagingSkeleton;
messagingSkeletons[BrowserAddress._typeName] = browserMessagingSkeleton;
/*jslint nomen: false */
messagingSkeletonFactory.setSkeletons(messagingSkeletons);
requestReplyManager = new RequestReplyManager(dispatcher, typeRegistry);
subscriptionManager = new SubscriptionManager(dispatcher);
publicationManager = new PublicationManager(dispatcher, persistency, "joynrInstanceId"); //TODO: set joynrInstanceId
dispatcher.registerRequestReplyManager(requestReplyManager);
dispatcher.registerSubscriptionManager(subscriptionManager);
dispatcher.registerPublicationManager(publicationManager);
dispatcher.registerMessageRouter(messageRouter);
participantIdStorage = new ParticipantIdStorage(persistency, uuid);
discovery = new InProcessStub();
capabilitiesRegistrar = Object.freeze(
new CapabilitiesRegistrar({
discoveryStub: discovery,
messageRouter: messageRouter,
requestReplyManager: requestReplyManager,
publicationManager: publicationManager,
libjoynrMessagingAddress: new InProcessAddress(libjoynrMessagingSkeleton),
participantIdStorage: participantIdStorage,
loggingManager: loggingManager
})
);
arbitrator = new Arbitrator(discovery, typedCapabilities);
providerBuilder = Object.freeze(new ProviderBuilder());
proxyBuilder = Object.freeze(
new ProxyBuilder(
{
arbitrator: arbitrator,
typeRegistry: typeRegistry,
requestReplyManager: requestReplyManager,
subscriptionManager: subscriptionManager,
publicationManager: publicationManager
},
{
messageRouter: messageRouter,
libjoynrMessagingAddress: new InProcessAddress(libjoynrMessagingSkeleton),
loggingManager: loggingManager
}
)
);
var getDiscoveryProxy = function getDiscoveryProxy(ttl) {
return proxyBuilder
.build(DiscoveryProxy, {
domain: "io.joynr",
messagingQos: {
ttl: ttl
},
discoveryQos: new DiscoveryQos({
discoveryScope: DiscoveryScope.LOCAL_ONLY
}),
staticArbitration: true
})
.catch(function(error) {
throw new Error("Failed to create discovery proxy: " + error);
});
};
var TTL_30DAYS_IN_MS = 30 * 24 * 60 * 60 * 1000;
discovery.setSkeleton(
new InProcessSkeleton({
lookup: function lookup(domains, interfaceName, discoveryQos) {
return getDiscoveryProxy(discoveryQos.discoveryTimeoutMs).then(function(newDiscoveryProxy) {
return newDiscoveryProxy
.lookup({
domains: domains,
interfaceName: interfaceName,
discoveryQos: discoveryQos
})
.then(function(opArgs) {
return opArgs.result;
});
});
},
add: function add(discoveryEntry) {
return getDiscoveryProxy(TTL_30DAYS_IN_MS).then(function(newDiscoveryProxy) {
return newDiscoveryProxy.add({
discoveryEntry: discoveryEntry
});
});
},
remove: function remove(participantId) {
return getDiscoveryProxy(TTL_30DAYS_IN_MS).then(function(newDiscoveryProxy) {
return newDiscoveryProxy.remove({
participantId: participantId
});
});
}
})
);
var internalMessagingQos = new MessagingQos(provisioning.internalMessagingQos);
var routingProxyPromise = proxyBuilder
.build(RoutingProxy, {
domain: "io.joynr",
messagingQos: internalMessagingQos,
discoveryQos: new DiscoveryQos({
discoveryScope: DiscoveryScope.LOCAL_ONLY
}),
staticArbitration: true
})
.catch(function(error) {
throw new Error(
"Failed to create routing proxy: " +
error +
(error instanceof JoynrException ? " " + error.detailMessage : "")
);
})
.then(function(newRoutingProxy) {
messageRouter.setRoutingProxy(newRoutingProxy);
return newRoutingProxy;
});
// when everything's ready we can trigger the app
return routingProxyPromise
.then(function() {
joynrState = JoynrStates.STARTED;
publicationManager.restore();
log.debug("libjoynr initialized");
return;
})
.catch(function(error) {
log.error("error starting up joynr: " + error);
throw error;
});
};
/**
* Shuts down libjoynr
*
* @name InterTabLibjoynrRuntime#shutdown
* @function
* @throws {Error}
* if libjoynr is not in the STARTED state
*/
this.shutdown = function shutdown(settings) {
if (joynrState !== JoynrStates.STARTED) {
throw new Error("Cannot shutdown libjoynr because it's currently \"" + joynrState + '"');
}
joynrState = JoynrStates.SHUTTINGDOWN;
var shutdownProvisioning = provisioning.shutdownSettings || {};
settings = settings || {};
if (settings.clearSubscriptionsEnabled || shutdownProvisioning.clearSubscriptionsEnabled) {
var clearSubscriptionTimeoutMs =
settings.clearSubscriptionsTimeoutMs || shutdownProvisioning.clearSubscriptionsTimeoutMs || 1000;
subscriptionManager.terminateSubscriptions(clearSubscriptionTimeoutMs);
}
if (webMessagingSkeleton !== undefined) {
webMessagingSkeleton.shutdown();
}
if (capabilitiesRegistrar !== undefined) {
capabilitiesRegistrar.shutdown();
}
if (arbitrator !== undefined) {
arbitrator.shutdown();
}
if (messageRouter !== undefined) {
messageRouter.shutdown();
}
if (requestReplyManager !== undefined) {
requestReplyManager.shutdown();
}
if (publicationManager !== undefined) {
publicationManager.shutdown();
}
if (subscriptionManager !== undefined) {
subscriptionManager.shutdown();
}
if (dispatcher !== undefined) {
dispatcher.shutdown();
}
if (typeRegistry !== undefined) {
typeRegistry.shutdown();
}
if (loggingManager !== undefined) {
loggingManager.shutdown();
}
return Promise.all([] /* TODO: insert promises here */).then(function() {
joynrState = JoynrStates.SHUTDOWN;
log.debug("joynr shut down");
return;
});
};
// make every instance immutable
return Object.freeze(this);
}
module.exports = InterTabLibjoynrRuntime;
© 2015 - 2025 Weber Informatics LLC | Privacy Policy