comando modifyJAXWSHandler
Use o comando modifyJAXWSHandler para modificar uma configuração de manipulador do Java™ API for XML-based Web Services (JAX-WS) para um manipulador que é usado, como parte de uma lista, com os serviços do WS-Notification da Versão 7.0.
Você pode modificar uma configuração do manipulador JAX-WS usando a ferramenta wsadmin, como descrito neste tópico, ou usando o console administrativo, como descrito em Modificando uma Configuração de Manipulador JAX-WS Existente.
Se modificar uma classe do manipulador, mas não alterar o nome da classe, você não terá de modificar a configuração do manipulador, conforme descrito neste tópico. É necessário apenas parar e reiniciar os servidores ou clusters que hospedam os serviços ou os pontos de serviços que esse manipulador monitora.
Para executar o comando, utilize o objeto AdminTask do cliente de script wsadmin.
O cliente de script wsadmin é executado do Qshell.
Para obter informações adicionais, consulte Configurando o Qshell para Executar Scripts do WebSphere Usando o Script wsadmin.
- Para obter uma lista dos comandos de WS-Notification disponíveis, além
de uma breve descrição de cada comando, digite o seguinte comando no prompt wsadmin:
print AdminTask.help('WSNotificationCommands')
- Para obter ajuda de visão geral sobre um determinado comando, digite o seguinte comando no prompt wsadmin:
print AdminTask.help('command_name')
AdminConfig.save()
Objetivo
Um manipulador do JAX-WS (Java API for XML-based Web Services) é uma classe Java que executa uma variedade de tarefas de manipulação. Por exemplo, log de mensagens ou transformação de seu conteúdo ou encerramento de um pedido que chega. Este comando modifica uma configuração do manipulador JAX-WS que pode ser usada, como parte de uma lista de manipuladores, com os serviços WS-Notification Versão 7.0.
O objeto de configuração associa um nome exclusivo (o parâmetro name) com uma classe Java (o parâmetro className) que se refere à implementação do manipulador JAX-WS.
Objeto de Destino
Um objeto de configuração do manipulador JAX-WS.
Parâmetros necessários
- -name
- O nome do objeto de configuração do manipulador JAX-WS.Este nome deve ser exclusivo no escopo da célula e deve obedecer às seguintes regras de sintaxe:
- Não deve iniciar com "." (um ponto).
- Não deve iniciar ou terminar com um espaço.
- Não deve conter nenhum dos seguintes caracteres: \ / , # $ @ : ; " * ? < > | = + & % '
- Nota: Quando você altera um nome de manipulador, o sistema consulta todos os objetos que se referem a ele e atualiza o nome.
- -className
- O nome da classe do manipulador JAX-WS que este objeto de configuração representa. Esse nome deve ser um nome de classe java totalmente qualificado. Por exemplo, com.ibm.jaxws.handler.TestHandler.
- Se você alterar o nome da classe, você também deve tornar a nova classe manipuladora disponível para o
servidor ou cluster que hospeda os pontos de serviços WS-Notification (para manipulação de chamada de entrada) ou serviços
WS-Notification (para manipulação de chamada de saída) que você deseja monitorar, conforme detalhado em
Carregando Classes de Manipuladores JAX-WS.Nota: É possível configurar várias instâncias de um manipulador criando cada instância com um nome de manipulador diferente e apontando para a mesma classe de manipuladores.
Parâmetros Condicionais
Nenhuma.
Parâmetros Opcionais
- -description
- Uma descrição do controlador JAX-WS.
Por exemplo:
- Utilizando Jython:
AdminTask.modifyJAXWSHandler(JAXWSHandler, ["-name", "newHandler1", "-className", "newHandlerClass", "-description", "newDesc"] )
- Utilizando Jacl:
$AdminTask modifyJAXWSHandler JAXWSHandler {-name newHandler1 -className newHandlerClass -description newDesc}