Recomendação: Considere a migração para o JAX-WS
Se você já estiver fazendo alterações nos seus serviços da Web JAX-RPC como parte de seus esforços de migração ou modernização, recomendamos fortemente que avalie uma mudança para JAX-WS ( Java API for XML Web Services).

O JAX-WS é o sucessor do JAX-RPC e oferece várias vantagens:

A migração para o JAX-WS agora pode reduzir o débito técnico futuro e alinhar seu aplicativo com os padrões atuais de serviços Web Java.

Para obter orientações sobre a migração do JAX-RPC para o JAX-WS, consulte os cenários de migração de serviços Web: documentação do JAX-RPC para o JAX-WS e do JAXB.

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.

Para gerar serviços da Web JAX-RPC com base em JBoss Java Platform, Enterprise Edition ( Java EE ) descritores de implantação de serviços da Web, a correção automatizada criará um script Ant que usa as tarefas IBM Ant apropriadas. Isso envolve a varredura dos descritores de implantação e a configuração do script Ant para gerar os artefatos necessários.


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 implantação de serviços da Web J2EE webservices.xml
b. O scanner binário detecta que o arquivo gerado IBM Ant ainda não existe na pasta raiz do projeto.

Propriedades da regra:
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 : 
    Esse é 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 para frente ou para trás.  O arquivo gerado estará na pasta raiz do projeto projeto.
    Valor-padrão: build-ibm-ws.xml

  • Nome da Pasta de Geração:
    Esse é o nome da pasta na qual os artefatos gerados são colocados.   O valor não deve incluir barras para frente ou para trás.  A pasta de geração fica na pasta raiz do projeto.
    Valor-padrão: ibm-ws-gen

Caminho de classe Ant:
O caminho da classe de formiga é calculado a partir do projeto Eclipse.  É importante verificar se todos os elementos necessários para a compilação estão no caminho da classe 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 de WSDL só é gerado se você não puder localizar o arquivo WSDL conforme definido no elemento <wsdl-file>.
    O tagret de geração de WSDL (se criado) tem o nome: genWSDL_ssss em que ssss é o nome do serviço conforme definido no elemento <webservice-description-name>.
    Os alvos de geração de serviço têm o nome, genService_pppp, em que pppp é o nome da porta, conforme definido pelo elemento 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 a correção automática gerar o script Ant, revise-o e adicione as personalizações necessárias. Consulte a documentação do site WebSphere Application Server para obter orientação sobre como personalizar as IBM Ant tarefas. Você deve executar o script usando as ferramentas Ant fornecidas por IBM, que estão incluídas em IBM WebSphere Application Server   O script IBM Ant pode ser executado em:
  • 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 do Ant são executados, os artefatos produzidos residem na pasta de geração.  Você pode inspecionar o código gerado código gerado, os descritores de implantação e, em seguida, adicionar esses artefatos aos seus módulos.