Repolode
Enviar
dromara

dromara/jquick-curl

Biblioteca Java que executa comandos curl diretamente como chamadas de métodos, permitindo colar comandos do Postman ou das ferramentas de desenvolvedor do navegador sem escrever código de cliente HTTP.

Alternativa open source a:Postman

Ver no GitHub
Estrelas
1,093
Forks
71
Issues abertas
0
Último commit
há 5 dias

O que é?

jquick-curl permite que desenvolvedores Java descrevam uma requisição HTTP como um comando curl e o chamem como um método normal. Você declara o comando com a anotação @JCurlCommand em um método de interface ou o centraliza em um arquivo XML; depois, cria um proxy dinâmico com JCurlInvoker.createProxy. Os comandos são analisados com ANTLR e enviados por uma camada de transporte com pool, baseada em OkHttp.

A biblioteca abrange opções comuns do curl, como -X, -H, -d, -F, -o, -b, -c, -u, -L e -x. Assim, em geral, basta colar diretamente um comando copiado do Postman, Apifox ou das ferramentas de desenvolvedor do navegador. Ela também oferece suporte a placeholders ${name} e #{name}, resolvidos em tempo de execução, a cabeçalhos condicionais em XML por meio de expressões <if> e a um cookie jar no formato Netscape para persistir sessões.

Timeouts globais, tamanho do pool de conexões, novas tentativas, redirecionamentos e interceptors são configurados uma única vez pelo singleton JQuickCurlConfig. O projeto faz parte do ecossistema JQuick e é publicado no Maven Central, com suporte ao JDK 8 ou superior.

Recursos principais

  • 01Declare requisições HTTP como comandos curl usando @JCurlCommand ou XML.
  • 02Crie clientes funcionais a partir de interfaces com JCurlInvoker.createProxy.
  • 03Suporte a uploads multipart com -F e downloads de arquivos com -o.
  • 04Gerenciamento de cookies com -b, -c e persistência de Set-Cookie.
  • 05Configure timeouts globais, pool de conexões, novas tentativas e redirecionamentos por meio de JQuickCurlConfig.
  • 06Suporte a proxies HTTP e SOCKS5 e à opção -k para ignorar verificações de certificado.

Casos de uso

  • Transformar requisições de API copiadas do Postman ou das ferramentas de desenvolvedor do navegador em chamadas de serviços Java.
  • Organizar definições de várias APIs de terceiros em arquivos XML separados do código Java.
  • Chamar endpoints que exigem sessões autenticadas persistindo cookies em um arquivo.
  • Escrever testes de integração ou scripts em lote que executam uma série de comandos curl.

Tópicos

#http-client#curl#java#rest-api#annotation#okhttp#cookie

Perguntas frequentes

O que é jquick-curl?
Biblioteca Java que executa comandos curl diretamente como chamadas de métodos, permitindo colar comandos do Postman ou das ferramentas de desenvolvedor do navegador sem escrever código de cliente HTTP. jquick-curl permite que desenvolvedores Java descrevam uma requisição HTTP como um comando curl e o chamem como um método normal. Você declara o comando com a anotação @JCurlCommand em um método de interface ou o centraliza em um arquivo XML; depois, cria um proxy dinâmico com JCurlInvoker.createProxy. Os comandos são analisados com ANTLR e enviados por uma camada de transporte com pool, baseada em OkHttp.
jquick-curl é gratuito? Qual é a licença?
jquick-curl é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
jquick-curl ainda é mantido?
Manutenção ativa. O último commit de jquick-curl foi em 15 de out. de 2026.
Para que posso usar jquick-curl?
Transformar requisições de API copiadas do Postman ou das ferramentas de desenvolvedor do navegador em chamadas de serviços Java. Organizar definições de várias APIs de terceiros em arquivos XML separados do código Java. Chamar endpoints que exigem sessões autenticadas persistindo cookies em um arquivo. Escrever testes de integração ou scripts em lote que executam uma série de comandos curl.
Onde consigo jquick-curl?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/dromara/jquick-curl

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados