Handlers

Handlers funcionam como agregadores de tópicos. Eles ajudam a criar os canais de publicação de eventos de forma mais organizada e rápida. As políticas de segurança e tentativas automáticas de envio também são definidas por handler.

Para entender como os handlers funcionam, é importante saber como o Events Hub habilita a URL de publicação de eventos:

Para publicar eventos, você precisa criar um caminho (URL) que serve como canal de envio de eventos de um publicador até o Events Hub.

Essa URL é formada por URL base + context + handler + topic:

  1. URL base: é definida pelo Events Hub. Ela inclui o endereço da interface de cada cliente + event-receiver + um código único (hash).

  2. Contexto, handler e tópico: são criados por você. Eles ajudam a organizar e gerenciar diferentes canais de publicação.

    • Tópico é o nível mais específico.

    • Handlers são os agregadores de tópicos, servindo como uma camada lógica de agrupamento.

    • Contextos adicionam mais um nível de agrupamento, permitindo usar o mesmo tópico em diferentes situações.

Listagem de handlers

Na página Handlers, você visualiza todos os handlers existentes. Nela, pode optar por organizá-los em cards, clicando no ícone icon view card ou em tabelas, clicando no ícone icon view table.

handler screen

Filtros

Por padrão, os handlers são listados por ordem de criação. No campo Order by você seleciona a ordenação que deseja entre:

  • Creation (desc): padrão. Lista os handlers da data de criação mais recente para a mais antiga.

  • Creation (asc): Lista os handlers da data de criação mais antiga para a mais recente.

  • Name (desc): Lista os handlers por ordem alfabética, do final para o começo.

  • Name (asc): Lista os handlers por ordem alfabética, do começo para o final.

No campo Keywords, você pode procurar por termos utilizados no nome ou descrição dos handlers.

Detalhes

Se quiser conferir os eventos enviados para os tópicos de um handler, clique no ícone icon event status. Você será direcionado à página Event Status.

Para visualizar detalhes de um handler, clique sobre o nome do card. Você será direcionado para a tela de Overview.
Nela, pode ver e editar as informações do handler em 4 abas:

Topics

Mostra os tópicos agrupados no handler, identificados por nome e descrição.

  • Ao clicar no ícone icon expand você visualiza a lista de contextos cadastrados.

    • Para habilitar/desabilitar, use os botões da coluna Available;

  • Para editar um tópico, clique no ícone icon edit;

  • Para excluir um tópico, clique no ícone icon delete;

  • Para cadastrar um tópico novo, clique no botão ADD TOPIC e informe nome e descrição.

topic handler

Imagine que você quer criar um fluxo de publicação de vários tipos de alerta e testá-lo sem notificar os subscritores. Para fazer isso, pode:

  1. criar um handler chamado "Alerts", com o path /alerts;

  2. cadastrar tópicos agrupados no handler. Por exemplo: /latency para alertas de latência e api-update para alertas de atualização das APIs;

  3. criar um contexto para testes (por exemplo, testing) e habilitá-lo para o tópico que deseja testar, fazendo com que os subscritores não recebam alertas.

    • Para cadastrar subscritores no contexto de teste, você deve vinculá-los ao tópico e habilitá-los somente para o contexto testing.

    • Se não cadastrar nenhum contexto, o Events Hub define "Default" como padrão, e nenhum marcador é adicionado à URL de publicação.
      Portanto, requisições para o tópico latency ou api-update serão enviadas para <url-base>/alerts/latency/<url-base>/alerts/api-update e todos os subscritores ativos nele receberão os eventos.
A maior vantagem de usar contextos diferentes é poder reutilizar as configurações de políticas de segurança e tentativas de entrega definidas no handler, sem precisar criar novos tópicos. E como os endpoints de autorização são definidos por contexto, você pode usar um mock de autorização para testes enquanto mantém a autorização do contexto padrão inalterada.

Policy

Mostra a política de segurança e tentativas de entrega aplicadas ao handler.

  • Ao clicar no ícone icon expand, você vê as definições de tentativa automática, request timeout, códigos de estado que acionam novas tentativas e os interceptores de segurança habilitados para o handler.

  • Clicando no ícone change policy, você pode substituir a política aplicada.

    • A tela Change Policy permite selecionar uma nova política na listagem ou cadastrar através do botão Create Policy.

policy handler
Acesse a documentação de Policies e entenda como funcionam.

Publishers

Lista os publicadores cadastrados para enviar eventos aos tópicos do handler.

  • Para encontrar um publicador específico, use o campo de busca por nome.

  • Clicando no ícone icon expand, você visualiza para quais tópicos e contextos o publisher está habilitado.

    • Na coluna Path, está descrita a URL formada por <context>/<handler>/<topic>.

  • Ao clicar no nome do publicador, você será direcionado à tela de Publishers, onde poderá editá-lo.

publisher handler

Subscribers

Lista os subscritores cadastrados para receber eventos dos tópicos do handler.

  • Para encontrar um subscritor específico, use o campo de busca por nome.

  • Clicando no ícone icon expand, você visualiza para quais tópicos e contextos o subscritor está habilitado para receber eventos.

    • Na coluna Path, está descrita a URL formada por <context>/<handler>/<topic>.

    • Na coluna Subscriber URL está a URL onde os eventos serão publicados.

  • Ao clicar no nome do subscritor, você será direcionado à tela de Subscribers, onde poderá editá-lo.

subscriber handler

No topo das abas, você pode:

  • editar o handler pelo botão EDIT HANDLER;

  • clicar no ícone icon magnifier para visualizar os eventos enviados para os tópicos do handler na tela Event Status;

  • deletar o handler clicando no ícone icon delete.

Veja mais sobre handlers

Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]