Exibir código-fonte para Criando Stubs do Axis2 para WS da SEFAZ

Esta página foi criada para registrar como o Axis2 foi utilizado neste módulo, suas dificuldades e peculiaridades para integrar o projeto.

A versão utilizada foi a v1.8.2. Tanto para gerar as classes dos Stubs quando nas dependências do projeto.

= Gerando os Stubs = 

A geração dos Stubs foi feita com os binários do Axis2, fora do Eclipse. Para isso foram realizados os seguintes passos:


== Baixar o Axis2 ==

Baixar o pacote Binário no site do Axis2: https://axis.apache.org/axis2/java/core/download.cgi

Se a versão 1.8.2 não for mais a versão corrente, procure a versão já testada e compatibilizada no projeto, caso não esteja procurando migrar a re-compatibilizar o projeto.

Baixe o pacote '''axis2-1.8.2-bin.zip''' e descompacte em alguma pasta de sua preferência.


Para funcionar o Axis2 precisará de duas variáveis de ambiente definidas conforme exemplificado nos comandos a seguir:
<pre>
set JAVA_HOME=c:\Program Files\Java\jdk1.8.0_301
set AXIS2_HOME=c:\axis2-1.8.2
</pre>


== Baixando o WSDL do WS da SEFAZ ==

Para baixar o WSDL da SEFAZ:
* entre no endereço do serviço desejado da SEFAZ; Ex: https://nfe.fazenda.sp.gov.br/ws/cadconsultacadastro4.asmx
* identifique com algum certificado digital válido para ter acesso ao site
* clique no link '''Service Description''' e salve o conteúdo com a extensão '''.wsdl'''.


[[File:Axi2WSClient2.jpg|center]]


{{nota|Extenção WSDL|Por ser gerado pelo sistema o Browser pode sugerir, e até forçar, que o arquivo seja salvo com a extensão '''.asmx'''. Garanta que o arquivo seja salvo com a extensão '''.wsdl''' para que fique coerente.}}


== Gerando os Stubs a Partir do WSDL ==

O Axis gera classes para acessar o WebServices a partir do arquivo '''WSDL''' de descrição do WebService. Para isso siga os seguintes passos:

* Crie uma pasta temporária onde os fontes serão gerados;
* Dentro desta pasta criada execute o comando
<pre>
%AXIS2_HOME%\bin\wsdl2Java -uri <arquivo.wsdl> -d xmlbeans -s
</pre>

O comando gerará na pasta os seguintes conteúdos:
* '''Pasta src''' - Pasta com os arquivos fontes que permitem o acesso ao WebService. Dentro desta pasta, em um ''package'' que dependerá das definições do WSDL, será criado uma classe com o sufixo '''Stub''' para cada serviço exposto no WebService.
* '''Pasta resources''' - Esta pasta contém arquivos necessários para o funcionamento dos '''Stubs''' criados, e precisam acompanhar o package final. O conteúdo de dentro desta pasta deve ser incluído na raiz do package.
* '''Arquivo build.xml''' - Arquivo do ANT para compilar o código. Não utilizado no projeto do BIS.