https://github.com/skrusty/asternet-ari-middleware-queue
A queue middlware implementation for AsterNET.ARI
https://github.com/skrusty/asternet-ari-middleware-queue
Last synced: about 1 month ago
JSON representation
A queue middlware implementation for AsterNET.ARI
- Host: GitHub
- URL: https://github.com/skrusty/asternet-ari-middleware-queue
- Owner: skrusty
- Created: 2015-01-13T13:32:27.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2017-11-16T13:59:09.000Z (over 8 years ago)
- Last Synced: 2026-01-14T08:32:58.035Z (6 months ago)
- Language: C#
- Size: 667 KB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://travis-ci.org/skrusty/AsterNET-ARI-Middleware-Queue)
# AsterNET-ARI-Middleware-Queue
A queue middleware implementation for AsterNET.ARI allowing you to use AsterNET.ARI with Ari Proxies like go-ari-proxy.
## Overview
Middleware.Queue allows one or many ARI proxies to communicate with your AsterNET.ARI application. This provides both High Availability and Load Balancing.
The Middleware Queue provides it's own client AriBrokerClient which allows you to connect to a queue implementation, currently RabbitMq is supported. The AriBrokerClient raises an event when a new Dialogue is created by the proxy and returns you a handler (BrokerSession, implements IAriClient) that allows you to talk back to the originating proxy and receive Stasis events.
### Communications Overview
.png?dl=1)
## Ari Proxies
Middleware.Queue has been tested with [go-ari-proxy](https://github.com/nvisibleinc/go-ari-proxy).
## AriClientBroker
The AriClientBroker allows you to establish a connection with a queue provider (e.g. RabbitMq) and receive new dialogues. When a new dialogue is received, AriBrokerClient establishes the requires sub queues or topics to handle the new dialogue. It rases the OnNewDialogue event and passes an instance of BrokerSession (which implements IAriClient).
```c#
var ari = new AriBrokerClient("queue-name",
new RabbitMq("amqp://", new RabbitMqOptions()
{
AutoDelete = false,
Durable = true,
Exclusive = false
}));
// Hook into AriOnNewDialogue event
ari.OnNewDialogue += AriOnNewDialogue;
// Connect
ari.Connect();
```
## Dialogues
A dialogue encapsulates all the communications required for an ARI Application and a proxy to communicate. Each dialogue includes an event queue and a request and response queue. These are exposed as an implementation of IAriClient.
```c#
private static void AriOnNewDialogue(object sender, BrokerSession e)
{
Console.WriteLine("New Dialogue Started: {0}", e.DialogueId);
// A new application dialogue has been raised!
// Events are now directly tied to a dialogue via the BrokerSession
e.OnStasisStartEvent += E_OnStasisStartEvent;
e.OnStasisEndEvent += E_OnStasisEndEvent;
}
```
## Work as Normal
```c#
private static void E_OnStasisStartEvent(IAriClient sender, StasisStartEvent e)
{
// sender if BrokerSession which implements IAriClient
sender.Channels.Answer(e.Channel.Id);
sender.Channels.Play(e.Channel.Id, "sound:demo-congrats");
}
```