KDispatcher - Eventbus leve e conveniente para o uso diário

Olá queridos colegas, amantes de Kotlin

No meu primeiro artigo, quero falar sobre uma biblioteca útil que escrevi exclusivamente no Kotlin e a apoio e desenvolvo ativamente. É chamado - KDispatcher. Projetado para enviar e assinar notificações entre seus componentes de código. Você pode usá-lo em qualquer projeto kotlin, seja Android, Frontend, Backend ou KotlinNative.

Principais benefícios:

• Assinatura de evento rápida e fácil
• A prioridade de chamadas para funções de ouvinte (retornos de chamada)
• Usando as funções de extensão kotlin
• Segurança da linha

Portanto, para usar esta biblioteca em seu projeto, você precisa conectá-la através do Gradle:

implementation 'com.rasalexman.kdispatcher:kdispatcher:xyz' 

ou Maven:

 <dependency> <groupId>com.rasalexman.kdispatcher</groupId> <artifactId>kdispatcher</artifactId> <version>xyz</version> <type>pom</type> </dependency> 

Depois disso, você pode usar duas maneiras:

1) Chame o método de objeto:

 KDispatcher.subscribe(eventName, ::listenerFunction, priority) 

onde eventName é o nome da string do seu evento que você deseja assinar; :: listenerFunction - uma função que usa um único parâmetro do tipo Notification e pode ter o formato

 (Notification<T>)->Unit 

contendo o objeto dos seus dados (data: T) e o nome do evento (eventName: String). O último parâmetro opcional, priority: Int é uma variável numérica para classificar a chamada de suas funções de retorno de chamada, pois você pode assinar vários ouvintes para um evento de uma vez. Para passar um evento, você precisa chamar o método:

 KDispatcher.call(eventName:String, data:Any) 

Você também pode cancelar a inscrição de ouvir eventos quando não precisar mais deles, usando o método:

 KDispatcher.unsubscribe(eventName:String, ::listenerFunction) 

Tudo é muito simples.

2) A segunda maneira é implementar suas classes (a palavra certamente não é muito boa, mas espero que todos entendam) a partir da interface do IKDispatcher e você pode obter toda a funcionalidade da estrutura de eventos, e ainda mais, devido às funções de extensão kotlin. Abaixo, quero dar um pequeno exemplo de uso dessa interface:

 class MainActivity : AppCompatActivity(), IKDispatcher { private val eventListenerOne = this::eventOneHandler //... override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) scopeOperation() } private fun scopeOperation() { //       subscribe(EVENT_CALL_ONE, 3, eventListenerOne) subscribe(EVENT_CALL_ONE, 1, ::eventListenerTwo) subscribe(EVENT_CALL_ONE, 2, MyClass::eventListenerFour) //   call(EVENT_CALL_ONE, "FIRST CALL FROM KDISPATCHER") /** *      lambda- */ val eventName = "LAMBDA_EVENT" subscribe<String>(eventName) { notification -> println("LAMBDA_EVENT HAS FIRED with event name ${notification.eventName} and data ${notification.data}") unsubscribe(notification.eventName) } call(eventName, "FIRST CALL CUSTOM LABDA EVENT") } fun eventOneHandler(notification:Notification<Any>) { println("eventOneHandler MY TEST IS COMING event = ${notification.eventName} AND data = ${notification.data}") } } 

Você pode encontrar um exemplo completo de uso no link
KDispatcher no github

Obrigado por ler até o fim. Eu ficaria muito feliz em receber feedback e assistência no desenvolvimento do projeto.

Desfrute de codificação na incrível linguagem KOTLIN!