https://github.com/tjarkpr/mqttdistribnet
🕸️ MqttDistribNet - A structured distribution network for amqp messaging
https://github.com/tjarkpr/mqttdistribnet
distribution-network golang mqtt
Last synced: about 2 months ago
JSON representation
🕸️ MqttDistribNet - A structured distribution network for amqp messaging
- Host: GitHub
- URL: https://github.com/tjarkpr/mqttdistribnet
- Owner: tjarkpr
- Created: 2024-11-18T00:01:06.000Z (over 1 year ago)
- Default Branch: dev
- Last Pushed: 2024-12-30T19:30:59.000Z (over 1 year ago)
- Last Synced: 2025-03-25T11:14:15.313Z (about 1 year ago)
- Topics: distribution-network, golang, mqtt
- Language: Go
- Homepage:
- Size: 51.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## *🕸️ MqttDistribNet* - A structured distribution network for amqp messaging
The MqttDistribNet module consist of two concepts, to ease the usage of amqp brokers:
- **Dynamic Infrastructure Management**
To simplify the configuration of topics and queues and binding them in a logical path,
we introduced an IDistributionNetworkManager and IRemoteDistributionNetworkManager.
While the IDistributionNetworkManager is the infrastructure management server, the IRemoteDistributionNetworkManager
is used by the client to get information about the remote managed infrastructure.
- **Simple Message Distribution**
Based on Request/Response and Publish/Subscribe Patterns we created Handler, Consumer and Clients to easily
configure the wanted behaviour behind queues and reach them by their configured message type.
### 1. Usage:
```go
import (
mqttdistribnet "github.com/tjarkpr/mqttdistribnet/pkg"
amqp "github.com/rabbitmq/amqp091-go"
)
```
#### 1.1. DistributionNetworkManager
```go
connection, err := amqp.Dial(url)
manager, err := mqttdistribnet.MakeIDistributionNetworkManager(connection, "")
logs, err := manager.Start(&ctx)
```
#### 1.2. Distribution & Consumption
```go
connection, err := amqp.Dial(url)
remote, err := mqttdistribnet.MakeIRemoteDistributionNetworkManager(connection, "")
```
```go
remote.Register(reflect.TypeFor[mqttdistribnet.Envelope[TestRequest]](), "L1.L2.L3.L4.*")
```
```go
err = mqttdistribnet.MakeRequestHandler[mqttdistribnet.Envelope[TestRequest], mqttdistribnet.Envelope[TestResponse]](
remote,
func(request mqttdistribnet.Envelope[TestRequest]) (mqttdistribnet.Envelope[TestResponse], error) {
t.Log("Request: " + request.ToString())
return mqttdistribnet.Envelope[TestResponse]{
MessageId: uuid.New(),
Timestamp: time.Now(),
Payload: TestResponse{TestResProperty: "Test"},
}, nil
}, &ctx)
```
```go
request := &mqttdistribnet.Envelope[TestRequest]{
MessageId: uuid.New(),
Timestamp: time.Now(),
Payload: TestRequest{TestReqProperty: "Test"},
}
clients, err := mqttdistribnet.MakeRequestClient[mqttdistribnet.Envelope[TestRequest], mqttdistribnet.Envelope[TestResponse]](remote)
response, err := slices.Collect(maps.Values(clients))[0].Send(request)
```