Contexts

Para entender o papel dos contextos, é necessário compreender como o Events Hub coordena a publicação e a subscrição a eventos.

Os publicadores de eventos (publishers) enviam requisições ao Events Hub, que depois as distribui para todos os subscritores (subscribers) cadastrados. Para que o caminho correto de distribuição de eventos seja seguido (ou seja, para que cada evento de um publicador seja encaminhado a todos os devidos subscritores e somente a eles), o Events Hub dispõem de tópicos. Cada tópico pode ter inúmeros subscritores. Quando um publicador envia um evento para um determinado tópico, o Events Hub distribui o evento para todos os subscritores vinculados ao tópico.

O canal de publicação de eventos é a URL utilizada pelos publicadores para enviar requisições ao Events Hub. Essa URL é formada por uma série de marcadores de posição: URL base + context + handler + topic.

A URL base é definida pelo Events Hub, que concatena o endereço da interface de cada cliente + event-receiver + uma hash. Já context, handler e topic são criados pelo usuário. O tópico, como já falamos, define a subscrição. É através dele que o Events Hub organiza quem deve receber cada evento. Handlers funcionam como agregadores de tópicos, servindo como uma camada lógica de agrupamento e ajudando na criação e manutenção de tópicos. As políticas de segurança e tentativas automáticas de envio são aplicadas a nível de handlers, então todos os tópicos de um handler utilizam a mesma política.

Por fim, contextos adicionam mais um marcador à URL. Para que um tópico seja disponibilizado a um publicador, ele tem que ser habilitado em pelo menos um contexto. Como isso modifica as URLs de publicação?

Além de criar mais um separador lógico que ajuda a categorizar os canais de publicação, os contextos ajudam porque tornam possível a utilização de um mesmo tópico em cenários diferentes, sem que você necessite duplicar o tópico para definir um controle de publicadores e subscritores. E, além dessa facilidade, o usuário define os endpoints de autorização de publicadores a nível de contexto, o que permite com que o mesmo tópico tenha mais de um servidor de autorização. Veja o exemplo abaixo para compreender isso melhor.

O Events Hub vem com o contexto padrão ("Default") já criado (e ele não pode ser editado). Além disso, é possível criar outros quatro contextos, totalizando um limite de cinco.

Para criar um novo contexto, clique no botão +, que levará para esta tela de registro:

Você deve completar os seguintes campos:

Uma vez registrado, o contexto será exibido na etapa TOPICS de criação/edição de handlers e poderá ser habilitado para qualquer tópico.

Ao clicar sobre o nome de um contexto na tela Contexts, o usuário acessa a página de overview do contexto, como a deste exemplo:

A tela lista todos os tópicos que estão habilitados para publicação no contexto selecionado, exibindo o nome do tópico, do handler, e a descrição do tópico (se houver). É possível pesquisar por tópicos utilizando o campo de busca Keywords, que procura por termos utilizados nos nomes dos tópicos e handlers ou na descrição dos tópicos.

Clicando sobre o nome do handler, o usuário é dirigido à tela de overview do handler, em que é possível editar detalhes do próprio handler ou de seus tópicos.

A tela de overview de cada contexto (acessada ao clicar sobre o nome do contexto na tela Contexts), contém o botão EDIT CONTEXT para editar detalhes do contexto e para excluí-lo.

O contexto padrão ("Default") não pode ser editado ou removido.

Quanto aos outros contextos, se estiverem vinculados a algum tópico, só será possível editar a descrição. Se o contexto não estiver vinculado a nenhum tópico, será possível também editar o nome e o campo Path.

Sé é possível excluir contextos se eles não estiverem associados a nenhum tópico. Se houver tópicos associados, será necessário desabilitar o contexto em cada tópico para então excluí-lo.