Não usar o descritor de implementação de serviços da web do JBoss
Essa regra sinaliza qualquer webservices.xml existente para detectar a presença de um arquivo descritor de implementação de serviços da web J2EE para o JBoss. No scanner de origem, a correção rápida produz um script Ant com tarefas específicas do IBM Ant. Essas tarefas geram serviços da web JAX-RPC com base nos descritores de implementação de serviço da web JBoss Java Platform, Enterprise Edition (Java EE). A correção rápida varre os descritores de implementação de serviços da web e produz um script Ant.

Condições para acionamento da regra:
Esta regra detecta a presença de serviços da web JAX-RPC com base nos seguintes critérios:
a. A presença do arquivo descritor de implementação de serviços da web J2EE webservices.xml
b. No scanner de origem ela detecta se o arquivo gerado por IBM Ant ainda não existe na pasta raiz do projeto.

Propriedades da regra:
As propriedades nessa regra afetam apenas a correção rápida. Você deve fornecer os valores corretos para as propriedades da regra. Para mudar os valores das propriedades para essa regra, selecione a regra na janela Configurações do Analisador de software. Em seguida, utilize os campos na guia Propriedades. As propriedades para essa regra são:
  • Nome do script Ant gerado
    Este é o nome do novo script Ant que será gerado. O nome do arquivo deve ser um nome de arquivo válido. O valor não deve incluir nenhuma barra normal ou invertida.  O arquivo gerado estará na pasta-raiz do projeto.
    Valor-padrão: build-ibm-ws.xml

  • Nome da Pasta de Geração:
    Este é o nome da pasta na qual os artefatos gerados são colocados.  O valor não deve incluir nenhuma barra normal ou invertida.  A pasta de geração está na pasta-raiz do projeto.
    Valor-padrão: ibm-ws-gen

Caminho de classe Ant:
O caminho da classe ant é calculado a partir do projeto Eclipse.  É importante verificar se todos os elementos necessários para a compilação estão no caminho da classe do Eclipse.

Serviço JAX-RPC definidos no arquivo webservices.xml
Com base nas informações e nos tipos de serviços definidos no arquivo webservices.xml file, um script Ant é gerado para reproduzir o Serviço JAXRPC.

  • Destinos Ant Gerados:
    O script Ant gerado contém destinos para gerar o arquivo WSDL e o serviço JAX-RPC.
    O destino de geração do WSDL é gerado apenas se a correção rápida não puder localizar o arquivo WSDL conforme definido no elemento <wsdl-file>.
    O destino da geração do WSDL (se for criado) possui o nome: genWSDL_ssss em que ssss é o nome do serviço conforme definido no elemento <webservice-description-name>.
    Os destinos de geração de serviço possuem o nome genService_pppp, em que pppp é o nome da porta conforme definido pelo elemento <port-component-name>.

Tarefas Ant do IBM WebSphere Application Server
O IBM WebSphere(R) Application Server inclui tarefas Ant como java2wsdl e wsdl2java para gerar os artefatos necessários para serviços JAX-RPC.  O script Ant gerado usa essas tarefas para construir o serviço. Informações adicionais sobre essas tarefas podem ser obtidas na documentação do WebSphere Application Server.

Executando o script Ant
Depois que correção rápida produzir o script Ant, visualize o script e inclua customizações adicionais se necessário. Consulte a documentação do WebSphere Application Server para customização adicional das tarefas IBM Ant. Deve-se executar o script usando as ferramentas Ant fornecidas pela IBM que são incluídas com o IBM WebSphere Application Server.  O script IBM Ant pode ser executado a partir de:
  • WAS_HOME\bin\ws_ant.bat nos sistemas operacionais Windows(R)
  • WAS_HOME\bin\ws_ant.sh nos sistemas operacionais UNIX(R)
Exemplo: c:\IBM\AppServer\bin\ws_ant.bat -f c:\eclipse\MyProject\ibm-ws-gen.xml genService_TestService

Quando os destinos Ant são executados, os artefatos produzidos residem na pasta de geração.  É possível inspecionar o código gerado, os descritores de implementação e, em seguida, incluir esses artefatos em seus módulos.