Repolode
Submit
dromara

dromara/jquick-curl

A Java library that runs raw curl commands as ordinary Java method calls, so you can paste curl from Postman or browser DevTools without writing HTTP client code.

Open-source alternative to:Postman

View on GitHub
Stars
1,093
Forks
71
Open issues
0
Last commit
5 days ago

What is it?

jquick-curl lets Java developers describe an HTTP request as a curl command and call it like a normal method. You declare the command with an @JCurlCommand annotation on an interface method, or centralize it in an XML file, then create a dynamic proxy with JCurlInvoker.createProxy. Commands are parsed with ANTLR and sent through a pooled transport layer built on OkHttp.

The library covers common curl options such as -X, -H, -d, -F, -o, -b, -c, -u, -L and -x, so a command copied from Postman, Apifox or browser DevTools can usually be pasted in directly. It also supports ${name} and #{name} placeholders resolved at runtime, conditional headers in XML through <if> expressions, and a Netscape-format cookie jar for persisting sessions.

Global timeouts, connection pool size, retries, redirects and interceptors are configured once through the JQuickCurlConfig singleton. The project is part of the JQuick ecosystem and is published to Maven Central with JDK 8+ support.

Key features

  • 01Declare HTTP requests as curl commands with @JCurlCommand or XML.
  • 02Create working clients from interfaces via JCurlInvoker.createProxy.
  • 03Supports -F multipart upload and -o file download.
  • 04Cookie handling with -b, -c and Set-Cookie persistence.
  • 05Global timeouts, connection pool, retries and redirects via JQuickCurlConfig.
  • 06Supports HTTP and SOCKS5 proxies and -k to skip certificate checks.

Use cases

  • Turning API requests copied from Postman or browser DevTools into Java service calls.
  • Organizing many third-party API definitions in XML files separate from Java code.
  • Calling endpoints that require login sessions by persisting cookies to a file.
  • Writing integration tests or batch scripts that run a set of curl commands.

Topics

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

FAQ

What is jquick-curl?
A Java library that runs raw curl commands as ordinary Java method calls, so you can paste curl from Postman or browser DevTools without writing HTTP client code. jquick-curl lets Java developers describe an HTTP request as a curl command and call it like a normal method. You declare the command with an @JCurlCommand annotation on an interface method, or centralize it in an XML file, then create a dynamic proxy with JCurlInvoker.createProxy. Commands are parsed with ANTLR and sent through a pooled transport layer built on OkHttp.
Is jquick-curl free to use? What license does it have?
jquick-curl is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is jquick-curl still maintained?
Actively maintained. The last commit to jquick-curl was on Oct 15, 2026.
What can I use jquick-curl for?
Turning API requests copied from Postman or browser DevTools into Java service calls. Organizing many third-party API definitions in XML files separate from Java code. Calling endpoints that require login sessions by persisting cookies to a file. Writing integration tests or batch scripts that run a set of curl commands.
Where can I get jquick-curl?
The source code and installation instructions are on GitHub: https://github.com/dromara/jquick-curl

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects