2017-12-21 20:59:34 +00:00
|
|
|
# eventsource
|
|
|
|
|
Server-sent Events (SSE) plugin for Angel.
|
2018-11-08 15:09:32 +00:00
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
In your `pubspec.yaml`:
|
|
|
|
|
|
|
|
|
|
```yaml
|
|
|
|
|
dependencies:
|
|
|
|
|
angel_eventsource: ^1.0.0
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
SSE and WebSockets are somewhat similar in that they allow pushing of events from server
|
|
|
|
|
to client. SSE is not bi-directional, but the same abstractions used for WebSockets can be
|
|
|
|
|
applied to SSE easily.
|
|
|
|
|
|
|
|
|
|
For this reason, the `AngelEventSourcePublisher` class is a simple adapter that
|
|
|
|
|
hands control of SSE requests to an existing `AngelWebSocket` driver.
|
|
|
|
|
|
|
|
|
|
So, using this is pretty straightforward. You can dispatch events
|
|
|
|
|
via WebSocket as per usual, and have them propagated to SSE clients
|
|
|
|
|
as well.
|
|
|
|
|
|
|
|
|
|
```dart
|
|
|
|
|
var app = new Angel();
|
|
|
|
|
var ws = new AngelWebSocket(app);
|
|
|
|
|
var events = new AngelEventSourcePublisher(ws);
|
|
|
|
|
|
|
|
|
|
await app.configure(ws.configureServer);
|
|
|
|
|
|
|
|
|
|
app.all('/ws', ws.handleRequest);
|
|
|
|
|
app.get('/events', events.handleRequest);
|
|
|
|
|
```
|
