aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: 43046faf750a144f85d95221515778326fb2a938 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
## sdc-pubsub

sdc-pubsub [npm](https://www.npmjs.com/package/sdc-pubsub) package.

### Installation

Installing using npm:

```
npm install sdc-pubsub
```

### Loading It Up
#### CommonJS
```javascript
import {PluginPubSub} from 'sdc-pubsub'
```
#### Global Variable

```html
<!-- index.html -->
<script src="./node_modules/sdc-pubsub/dist/sdc-pubsub.js"></script>
```

```javascript
// script.js
var pubsub = window.sdcPubSub.PluginPubSub;
```

### Usage
#### Initialize a pubsub client
```javascript
// eventsClientId = client id to be used by the event bus, received from query params
// parentUrl = event bus location url for communication, received from query params
// eventsToWaitFor = list of events names that the event hub should wait for their completion.
//                   the client should send an "ACTION_COMPLETED" event to the hub in order to notify the event hub to continue with the flow.
//                   For example: [ “CHECK_IN” ]

var client = new PluginPubSub('eventsClientId, parentUrl, eventsToWaitFor')
```

#### Notify about events
```javascript
client.notify(READY)
```

#### Register for an event
```javascript
// When lisetning to event we have to specify the specific event we want to act once it being received.
// eventData.type will hold the event name that was notified by someone else
client.on((eventData,event) => {
      if(eventData.type == WINDOW_OUT) {
          //do logic
      }
   }
)
```

### Dependencies

None.

### Tests

None.

### Authors

* Idan Amit: [https://wiki.onap.org/display/~idanamit](hhttps://wiki.onap.org/display/~idanamit)


### Links

* SDC onap wiki [https://wiki.onap.org/x/_TX0](https://wiki.onap.org/x/_TX0)
* Generic designer support document [https://wiki.onap.org/display/DW/Generic+Designer+Support](https://wiki.onap.org/display/DW/Generic+Designer+Support)
* Repository [https://gerrit.onap.org/r/gitweb?p=sdc/sdc-pubsub.git;a=summary](https://gerrit.onap.org/r/gitweb?p=sdc/sdc-pubsub.git;a=summary)


### License

Copyright 2018 AT&T, Inc.

Licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0