https://github.com/evolution-gaming/conhub

Connection hub implementation on top of akka remoting
https://github.com/evolution-gaming/conhub

akka conhub scala

Last synced: about 2 months ago
JSON representation

Connection hub implementation on top of akka remoting

• Host: GitHub
• URL: https://github.com/evolution-gaming/conhub
• Owner: evolution-gaming
• License: mit
• Created: 2018-09-06T21:05:33.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-09-10T11:39:54.000Z (4 months ago)
• Last Synced: 2024-09-10T12:57:18.075Z (4 months ago)
• Topics: akka, conhub, scala
• Language: Scala
• Size: 152 KB
• Stars: 4
• Watchers: 10
• Forks: 4
• Open Issues: 34
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# ConHub

[![Build Status](https://github.com/evolution-gaming/conhub/workflows/CI/badge.svg)](https://github.com/evolution-gaming/conhub/actions?query=workflow%3ACI)

[![Coverage Status](https://coveralls.io/repos/evolution-gaming/conhub/badge.svg)](https://coveralls.io/r/evolution-gaming/conhub)

[![Codacy Badge](https://app.codacy.com/project/badge/Grade/1125a2b6a00548709ba69add410f0988)](https://app.codacy.com/gh/evolution-gaming/conhub/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)

[![Version](https://img.shields.io/badge/version-click-blue)](https://evolution.jfrog.io/artifactory/api/search/latestVersion?g=com.evolutiongaming&a=conhub_2.13&repos=public)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellowgreen.svg)](https://opensource.org/licenses/MIT)

ConHub is a distributed registry used to manage websocket connections on the different nodes of an application.

It enables you to send serializable message to one or many connections hiding away complexity of distributed system. 

In short: user provides `lookup` criteria and a `message`, there after `conHub` does the job routing message to physical instances of a matched connections

## Usage example

```scala

type Connection = ??? // type representing physical connection

final case class Msg(bytes: Array[Byte]) // serializable

final case class Envelope(lookup: LookupById, msg: Msg)

final case class LookupById(id: String)

val conHub: ConHub[String, LookupById, Connection, Envelope] = ???

conHub ! Envelope(LookupById("testId"), Msg(Array(…)))

```

## Setup

```scala

addSbtPlugin("com.evolution" % "sbt-artifactory-plugin" % "0.0.2")

libraryDependencies += "com.evolutiongaming" %% "conhub" % "1.3.0"

```