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.