joynr.system.DiscoveryProxy.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
JOYnr JavaScript libjoynr-js
There is a newer version: 1.4.0
/**
 * PLEASE NOTE: THIS IS A GENERATED FILE!
 * Generation date: Fri Jun 29 14:35:21 CEST 2018
 *
 * DiscoveryProxy, generated from the corresponding interface description.
 */
(function (undefined){
	/**
	 * @name DiscoveryProxy
	 * @constructor
	 *
	 * @classdesc
	 * 
Generation date: Fri Jun 29 14:35:21 CEST 2018
	 * 


	 * DiscoveryProxy, generated from the corresponding interface description.
	 * 

The Discovery interface is a joynr internal
	 * interface. This interface is used by libjoynr to add, lookup or
	 * remove provider to joynr discovery. Internally joynr discovery
	 * consists of a centralized discovery directory
	 * (GlobalCapabilitiesDirectory) that is distributed to
	 * all cluster controller (LocalCapabilitiesDirectory).
	 *
	 * @param {object} settings the settings object for this function call
	 * @param {String} settings.domain the domain name //TODO: check do we need this?
	 * @param {String} settings.joynrName the interface name //TODO: check do we need this?
	 *
	 * @param {Object} settings.discoveryQos the Quality of Service parameters for arbitration
	 * @param {Number} settings.discoveryQos.discoveryTimeoutMs for rpc calls to wait for arbitration to finish.
	 * @param {String} settings.discoveryQos.arbitrationStrategy Strategy for choosing the appropriate provider from the list returned by the capabilities directory
	 * @param {Number} settings.discoveryQos.cacheMaxAgeMs Maximum age of entries in the localCapabilitiesDirectory. If this value filters out all entries of the local capabilities directory a lookup in the global capabilitiesDirectory will take place.
	 * @param {Boolean} settings.discoveryQos.discoveryScope If localOnly is set to true, only local providers will be considered.
	 * @param {Object} settings.discoveryQos.additionalParameters a map holding additional parameters in the form of key value pairs in the javascript object, e.g.: {"myKey": "myValue", "myKey2": 5}
	 *
	 * @param {object} settings.messagingQos the Quality of Service parameters for messaging
	 * @param {Number} settings.messagingQos.ttl Roundtrip timeout for rpc requests.

	 * @param {Number} settings.dependencies instances of the internal objects needed by the proxy to interface with joynr
	 * @param {Number} settings.proxyElementTypes constructors for attribute, method and broadcasts, used to create the proxy's elements
	 *
	 * @returns {DiscoveryProxy} a DiscoveryProxy object to access other providers
	 */
	var DiscoveryProxy = function DiscoveryProxy(
		settings) {
		if (!(this instanceof DiscoveryProxy)) {
			// in case someone calls constructor without new keyword (e.g. var c = Constructor({..}))
			return new DiscoveryProxy(
				settings);
		}

		// generated package name
		this.settings = settings || {};


		/**
		 * @function DiscoveryProxy#add
		 * @summary The add operation is GENERATED FROM THE INTERFACE DESCRIPTION
		 * 
method overloading: different call semantics possible
		 * 

Adds a provider to the joynr discovery.
		 *
		 * @param {Object} settings the arguments object for this function call
		 * @param {DiscoveryEntry} settings.discoveryEntry -
		 * the new DiscoveryEntry to be added
		 */
		/**
		 * @function DiscoveryProxy#add
		 * @summary The add operation is GENERATED FROM THE INTERFACE DESCRIPTION
		 * 
method overloading: different call semantics possible
		 * 

Adds a provider to the joynr discovery.
		 *
		 * @param {Object} settings the arguments object for this function call
		 * @param {DiscoveryEntry} settings.discoveryEntry -
		 * the new DiscoveryEntry to be added
		 * @param {Boolean} settings.awaitGlobalRegistration -
		 * if true, the response will be delayed either until
		 * global registration succeeded or failed
		 */
		this.add = new settings.proxyElementTypes.ProxyOperation(this, settings, "add", [
			{
				inputParameter: [
				{
					name : "discoveryEntry",
					type : "joynr.types.DiscoveryEntry",
					javascriptType : "joynr.types.DiscoveryEntry"
				}
				],
				outputParameter: [
				],
				fireAndForget: false
			},			{
				inputParameter: [
				{
					name : "discoveryEntry",
					type : "joynr.types.DiscoveryEntry",
					javascriptType : "joynr.types.DiscoveryEntry"
				},
				{
					name : "awaitGlobalRegistration",
					type : "Boolean",
					javascriptType : "boolean"
				}
				],
				outputParameter: [
				],
				fireAndForget: false
			}
		]).buildFunction();
		/**
		 * @function DiscoveryProxy#lookup
		 * @summary The lookup operation is GENERATED FROM THE INTERFACE DESCRIPTION
		 * 
method overloading: different call semantics possible
		 * 

Looks up a providers in the joynr discovery that match
		 * the requested QoS.
		 *
		 * @param {Object} settings the arguments object for this function call
		 * @param {Array.} settings.domains -
		 * the domain to search for provider
		 * @param {String} settings.interfaceName -
		 * the interface the provider must implement
		 * @param {DiscoveryQos} settings.discoveryQos -
		 * the QoS used for the lookup
		 * @returns {DiscoveryProxy#LookupReturned}
		 * 	{Array.} result
		 */
		/**
		 * @typedef {Object} DiscoveryProxy#LookupReturned
		 * @property {Array.} result
		 * a list of matching providers
		 */
		/**
		 * @function DiscoveryProxy#lookup
		 * @summary The lookup operation is GENERATED FROM THE INTERFACE DESCRIPTION
		 * 
method overloading: different call semantics possible
		 * 

Looks up a specific provider in the joynr discovery.
		 *
		 * @param {Object} settings the arguments object for this function call
		 * @param {String} settings.participantId -
		 * the participant ID of the provider to look up
		 * @returns {DiscoveryProxy#LookupReturned}
		 * 	{DiscoveryEntryWithMetaInfo} result
		 */
		/**
		 * @typedef {Object} DiscoveryProxy#LookupReturned
		 * @property {DiscoveryEntryWithMetaInfo} result
		 * the provider matching the participant ID
		 */
		this.lookup = new settings.proxyElementTypes.ProxyOperation(this, settings, "lookup", [
			{
				inputParameter: [
				{
					name : "domains",
					type : "String[]",
					javascriptType : "Array"
				},
				{
					name : "interfaceName",
					type : "String",
					javascriptType : "string"
				},
				{
					name : "discoveryQos",
					type : "joynr.types.DiscoveryQos",
					javascriptType : "joynr.types.DiscoveryQos"
				}
				],
				outputParameter: [
					{
						name : "result",
						type : "joynr.types.DiscoveryEntryWithMetaInfo[]",
						javascriptType : "Array"
					}
				],
				fireAndForget: false
			},			{
				inputParameter: [
				{
					name : "participantId",
					type : "String",
					javascriptType : "string"
				}
				],
				outputParameter: [
					{
						name : "result",
						type : "joynr.types.DiscoveryEntryWithMetaInfo",
						javascriptType : "joynr.types.DiscoveryEntryWithMetaInfo"
					}
				],
				fireAndForget: false
			}
		]).buildFunction();
		/**
		 * @function DiscoveryProxy#remove
		 * @summary The remove operation is GENERATED FROM THE INTERFACE DESCRIPTION
		 * 

Removes a provider from joynr discovery.
		 *
		 * @param {Object} settings the arguments object for this function call
		 * @param {String} settings.participantId -
		 * the participant ID of the provider to remove
		 */
		this.remove = new settings.proxyElementTypes.ProxyOperation(this, settings, "remove", [
			{
				inputParameter: [
				{
					name : "participantId",
					type : "String",
					javascriptType : "string"
				}
				],
				outputParameter: [
				],
				fireAndForget: false
			}
		]).buildFunction();


		Object.defineProperty(this, "interfaceName", {
			value: "system/Discovery"
		});
	};

	/**
	 * @name DiscoveryProxy#MAJOR_VERSION
	 * @constant {Number}
	 * @default 0
	 * @summary The MAJOR_VERSION of the proxy is GENERATED FROM THE INTERFACE DESCRIPTION
	 */
	Object.defineProperty(DiscoveryProxy, 'MAJOR_VERSION', { value: 0});
	/**
	 * @name DiscoveryProxy#MINOR_VERSION
	 * @constant {Number}
	 * @default 1
	 * @summary The MINOR_VERSION of the proxy is GENERATED FROM THE INTERFACE DESCRIPTION
	 */
	Object.defineProperty(DiscoveryProxy, 'MINOR_VERSION', { value: 1});

	DiscoveryProxy.getUsedDatatypes = function getUsedDatatypes(){
		return [
			"joynr.types.DiscoveryQos",
			"joynr.types.DiscoveryEntryWithMetaInfo",
			"joynr.types.DiscoveryEntry"
		];
	};

	require("../../joynr/types/Version");
	require("../../joynr/types/ProviderQos");
	require("../../joynr/types/DiscoveryScope");
	require("../../joynr/types/DiscoveryQos");
	require("../../joynr/types/DiscoveryEntryWithMetaInfo");
	require("../../joynr/types/DiscoveryEntry");
	require("../../joynr/types/CustomParameter");
	require("../../joynr/types/ProviderScope");
	module.exports = DiscoveryProxy;
})();