JarCastingintegracao-correios 
Biblioteca Java para Integração com o Web Service dos Correios (Prazo e Frete)
Índice
Introdução
Este projeto tem como propósito oferecer uma alternativa simples para a execução do web service SOAP provido pela empresa Correios para os recursos de consulta de prazo e preço do frete. O serviço SOAP do Correios não é muito complexo, mas a idéia é abstrair o uso do SOAP para que você possa focar apenas na integração da sua loja virtual com o serviço que precisa.
Configurações
Se quiser utilizar este projeto siga os seguintes passos:
Com o maven:
- Adicione ao seu pom.xml a dependência:
<dependency>
<groupId>com.github.felipecaparelli</groupId>
<artifactId>correios-client</artifactId>
<version>1.0.1</version>
</dependency>
Sem o maven:
- Baixe o projeto
git clone https://github.com/felipecaparelli/integracao-correios.git - Execute o maven
mvn clean install - Copie a biblioteca /integracao-correios/correios-client/target/correios-client-0.0.1-SNAPSHOT.jar para seu diretório WEB-INF/lib, junto com uma tonelada de dependências listadas no final deste arquivo.
Uso básico
O serviço já vem com os dados básicos da pesquisa preenchidos, sendo o serviço padrão utilizado o 'SEDEX Varejo'
CorreiosPrecoPrazo result = new ConsultaCorreios().calcularPrecoPrazo("06053040", "80540220")[0];
System.out.println(String.format("Valor do Frete: %f - Prazo de Entrega: %d dias", result.getPrecoFrete(), result.getPrazoEntrega()));
Deixo claro que o objeto que construo no retorno não possui a mesma interface do objeto retornado pelo serviço do Correios, mas contém todos os dados que eles devolvem. Na realidade, a intenção do objeto que eu retorno é deixar mais claras as informações providas.
Como o foco do projeto é sem um facilitador para programadores Java na integração com o serviço dos Correios, os dados parametrizados e retornados são em geral constituídos de variaveis que sejam coerentes com os tipos necessários (por exemplo, valores monetários que utilizaremos para cálculos são retornados como Double).
Parâmetros Complementares
A API permite parametrizar todos os dados aceitos no web service do Correios, seguindo as mesmas regras da validação do mesmo:
CorreiosPrecoPrazo result = new ConsultaCorreios()
.servicos(CorreiosTipoServico.PAC_VAREJO) //tipo de serviço 'PAC'
.entregarEmMaos(IndicadorSN.SIM) //indicador que define se a entrega deve ser em mãos
.calcularPrecoPrazo("06053040", "80540220")[0];
System.out.println("Preço do Frete: " + result.getPrecoFrete());
System.out.println(String.format("Prazo de Entrega: %d dias", result.getPrazoEntrega()));
Perceba que o retorno é um array de objetos do tipo CorreiosPrecoPrazo, pois o serviço do Correios retorna 1 elemento para cada tipo de serviço consultado. Se você parametrizar mais de um serviço terá múltiplos retornos:
CorreiosPrecoPrazo[] results = new ConsultaCorreios()
.servicos(CorreiosTipoServico.PAC_VAREJO, CorreiosTipoServico.SEDEX_10_VAREJO)
.calcularPrecoPrazo("06053040", "80540220");
for (CorreiosPrecoPrazo result : results) {
System.out.println("Preço do Frete: " + result.getPrecoFrete());
System.out.println(String.format("Prazo de Entrega: %d dias", result.getPrazoEntrega()));
}
Essa é uma versão inicial e tem muito para melhorar. Se tiver interesse em evoluir e implementar os outros serviços disponibilizados pelo Correios fique a vontade para fazer um fork ou colaborar com este projeto ;)
Dependências
Todas as bibliotecas deste projeto estão diretamente ligadas à biblioteca soap-ws, que é utilizada para realizar a chamada SOAP do web service do Correios.
- junit-4.12.jar
- hamcrest-core-1.3.jar
- soap-builder-1.0.0-SNAPSHOT.jar
- soap-common-1.0.0-SNAPSHOT.jar
- wsdl4j-1.6.2.jar
- commons-lang3-3.1.jar
- xmlunit-1.3.jar
- soap-legacy-1.0.0-SNAPSHOT.jar
- xml-apis-1.0.b2.jar
- batik-ext-1.7.jar
- xercesImpl-2.10.0.jar
- xbean-fixed-2.4.0.jar
- xbean_xpath-2.4.0.jar
- xmlbeans-xmlpublic-2.5.0.jar
- stax-api-1.0.1.jar
- jsr173-1.0.jar
- saxon-9.1.0.8.jar
- saxon-dom-9.1.0.8.jar
- wsrf-xbeans-1.0.jar
- XmlSchema-1.4.5.jar
- soap-client-1.0.0-SNAPSHOT.jar
- httpclient-4.2.3.jar
- httpcore-4.2.2.jar
- log4j-1.2.17.jar
- commons-logging-1.1.1.jar
- commons-io-2.3.jar
- commons-codec-1.6.jar
- guava-osgi-11.0.1.jar
- soap-server-1.0.0-SNAPSHOT.jar
- spring-ws-core-2.1.1.RELEASE.jar
- spring-xml-2.1.1.RELEASE.jar
- spring-context-3.1.2.RELEASE.jar
- spring-expression-3.1.2.RELEASE.jar
- spring-asm-3.1.2.RELEASE.jar
- spring-aop-3.1.2.RELEASE.jar
- aopalliance-1.0.jar
- spring-oxm-3.1.2.RELEASE.jar
- commons-lang-2.5.jar
- spring-web-3.1.2.RELEASE.jar
- spring-webmvc-3.1.2.RELEASE.jar
- spring-context-support-3.1.2.RELEASE.jar
- stax-api-1.0-2.jar
- spring-core-3.1.2.RELEASE.jar
- spring-beans-3.1.2.RELEASE.jar
- jetty-embedded-6.1.26.jar
- jetty-6.1.26.jar
- servlet-api-2.5-20081211.jar
- jetty-sslengine-6.1.26.jar
- jsp-api-2.1.jar
- jetty-java5-threadpool-6.1.26.jar
- jetty-util-6.1.26.jar
- slf4j-api-1.6.6.jar
- slf4j-log4j12-1.6.6.jar