Criando um Novo Serviço WS-Notification da Versão 7.0

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 desejar compor um serviço JAX-WS WS-Notification com qualidades de serviços (QoS) do serviço da web por meio de conjuntos de políticas ou se desejar aplicar manipuladores JAX-WS no serviço WS-Notification. Esse é o tipo de serviço recomendado para novas implementações. Essa opção do WS-Notification foi disponibilizada no WebSphere Application Server a partir da Versão 7.0.

Antes de Iniciar

Decida que método usar para configurar esses recursos. Você pode criar um novo serviço WS-Notification da Versão 7.0 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 Versão 7.0 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 da Versão 7.0, 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.

Para suportar o Java™ API for XML-based Web Services (JAX-WS) e a composição com o WS-ReliableMessaging, crie seus serviços WS-Notification como aplicativos JAX-WS e, em seguida, use essa tarefa para criar um serviço WS-Notification Versão 7.0, um ou mais pontos de serviço e (opcionalmente) um espaço de nomes de tópico permanente.

Você também pode aplicar listas de manipuladores JAX-WS a pontos de serviço do WS-Notification (para manipulação de chamada de entrada) e serviços WS-Notification (para manipulação de chamada de saída).

Ao criar um serviço do WS-Notification versão 7.0, o assistente cria e implementa um aplicativo fornecedor com base no JAX-WS. Esse aplicativo expõe as interfaces de serviço da Web do WS-Notification para cada uma das três funções de serviço do WS-Notification:
  • Intermediário de notificação
  • Gerenciador de assinaturas
  • Gerenciador de registro do publicador

