告别手写 HTTP 模板！JQuick-Curl：直接把 curl 命令跑在 Java 中
项目地址：https://github.com/paohaijiao/jquick-curl
Maven坐标
<dependency>
<groupId>io.github.paohaijiao</groupId>
<artifactId>jquick-curl</artifactId>
<version>2.1.0</version>
</dependency>
前言
做 Java 后端这几年，大多数人都写过类似代码：封装 RestTemplate，拼 URL、拼 Header、拼 Body，再处理响应，再写一层工具类，最后业务代码里还得继续做对象转换。尤其是接第三方接口时，产品经理、测试、前端、运维给你的通常不是 Java 代码，而是一条现成的 curl 命令。问题来了：你明明已经有一条可用 curl，为什么还要手写一遍 java http 客户端逻辑？
这正是 JQuick-Curl 的价值所在。它解决的不是“Java 能不能发 HTTP 请求”，而是“怎么把 curl 转 java、怎么把第三方接口调用这件事做得更轻、更快、更贴近真实协作流程”。对于熟悉 RestTemplate、OkHttp 的开发者来说，JQuick-Curl 更像是一种新的请求表达方式：直接写 curl，让 Java 执行。
如果你经常遇到这些痛点：
- 接口文档给的是 curl，Java 要重复翻译
- 第三方接口调用很多，重复模板代码太多
- 调试时 curl 能通，Java 代码却不一致
- 项目里既有 java curl 执行诉求，又不想依赖 shell 调用系统 curl
那么 JQuick-Curl 很适合进入你的工具箱。
正文
为什么说“直接把 curl 命令跑在 Java 中”很有价值
这里的核心不是简单字符串转发。JQuick-Curl 的思路是：在 Java 里解析 curl 命令，然后用框架内部执行器发出真正的 HTTP 请求。也就是说，它不是去 Runtime.exec("curl ...")，也不是依赖系统环境中的 curl 命令，而是把 curl 当成一种请求描述语言。
这样做有几个直接收益。
第一，协作更顺。测试同学给一条 curl，后端几乎可以原样放进代码里。第二，调试更准。你线上联调时用的 curl 和代码里跑的 curl 保持一致，不容易出现“文档、调试、代码三套标准”。第三，接入更快。特别是第三方接口调用、临时对接、灰度验证时，不必先设计一堆请求对象。
JQuick-Curl 和传统 java http 客户端的关系
很多人会误解：是不是用了 JQuick-Curl 就完全替代 RestTemplate、OkHttp？其实不是。JQuick-Curl 更像是建立在 Java HTTP 能力之上的“命令式描述层”。
- RestTemplate 适合 Spring 老项目里统一模板调用
- OkHttp 适合精细控制请求细节
- OpenFeign 适合服务间声明式调用
- JQuick-Curl 适合 curl 转 java、第三方接口调用、调试命令直接落地
所以它不是要跟所有框架对立，而是在“curl 原生命令复用”这个维度上提供更高效率。
它解决的是哪一类真实问题
最典型的场景就是第三方接口调用。你拿到一份支付、短信、物流、数据平台接口说明，往往先在本地 curl 一把确认能否调通。传统流程是：curl 通了，再手写 Java；JQuick-Curl 的流程是：curl 通了，直接放进 Java 里执行。
另一个很适合的场景是接口调试和短周期需求。很多项目中的外部 HTTP 调用并不值得专门抽象出复杂客户端层，尤其是一次性、少量、高变更的业务接口。这个时候，JQuick-Curl 的轻量表达会明显减少样板代码。
JQuick-Curl 的核心能力
从当前项目实现和测试来看，JQuick-Curl 主要能力包括：
- 解析 curl 命令
- 支持 GET、POST、PUT、PATCH、DELETE、HEAD、OPTIONS、TRACE
- 支持
-H、-d、-F、-u、-L、--output等常见选项 - 支持注解模式和 XML 配置模式
- 支持变量替换
- 支持文件上传下载
- 支持动态代理调用
- 支持批量执行与拦截器扩展
这意味着它不只是一个 Demo 工具，而是已经具备一定工程化能力的 java http 客户端框架。
实战代码块
先看一个最小示例，感受“curl 转 java”到底有多直接。
import com.github.paohaijiao.anno.JCurlCommand;
import com.github.paohaijiao.domain.req.JQuickCurlReq;
import com.github.paohaijiao.executor.JCurlInvoker;
public interface HelloApi {
@JCurlCommand("curl -X GET https://httpbin.org/get")
String hello(JQuickCurlReq request);
static void main(String[] args) throws Exception {
HelloApi api = JCurlInvoker.createProxy(HelloApi.class);
String result = api.hello(new JQuickCurlReq());
System.out.println(result);
}
}
再看一个更接近业务的例子，带 Header 和请求体：
import com.github.paohaijiao.anno.JCurlCommand;
import com.github.paohaijiao.domain.req.JQuickCurlReq;
import com.github.paohaijiao.executor.JCurlInvoker;
public interface UserApi {
@JCurlCommand("curl -X POST https://api.example.com/users -H 'Content-Type: application/json' -d '{\"name\":\"Ada\"}'")
String createUser(JQuickCurlReq request);
static void main(String[] args) throws Exception {
UserApi api = JCurlInvoker.createProxy(UserApi.class);
String result = api.createUser(new JQuickCurlReq());
System.out.println(result);
}
}
这类写法最大的优势就是：curl 本身就是文档、调试命令和执行逻辑。
注意点 / 踩坑提示
1. 不要把它理解成执行系统 shell curl
JQuick-Curl 是解析 curl 字符串，不是依赖操作系统上安装 curl。这个区别非常关键。
2. 不是所有 curl 参数都等价支持
项目目前支持的是解析器和测试用例已覆盖的那部分格式，比如 -X、-H、-d、-F、-u、--output 等。遇到偏门参数时，要先验证。
3. 复杂请求先用最小 curl 跑通
建议先把 curl 命令在终端或接口工具中验证，再放入 @JCurlCommand。这样最稳。
4. 第三方接口调用时注意密钥管理
用户名、密码、Token 不要直接硬编码在命令里。JQuick-Curl 支持变量替换，后面系列文章会展开讲。
总结
如果你已经熟悉 RestTemplate、OkHttp，会发现 JQuick-Curl 并不是在重复造轮子，而是在解决一个长期被忽略的效率问题：如何让 curl 命令真正成为 Java 项目的第一等公民。对于经常做第三方接口调用、经常需要 curl 转 java 的团队，它能显著降低样板代码，提高调试一致性。
JQuick-Curl 的意义，不只是“又一个 java http 客户端”，而是把命令式请求描述带回 Java 开发流程里。这种思路在调试、联调、快速接入和业务落地中，往往比纯模板封装更实用。
下一篇预告
下一篇我们就正式进入上手阶段：Maven 依赖怎么引入、最小示例怎么跑通、一个 HelloWorld 请求从定义到执行到底需要哪几步。
