É muito comum para desenvolvedores que trabalham com WebService utilizar a ferramenta soapUI para testar um WebService que utilize o protocolo SOAP. Afinal trata-se de uma ferramenta poderosa e muito útil para testar seus WebServices.
A grosso modo a ferramenta soapUI, funciona enviando um XML via HTTP e recebendo uma resposta também em XML, ou seja, utilizando o WebService em sua forma mais "pura". Normalmente os desenvolvedores utilizam algum framework capaz de converter objetos em XML e XML em objetos, diminuindo consideravelmente a complexibilidade do código. Pois, torna desnecessário escrever os XMLs manualmente.
O que vamos ver neste post é um exemplo de utilização de WebServices em sua forma "pura", ou seja , sem a conversão para objetos, tanto para o envio bem como para recuperação dos dados. O código a seguir apresenta como realizar essa operação.
/**
* @param args
*/
public static void main(String[] args) {
try {
URL url = new URL("[URL DO SERVIÇO SEM (?wsdl): Exemplo: http://localhost/WebServiceTest/DataAtualService"]);
URLConnection urclConnection = url.openConnection();
HttpURLConnection connection = (HttpURLConnection) urclConnection;
connection.setDoOutput(true);
connection.setDoInput(true);
connection.setAllowUserInteraction(true);
connection.setRequestMethod("POST");
/**
* Necessário quando se trata da versão 1.1 do protocolo SOAP
*/
connection.setRequestProperty("SOAPAction", "");
connection.setRequestProperty("Host", "http://localhost");
connection.setRequestProperty("Content-Type", "application/soap+xml; charset=utf-8");
OutputStreamWriter infWebSvcReqWriter = new OutputStreamWriter(connection.getOutputStream());
String infWebSvcRequestMessage = [XML];
infWebSvcReqWriter.write(infWebSvcRequestMessage);
infWebSvcReqWriter.flush();
BufferedReader reader = null;
/**
* Verifica sucesso da requisição, em caso positivo obtém XML esperado em caso negativo
* obtém XML de Erro
*/
if (connection.getResponseCode() == 200) {
reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
} else {
reader = new BufferedReader(new InputStreamReader(connection.getErrorStream()));
}
String line;
String infWebSvcReplyString = "";
while ((line = reader.readLine()) != null) {
infWebSvcReplyString = infWebSvcReplyString.concat(line);
}
infWebSvcReqWriter.close();
reader.close();
connection.disconnect();
/**
* Apresenta no console do Java o XML de recuperado
*/
System.out.println(infWebSvcReplyString);
} catch (Exception e) {
System.out.println(e);
}
}
No código apresentado, a linha 33 String infWebSvcRequestMessage = [XML]; representa que o conteúdo de um XML é passado para a váriavel infWebSvcRequestMessage. Esse conteúdo pode ser escrito diretamente na variável ou pode ser lido através de um arquivo. O XML abaixo representa um exemplo do que poderia ser passado para a variável infWebSvcRequestMessage.
<SOAP-ENV:Envelope xmlns:
SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
</SOAP-ENV:Header/>
<SOAP-ENV:Body>
<m:recuperaDataAtual>
<format>dd/MM/yyyy HH:mm:ss</format>
</m:recuperaDataAtual>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Uma vez que o código é executado com o XML acima, é possível obter um retorno positivo ou negativo da requisição, afinal, trata-se de uma requisição HTTP. Assim o desenvolvedor pode receber um XML com o retorno esperado assim como um XML representando uma ocorrência de erro. Abaixo apresento exemplos de retorno para as duas situações.
<SOAP-ENV:Envelope xmlns:
SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
</SOAP-ENV:Header/>
<SOAP-ENV:Body>
<m:recuperaDataAtualResponse>
<string>14/05/1986 22:37:00</string>
</m:recuperaDataAtualResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
XML com retorno esperado
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
</SOAP-ENV:Header/>
<soap:Body>
<soap:Fault>
<faultcode>1234</faultcode>
<faultstring>Não foi possível chamar o método recuperaDataAtual</faultstring>
</soap:Fault>
</soap:Body>
</soap:Envelope>