Procedimento

  1. Inicie o console administrativo.
  2. Navegue para Integração de serviços -> WS-Notification -> Serviços ou Integração de serviços -> Barramentos -> bus_name -> [Serviços] Serviços de Notificação do WS. É exibido o formulário Serviços WS-Notification [Coleta].
  3. 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].
  4. Etapa 1: Configurar nome, descrição, barramento de integração de serviços e definições de namespace de tópico dinâmico.
    1. 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.

    2. 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.
    3. Selecione ou cancele a seleção da opção Requer Registro.

    4. Selecione um barramento de integração de serviços na lista suspensa.
    5. Clique em Avançar.
  5. Etapa 2: Selecionar tipo de serviço WS-Notification.

    Selecione Versão 7.0 como o tipo de serviço que você deseja criar.

  6. 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.

    1. Opcional: Escolha uma lista de manipuladores JAX-WS.

      Uma lista de manipuladores define os manipuladores que são aplicados ao fazer chamadas de serviço da web de saída, por exemplo, ao monitorar notificação de evento de saída (em resposta a uma operação de assinatura) e ao controlar os publicadores baseados em demanda (subscribe, pause e resume). Para obter informações adicionais sobre listas de manipuladores, consulte Configurando Manipuladores JAX-WS.

    2. Ative ou limpe a opção Consultar WSDL.
      Indica se o serviço do WS-Notification da Versão 7.0 consulta o WSDL de outros serviços da Web do WS-Notification ao interagir com eles. Por padrão, esta opção está ativada. Ao desmarcar esta opção, é possível melhorar o desempenho evitando pesadas consultas WSDL. Entretanto, você deverá observar as seguintes considerações quando a consulta do WSDL não estiver ativada:
      • O WS-Notification tenta descobrir informações de ligações (que normalmente são descobertas através de WSDL) usando outros meios. O WS-Notification utilize a versão SOAP associada ao ponto de serviço do WS-Notification em que as assinaturas foram feitas (por outros serviços da Web) ou onde as assinaturas administradas foram criadas (por um administrador).
      • Há algumas circunstâncias nas quais o WS-Notification talvez não consiga determinar as informações sobre ligação. Isto pode acontecer ao limpar as assinaturas onde o ponto de serviço associado foi excluído e as informações de configuração não estão mais disponíveis. Sob estas circunstâncias o WS-Notification realiza um "melhor palpite" sobre as informações sobre ligação a serem utilizadas para limpar as assinaturas.
      • Não há nenhum cenário em que informações incorretas sobre ligação sejam utilizadas. Ou seja, um assinante assina para usar uma ligação SOAP particular, em nome de uma NotificationConsumer que espera notificações através de uma ligação SOAP diferente.
    3. 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.

    4. Clique em Avançar.
  7. 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.

    1. 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.

    2. 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 utilizada para acessar o ponto de serviço. Em um sistema de único servidor, existe apenas um membro do barramento na lista.

    3. Selecione as configurações de transporte do novo ponto de serviço.
      Ponto de serviço acessado por meio do proxy HTTP
      Se o ponto de serviço for acessado por meio de um proxy, selecione a caixa de seleção e digite a raiz da URL do endereço de terminal visível externamente para serviços da Web acessados por meio desse terminal.
      A URL para o proxy é usada para preencher os campos de endereço de terminal WSDL quando publicar arquivos WSDL em um arquivo compactado.
      Versão SOAP
      Selecione a versão do SOAP que é suportada pelo ponto de serviço. Isso afeta a definição WSDL que é exposta pelo serviço da Web.
    4. Opcional: Selecione as configurações da lista de manipuladores JAX-WS para o novo ponto de serviço.
      Lista de manipuladores JAX-WS do NotificationBroker

      Lista de manipuladores JAX-WS do SubscriptionManager

      Lista de manipuladores JAX-WS do PublisherRegistrationManager

    5. 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.
    6. Opcional: Para criar outro ponto de serviço, repita as subetapas anteriores.
    7. 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.
  8. Opcional: Etapa 5: Criar namespaces de tópico permanente.

    Para obter informações adicionais, consulte Espaço de Nomes 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.

    1. Selecione Sim para criar um novo namespace do tópico permanente e, em seguida, clique em Avançar.
    2. 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.

    3. 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:
      • Selecione o nome de um espaço de tópico de barramento existente.
      • Selecione a opção para Criar um Novo Espaço de Tópico e, então, digite o nome do novo espaço de tópico.
    4. 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.

    5. Clique em Avançar.

      O novo espaço de nomes de tópico permanente é incluído em uma lista de espaços de nomes de tópico permanente para este serviço WS-Notification da Versão 7.0 e é perguntado se você deseja criar outro espaço de nomes de tópico permanente (o padrão é Sim).

    6. Opcional: Para criar outro namespace de tópico permanente, repita as subetapas anteriores.
    7. Quando você tiver concluído a criação de espaços de nomes de tópico permanente para este serviço de WS-Notification da Versão 7.0, selecione Não, para a opção de criar outro espaço de nomes de tópico permanente, em seguida, clique em Avançar.
  9. 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 da Versão 7.0 será atualizada para incluir o novo serviço WS-Notification da Versão 7.0. Caso contrário, uma mensagem de erro é exibida.
  10. Salve suas alterações na configuração principal.
  11. 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 e aplicar documentos de espaço de nomes do tópico em espaços de nomes de tópicos permanentes), consulte Modificando um Serviço do WS-Notification da Versão 7.0.

Para empreender as tarefas de configuração avançadas para o ponto de serviço do WS-Notification criado como parte desta tarefa (por exemplo, incluindo assinantes administrados, publicando arquivos WSDL em um arquivo compactado e configurando o aplicativo corporativo associado a este ponto de serviço), consulte Modificando um Ponto de Serviço do WS-Notification da Versão 7.0.

Para configurar esse serviço ou ponto de serviço WS-Notification com as qualidades de serviço (QoS) de serviço da Web, como confiabilidade ou segurança, consulte Configurando um Serviço WS-Notification da Versão 7.0 com QoS dos Serviços da Web.


Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tjwsn_wsnserv_new_v7
Nome do arquivo: tjwsn_wsnserv_new_v7.html