Inter-Widget Communication (IWC)

System API

Application registrations of the bus. This api gives connections to the bus awareness of what applications the bus has knowledge of.

Different then the names api, these application's are not the current running applications, rather these are registrations of applications hosted and default configurations for launching them. This gives IWC clients the capability to launch other applications. This is a read-only API.


Accessing the System API

The System API is accessed through the system property of a connected IWC Client.

var iwc = new ozpIwc.Client("http://localhost:13000);
var system = iwc.system;

Referencing System API Nodes

The IWC uses the concept of references when accessing resources. References are objects with auto-generated functionality to perform actions on a given resource.

To create a reference to a resource, use the Reference constructor of the desired api, names in this case, with a string of the resource path:

var appRef = new iwc.system.Reference("/application/ozp.demo.app");

System API Actions

Action has Callback? Description
get no gathers the node with the specific key
bulkGet no gathers all nodes who's key matches the given partial-key
list no gathers all node keys who match the given partial-key
set no stores the given value to the specified node
delete no deletes the node with the specific key
watch yes gathers the node with the specific key and calls the registered callback on updates to the node
unwatch no unregisters the callback for the node
launch no opens an application registered to the IWC bus.