Axis 2 - Parte 2: Implementação e utilização

Março 2017


Implementação

  • O uso do Axis requer um servidor de aplicativo como o tomCat ou mais precisamente um "servlet container". Então, o primeiro passo consiste em instalar o servidor de aplicativos no qual serão implantados os serviços web.
  • Para iniciar efetivamente com o Axis vamos usar a distribuição binária padrão fornecida pela Apache Software Foundation.
  • Para isso, basta descompactar o arquivo compactado Axis2-1.4-bin.zip para encontrar tudo o que é preciso para executar o Axis.
  • O Axis pode ser executado em modo "standolone" (autônomo) através do arquivo $AXIS2_HOME\bin\axis2server.bat
  • Depois de executar o Axis, podemos consultar a lista de serviços disponíveis em modo "standalone" através do seguinte URL: http://localhost:8080/axis2/services/
  • Para usar o Axis com um servidor de aplicativos basta seguir estes passos:
    • Descompacte a distribuição do Axis 2 a partir do arquivo axis2-1.4-bin.zip.
    • Abra o prompt de comando e digite cd $AXIS2_HOME\axis2-1.4\webapp
    • Instale o Ant 1.6.5 ou versão posterior.
    • Execute o arquivo build.xml com Ant
    • Um arquivo axis2.war será gerado no diretório /dist
    • Coloque o arquivo axis2.war no diretório webapps e reinicie o servidor.
    • O Axis é um aplicativo web desenvolvido no tomCat. O arquivo axis2.war contém todas as bibliotecas necessárias para a criação e implantação dos serviços web. A estrutura do axis2.war se parece com isso:


axis2-web  
META-INF 
WEB-INF 
    classes  
    conf 
        axis2.xml  
    lib 
        activation.jar 
        ... 
        xmlSchema.jar 
    modules 
        modules.list  
        addressing.mar 
        ... 
        soapmonitor.mar 
    services 
        services.list 
        aservice.aar 
        ... 
        version.aar 
    web.xml
    • Para consultar a lista dos serviços utilizados clique no link "Services".

    • O link "validate" é para verificar se todas as bibliotecas necessárias ao Axis existem no aplicativo.
,

Implantação do "Web Service"


Os serviços Web do Axis2 podem ser implantados como arquivo *. aar. Um serviço tem uma estrutura bem definida, como indicado abaixo:
- CatálogoPreço
   - META-INF 
     - services.xml 
   - lib 
   - com 
     - owliance 
       - console 
         - configuração 
           - CatálogoPreço.class

onde CatálogoPreço é o nome do serviço, que deve ser o mesmo indicado no arquivo services.xml. As classes são colocadas diretamente na raiz, com seus pacotes. Eo diretório lib contém os *. jar necessários para executar os serviços. O arquivo services.xml define o serviço e o faz corresponder com a classe Java adequada.


Criação do Web Sservice

O protótipo do próximo projeto mostra como criar um serviço web. Trata-se de um projeto eclipse com a seguinte árvore:
  • A classe associada com o serviço web permite consultar o preço de um produto e atualizá-lo.
  • Neste projeto chamado OwlianceWS está previsto um arquivo build.xml para fazer o "build" (a construção) do projeto, com o utilitário ANT.
  • O arquivo build.xml contém um "target compile.service" para a compilação, um target generate.wsdl para a criação da descrição WSDL associada ao serviço web e um target generate.service, para o encapsulamento do serviço web em um arquivo com a extensão ". aar" reconhecível pela estrutura de implantação dos serviços web Axis2.
  • Para implantar o serviço, basta colocar o arquivo .aar gerado, no diretório

Webservices $TomeCat\ webapps\axis2\WEB-INF\services e reiniciar o servidor de aplicativos.



Tradução feita por Lucia Maurity y Nouira

Veja também

Artigo original publicado por . Tradução feita por pintuda.
Este documento, intitulado 'Axis 2 - Parte 2: Implementação e utilização', está disponível sob a licença Creative Commons. Você pode copiar e/ou modificar o conteúdo desta página com base nas condições estipuladas pela licença. Não se esqueça de creditar o CCM (br.ccm.net) ao utilizar este artigo.