Enviar mensagens no Kafka é bastante simples.
Instanciando um Producer
Para configurar, é preciso basicamente apenas 3 parametros:
- BOOTSTRAP_SERVERS: Conjunto de pares IP:PORTA para acessar o cluster. Por exemplo,
kafka-1:9092,kafka-2:9092irá acessar o cluster que contem os duas instânciaskafka-1:9092ekafka-2:9092 - KEY_SERIALIZER_CLASS: É a classe que fará a serialização da Chave. O que é e como é usada a chave, vamos explicar posteriormente. Deve ser uma implementação da interface
org.apache.kafka.common.serialization.Serializer. - VALUE_SERIALIZER_CLASS: É a class que fará a serialização do Valor. Não há mensagem sem um valor. Deve ser uma implementação da interface
org.apache.kafka.common.serialization.Serializer.
Pronto, configurado o Producer, basta criar o objeto ProducerRecord, que irá associar mensagem/chave/tópico, e enviar ela.
No código acima, eu criei um simples cliente que lê todas as mensagens do STDIN e envia para o tópico em questão.
Recomendações
- O envio é assíncrono, verifique se a mensagem foi realmente enviada e tente novamente caso negativo. Normalmente o cliente Kafka já faz algumas tentativas.
- Particione tipos de mensagens por chave, a ordem das entregas de mensagens só é garantida para mensagens com mesma chave.
Conclusão
O envio de mensagens Kafka é simples e descomplicado, mas mesmo assim deve ser feito de forma cuidadosa para se garantir a entrega. Tendo a entrega da mensagem garantida, é certo que teremos o recebimento dela garantido.
Mais informações sobre Chave serão dadas quando formos falar de ordenação.
Referências
Todos os códigos estão no repositório vepo/kafka-articles
