Guia para implementação de WebServices em Container TomCat:
Introdução:
O objetivo deste guia é mostrar – passo a passo – como implementar um webService, com servidor e cliente, funcional, em ambiente TOMCAT.
Um WebService é qualquer aplicação que é dividia em cliente e servidor.
O Servidor: É a parte do sistema responsável pelo processamento dos dados, CRUD e encaminhamento dentro da rede.
O Cliente pode coletar (do usuário ou de outros aplicativos ou bancos), enviar e/ou receber dados do servidor e/ou apresentar os dados enviados pelo servidor (a usuários ou encaminhar a outras aplicações).
Através dos estudos de caso, notou-se que o Container Tomcat serve para publicar páginas e aplicações web, mas não possui muito suporte sobre o processamento dos serviços. Isso porque, pelo menos para JAVA, o TomCat não disponibiliza API’s necessárias para referência nas aplicações. Assim, o princípio do servidor, de processar dados, não pode ser alcançado pela falta de capacidade de interpretação de componentes necessários.
Foi aferido que existem outros Container’s que mostram mais suporte às aplicações, como o GlassFish e o JBossESB. Destes dois, em específico, o GlassFish mostrou-se o mais simples, apresentando pouco mais que as API’s básicas para uma aplicação CRUD convencionais. O Container JBossESB, por sua vez, além de suportar aplicações JAVA, estende-as com API’s específicas para implementação de barramentos web, auxiliando desde o processo de codificação (ampliando a gama de extensões suportadas pelo Eclipse com JbossTools, por exemplo), passando por automações na comunicação entre clientes e servidores chegando a oferecer até um ambiente gráfico mais eficiente para manipulação dos arquivos que participam do webService. Claro que cada facilidade apresentada por estes outros Container’s implica em tamanho maior do Container e demora significativa no tempo de execução das aplicações.
Ambiente de Trabalho:
O TomCat, sozinho, não possui capacidade de implementar webServices.
Por isso, a Apache disponibiliza um complemento chamado Axis.
Executável TomCat:
Zip com a pasta Axis:
Complemento xerces:
1 – Instale o TomCat normalmente;
2 – Descompacte o zip do Axis;
3 – Mova a pasta "Axis", que encontra-se dentro do diretório webapps do arquivo, para a pasta webapps do TomCat;
4 – Descompactar o zip do xerces;
5 – Mover os arquivos “xercesImpl.jar” e “xml-apis.jar” da pasta xerces para a pasta axis\lib\ (do próprio diretório Axis, descompactado anteriormente).
6 – Criar as seguintes variáveis de ambiente:
(Criar as JAVA, caso ainda não estejam criadas, também.)
AXIS_HOME=C:\axis
AXIS_LIB=%AXIS_HOME%\lib
AXISCLASSPATH=%AXIS_LIB%\wsdl4j-1.5.1.jar;%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discovery-0.2.jar;%AXIS_LIB%\commons-logging- 1.0.4.jar;%AXIS_LIB%\jaxrpc.jar;%AXIS_LIB%\saaj.jar;%AXIS_LIB%\log4j-1.2.8.jar;%AXIS_LIB%\xml-apis.jar;%AXIS_LIB%\xercesImpl.jar;%AXIS_LIB%\jaxrpc.jar
7 – Mover o arquivo tools.jar da pasta lib do JAVA para a pasta lib do Axis, dentro do TomCat.
8 - Pode-se testar se o ambiente está ok abrindo o navegador e digitando a seguinte URL:
Se aparecer a tela do servidor Axis, estará tudo ok.
Desenvolvimento do Servidor:
1 - Abra a IDE e crie a seguinte classe JAVA:
/*
* Esta classe foi desenvolvida para ser referencia de teste para implementação de SOA.
* Este é um arquivo de servidor webService.
* Recebe duas variáveis Inteiras do cliente e devolve a soma delas para o cliente
*/
public class Calculadora {
public int somar( int a, int b ) {
return a + b;
}
}
2 – Salve o arquivo do servidor;
3 – Copie o arquivo do seu contexto para a pasta:
C:\Arquivos de programas\Apache Software Foundation\Tomcat 7.0\webapps\axis\
4 – No Browser, digite a seguinte URL:
Aparecerá a seguinte tela:
Clicando no Link, você verá o arquivo WSDL:
Agora, o servidor TomCat/Axis já possui o arquivo de comunicação pronto, aguardando o envio de dados pelo cliente.
1 – Certifique-se que a IDE possui as Lib’s do Axis.
No Eclipse, para incluir as Lib’s, Basta clicar o botão direito sobre a pasta do projeto -> Propriedades.
JavaBuildPaths -> Libraries -> Add External JAR’s
Selecione todas as JAR’s da pasta LIB do Axis -> OK.
2 – Abra a IDE e crie o seguinte arquivo:
import javax.swing.*;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.encoding.XMLType;
import javax.xml.rpc.ParameterMode;
public class Cliente {
public Cliente(){
}
private void invocaServico(String endpointURL, int mensagem1, int mensagem2){
int resposta = 0;
Service service = new Service();
Call call;
try {
call = (Call) service.createCall();
// Atribuindo a URL do Servico
call.setTargetEndpointAddress(new java.net.URL(endpointURL));
// Definindo o metodo a ser invocado
call.setOperationName("somar");
// Definindo os parametros de entrada
call.addParameter("a", XMLType.XSD_INT, ParameterMode.IN);
call.addParameter("b", XMLType.XSD_INT, ParameterMode.IN);
// Definindo o tipo do parametro de retorno
call.setReturnType(org.apache.axis.encoding.XMLType.XSD_INT);
// Invocando o servico
resposta = (Integer) call.invoke(new Object[] {mensagem1, mensagem2});
// Imprimindo a resposta
JOptionPane.showMessageDialog(null, "Servico invocado...\n" + resposta);
} catch (Exception ex) {
ex.printStackTrace();
}
}
public static void main(String args[]){
args= new String[3];
// Aqui é colocado o caminho que está indicado no arquivo WSDL.
args[0]="http://localhost:8080/axis/Calculadora.jws?wsdl";
args[1]="4";
args[2]="4";
String endpointURL = null;
int mensagem1 = 0;
int mensagem2 = 0;
if (args.length < 3){
System.out.println("Sintaxe errada. \nInforme a URL e a Mensagem");
System.out.println("Ex: java ClientHelloWorld http://localhost:8080/axis/HelloWorld.jws \"Ola mundo\"");
System.exit(0);
}
try {
//Obtendo a URL do Servico Web
endpointURL = args[0];
//Obtendo a mensagem 1
args[1] = JOptionPane.showInputDialog("Digite o primeiro fator da Soma:");
mensagem1 = Integer.parseInt(args[1]);
//Obtendo a mensagem 2
args[2] = JOptionPane.showInputDialog("Digite o segundo fator da Soma:");
mensagem2 = Integer.parseInt(args[2]);
} catch (Exception ex) {
ex.printStackTrace();
}
//Criando uma instancia da classe ClientHelloWorld
Cliente client = new Cliente();
//Invocando o metodo 'invocaServico'
client.invocaServico(endpointURL, mensagem1, mensagem2);
}
}
3 – Compile e Rode.
Conclusão
1 – O cliente vai solicitar dois números para o usuário;
2 – O usuário irá fornecer e clicar “OK” para cada número;
3 – O cliente irá estabelecer uma conexão através do caminho do arquivo WSDL;
3 – O cliente irá enviar dois parâmetros para o servidor: número 1 e número 2;
4 – O servidor irá receber os parâmetros, efetuar a soma e devolver o resultado;
5 – O cliente irá receber a resposta e mostrar na tela a resposta para sua solicitação.
Esta é uma aplicação básica, podendo apenas trabalhar com:
1 – Sempre precisamos ter o fonte Java disponível;
2 – A classe não pode fazer parte de nenhum pacote;
3 – Não pode utilizar outros tipos, senão os básicos do Java (primitivos, wrappers e String).
Mesmo assim, este modo de aplicação pode muito bem ser utilizada como base para vários clientes enviando e recebendo informações para um servidor com vários métodos de controle, que reenvia para os clientes corretos as informações necessárias.
