Crie um novo serviço do WS-Notification e os objetos associados que formam a infra-estrutura da configuração do WS-Notification. Use este tipo de serviço se você deseja expor um serviço WS-Notification do JAX-RPC que usa a mesma
tecnologia fornecida no WebSphere Application Server Versão 6.1,
incluindo a capacidade de aplicar manipuladores JAX-RPC para o serviço. Essa opção do WS-Notification foi disponibilizada no WebSphere Application Server a partir da Versão 6.1.
Antes de Iniciar
Certifique-se de que tenha configurado com
êxito um repositório SDO, conforme descrito em Instalando e Configurando o Repositório SDO.
O repositório SDO é utilizado para armazenar
documentos WSDL durante a criação do serviço WS-Notification. Se você não configurar
o repositório, aparecerá uma mensagem de erro quando ao criar o serviço.
Decida que método usar para configurar esses recursos. É possível criar um novo serviço WS-Notification da Versão 6.1 utilizando o console
administrativo conforme descrito nesta tarefa ou utilizando o Comando createWSNService.
Esta tarefa assume que você tenha um barramento de integração de serviço existente
configurado com pelo menos um membro do barramento.
Geralmente, você configura um único serviço do WS-Notification para um barramento de integração de serviço, mas pode configurar mais de um. Para obter informações adicionais, consulte Razões para Criar Vários Serviços WS-Notification em um Barramento.
Definir um serviço WS-Notification em um barramento não é o mesmo que expor uma porta NotificationBroker
(WSDL) para a qual os aplicativos de serviços da Web podem se conectar. Para isso, crie um ou mais
pontos de serviço do WS-Notification, conforme descrito nesta tarefa.
Sobre Esta Tarefa
Um serviço do WS-Notification permite expor alguns ou todos os recursos do sistema de mensagens definidos em um barramento de integração de serviço para utilização por aplicativos do WS-Notification.
Uma lista de manipuladores JAX-RPC e ligações WS-Security define os parâmetros e a política de segurança que são utilizados ao se fazer chamadas de serviço da Web de saída, por exemplo monitorando a notificação de eventos de saída (em resposta a uma operação subscribe) e controlando publicadores baseados em demanda (subscribe, pause e resume).
Ao criar um serviço do WS-Notification versão 6.1, o assistente
configura três serviços de entrada do barramento de integração de serviços para o
serviço do WS-Notification, um para cada uma das três funções do serviço do WS-Notification:
- Intermediário de notificação
- Gerenciador de assinaturas
- Gerenciador de registro do publicador
Estes serviços de entrada são definidos no mesmo barramento de integração de serviços que o serviço do WS-Notification versão 6.1, e cada um destes serviços de entrada faz referência
ao mesmo destino de barramento.
Procedimento
- Inicie o console administrativo.
- Navegue para ou . É exibido o formulário Serviços WS-Notification [Coleta].
- Na área de janela de conteúdo, clique em Novo. O assistente de "Novo
Serviço WS-Notification" é exibido. Para obter informações adicionais sobre as propriedades
configuradas com o assistente, consulte Serviços WS-Notification [Configurações].
- Etapa 1: Configurar nome, descrição, barramento de integração de serviços e definições de namespace de tópico dinâmico.
- Digite o nome escolhido e uma descrição opcional.
O nome faz parte do nó de extremidade no qual o serviço é exposto (ou seja, a URL utilizada para acessar os pontos de serviço do WS-Notification definidos sob o serviço). Para serviços do WS-Notification versão 6.1, o nome do serviço é exclusivo dentro de um barramento. Para serviços do WS-Notification Versão 7.0, o nome do serviço é exclusivo na célula, o que corresponde ao modelo de administração usado para conjuntos de políticas e, portanto, suporta a composição dos serviços do WS-Notification Versão 7.0 com o WS-ReliableMessaging.
- Selecione ou cancele a seleção da opção Ativar Namespaces de Tópicos Dinâmicos?.
Ou seja, se este serviço permite que namespaces de tópicos dinâmicos sejam criados no tempo de execução. Para obter
informações adicionais, consulte
Namespace de Tópico Dinâmico.
Utilize esta opção para controlar rigorosamente os namespaces de tópicos utilizados na conexão com um serviço do WS-Notification específico (por exemplo, para requisitos de segurança ou de auditoria). Se você cancelar a seleção desta opção, os aplicativos que se conectarem ao serviço do WS-Notification e solicitarem tópicos de um namespace de tópico dinâmico deixarão de publicar ou receber mensagens.
Todas as mensagens publicadas para um namespace de tópico dinâmico são inseridas com a configuração de
confiabilidade de mensagem padrão de persistente confiável. Se este valor não for aceitável, crie um namespace de tópico permanente e configure manualmente o atributo como o valor apropriado.
Nota: Os namespaces de tópicos dinâmicos utilizados em um serviço do WS-Notification
específico são suportados por um espaço de tópico do barramento de integração de serviço criado automaticamente
durante a criação do namespace de tópico. A sintaxe de tópicos utilizada neste espaço de tópico
é interna para a implementação do serviço do WS-Notification.
- Selecione ou cancele a seleção da opção Requer Registro.
- Selecione um barramento de integração de serviços na lista suspensa.
- Clique em Avançar.
- Etapa 2: Selecionar tipo de serviço WS-Notification.
Selecione Versão 6.1 como o tipo de serviço
que você deseja criar.
- Etapa 3: Configurar definições de política do manipulador e de serviço da Web.
Estas configurações são aplicadas às notificações de eventos trocadas
com aplicativos clientes do WS-Notification.
- Opcional: Escolha uma lista de manipuladores JAX-RPC.
Para obter informações adicionais sobre listas de manipuladores, consulte
Trabalhando com Rotinas de Tratamento e Clientes JAX-RPC.
- Opcional: Escolha uma configuração e ligações do WS-Security:
- Ligação do pedido de segurança de saída
- Ligação da resposta de segurança de saída
- Configuração de segurança de saída
Para obter informações adicionais sobre os recursos de Segurança de Serviços da Web, consulte Configurando Transmissões Seguras de Mensagens SOAP Usando o WS-Security.
- Digite um nome de espaço de tópico dinâmico.
Ou seja, o nome do espaço do tópico de barramento que é utilizado para hospedar o namespace do tópico ad-hoc, e para hospedar namespaces de tópico dinâmico se eles forem permitidos. Um nome
padrão de WSN_dynamic_this_service_name é oferecido.
- Clique em Avançar.
- Etapa 4: Criar pontos de serviço do WS-Notification.
A existência de um ponto de serviço do WS-Notification em um membro do barramento implica em que um serviço da Web do WS-Notification seja exposto a partir desse membro do barramento e faz com que os terminais de serviço da Web para o broker de notificação, gerenciador de assinaturas e gerenciador de registro do publicador para esse serviço do WS-Notification sejam expostos no membro do barramento ao qual o ponto de serviço está associado. Os aplicativos do WS-Notification utilizam estes nós de extremidade para interagir com o serviço do WS-Notification. Para obter informações adicionais, consulte
Ponto
de Serviço WS-Notification.
- Selecione Sim para criar um novo ponto de serviço de WS-Notification e, em seguida, clique em Avançar.
Um serviço WS-Notification
deve ter pelo menos um ponto de serviço.
- Forneça um nome e (opcional) a descrição para o ponto de serviço do WS-Notification e, na lista suspensa, selecione o membro do barramento no qual o ponto de serviço deve ser configurado e, então, clique em Avançar.
O nome do ponto de serviço forma parte da URL usada para
acessar o ponto de serviço (ou seja, o endereço do serviço da Web que
é exposto no servidor escolhido). Em um
sistema de único servidor, existe apenas um membro do barramento na lista.
- Selecione um aplicativo do listener a ser utilizado para expor o serviço.
Selecione um listener do terminal existente para este membro do barramento ou Crie
um novo listener do terminal existente.
Para obter informações adicionais, consulte Criando uma Nova Configuração de Listener de Nó de Extremidade.
- Clique em Avançar. O novo ponto de serviço
é incluído na lista de pontos de serviço para este serviço WS-Notification.
- Opcional: Para criar outro ponto de serviço,
repita as subetapas anteriores.
- Quando tiver concluído a criação de pontos de serviço para este serviço
de WS-Notification, selecione Não, para a opção de criar outro
ponto de serviço e, em seguida, clique em Avançar.
- Opcional: Etapa 5: Criar namespaces de tópico permanente.
Ao criar um novo namespace de tópico permanente do WS-Notification, você especifica o namespace e associa-o a um dos espaços de tópico do barramento de integração do serviço configurado no barramento no qual o serviço do WS-Notification pai está definido. Não é possível modificar um namespace de tópico permanente após sua criação, exceto aplicar ou remover documentos do namespace de tópico.
Para obter informações adicionais, consulte
Namespace de Tópico Permanente.
- Selecione Sim para criar um novo namespace do
tópico permanente e, em seguida, clique em Avançar.
- Digite um nome para o espaço de nomes de tópico permanente.
Este
é o URI pelo qual os aplicativos do WS-Notification referem-se a tópicos hospedados
por este namespace.
- Associe este novo espaço de nomes de tópico permanente ao espaço de
tópico do barramento de integração de serviços que deseja utilizar para publicar e receber mensagens.
Na lista suspensa do espaço de tópico do barramento de integração de serviços, conclua uma das seguintes ações:
- Escolha o nome de um espaço de tópico do barramento existente.
- Escolha a opção para Criar um novo espaço de tópico, em seguida,
digite um nome para o novo espaço de tópico.
- Selecione, na lista suspensa, a confiabilidade do barramento de integração de serviços (qualidade de serviço)
designada a mensagens publicadas através desse namespace do tópico.
É possível escolher um entre cinco valores, cada
um representando um dos níveis de confiabilidade da mensagem do barramento de integração de serviço. O valor padrão é confiável
persistente, que é o valor utilizado por padrão para mensagens JMS Persistentes.
- Clique em Avançar.
O novo espaço de tópico permanente
é incluído em uma lista de namespaces de tópicos permanentes para este serviço
WS-Notification e é perguntado se você deseja criar outro namespace de tópico
permanente (o padrão é Sim).
- Opcional: Para criar outro namespace de tópico permanente,
repita as subetapas anteriores.
- Quando você tiver concluído a criação de namespaces de tópicos permanentes para
este serviço de WS-Notification, selecione Não, para a opção
de criar outro namespace de tópico permanente, em seguida, clique em Avançar.
- Etapa 6: Resumo.
Verifique se o resumo das ações tomadas pelo assistente está conforme esperado e, em seguida, clique em
Concluir.
Se o processamento for concluído com êxito, a lista de serviços WS-Notification
será atualizada para incluir o novo serviço WS-Notification da Versão 6.1.
Caso contrário, uma mensagem de erro é exibida.
- Salve suas alterações na configuração principal.
- Opcional: Reinicie o servidor se qualquer uma das seguintes condições se aplicar:
- Um novo barramento ou um novo membro do barramento foi criado como parte dessa tarefa.
- Recarregar Configuração não está ativado para o barramento.
O que Fazer Depois
Para assumir tarefas de configurações avançadas para esse serviço do WS-Notification (por exemplo, incluir pontos de serviços adicionais do WS-Notification ou aplicar documentos de namespace do tópico), consulte
Modificando um Serviço do WS-Notification da Versão 6.1.