从浏览器 DevTools 或 Postman 复制的 curl 命令原封不动粘贴进代码就能跑。零翻译、零拆解、零手工拼装效率提升 5-8 倍。一、你的日常是不是这样的场景 1从浏览器 DevTools 复制 curl你在浏览器里调试一个接口F12 打开 Network右键 - Copy as cURL拿到了一段完整的 curl 命令。然后呢你盯着这段命令开始手工翻译curl https://api.example.com/users \-H Content-Type: application/json \-H Authorization: Bearer eyJhbGc... \--data-raw {name:John,page:1}翻译成 Java 代码变成这样RestTemplate restTemplate new RestTemplate(); HttpHeaders headers new HttpHeaders(); headers.setContentType(MediaType.APPLICATION_JSON); headers.set(Authorization, Bearer eyJhbGc...); String body {\name\:\John\,\page\:1}; HttpEntityString entity new HttpEntity(body, headers); ResponseEntityString response restTemplate.exchange( https://api.example.com/users, HttpMethod.POST, entity, String.class );// 还要手动解析 response...一个接口三五分钟十个接口一下午。改个参数还得重来。场景 2从 Postman 导出 curlPostman 里调通了接口点 Code - cURL复制出来。然后还是一样的流程人肉拆解 URL、headers、body拼成 Java 代码。你有没有想过curl 命令已经是完整的请求描述了为什么还要翻译一遍二、JQuickCurl粘贴即用零翻译JQuickCurl 做的事情很简单直接把 curl 命令当作 API 定义。浏览器复制的 curl原封不动贴进注解里就能跑。public interface ApiService { // 从浏览器复制的 curl直接粘贴 JCurlCommand(curl https://api.example.com/users \n -H Content-Type: application/json \n -H Authorization: Bearer ${token} \n --data-raw {\name\:\John\,\page\:1}) String getUsers(JQuickCurlReq req); }调用ApiService api JCurlInvoker.createProxy(ApiService.class); JQuickCurlReq req new JQuickCurlReq(); req.put(token, eyJhbGc...); String result api.getUsers(req);完毕。没有手动拆 headers没有手动拼 body没有手动解析响应。从复制到跑通30 秒。三、效率对比传统方式 vs JQuickCurl以一个需要对接 10 个第三方接口的任务为例【传统方式RestTemplate / OkHttp 手写】拆解 curl 参数 ~1 分钟构建 HttpHeaders ~1 分钟拼装请求体 ~1-2 分钟执行请求 ~1 分钟解析响应 ~1-2 分钟调试验证 ~1 分钟10 个接口总耗时 50-80 分钟【JQuickCurl 方式】从浏览器/Postman 复制 curl ~5 秒粘贴到 JCurlCommand 注解 ~10 秒定义返回类型 ~10 秒调试验证 ~15-30 秒10 个接口总耗时 5-10 分钟效率提升5-8 倍 更重要的是不容易出错。传统方式手工拆解参数少一个 header、多一个引号都是 bug。JQuickCurl 直接用原始 curl浏览器里能跑通的代码里就能跑通。四、三种复制场景全部支持场景 1Chrome DevTools - Copy as cURL在 Network 面板右键请求 - Copy - Copy as cURL粘贴即用JCurlCommand(curl https://api.github.com/user \n -H accept: application/json \n -H authorization: Bearer ${token}) JGithubAuth getUser(JQuickCurlReq req);场景 2Postman - Code - cURL在 Postman 中点击 Code 按钮选择 cURL复制粘贴即用JCurlCommand(curl --location http://localhost:8080/api/users/create \n -H Content-Type: application/json \n -d {\name\:#{name},\email\:#{email}}) JUser createUser(Param(name) String name,Param(email) String email);场景 3API 文档里的 curl 示例大部分 API 文档Stripe、GitHub、微信开放平台等都提供 curl 示例直接复制粘贴JCurlCommand(curl -X GET https://api.stripe.com/v1/customers \n -u ${sk_key}:) String listCustomers(JQuickCurlReq req);五、动态参数复制之后还能改粘贴的 curl 不一定全是静态的。JQuickCurl 支持两种变量替换${变量}运行时从 JQuickCurlReq 赋值适合 token、域名等动态配置// curl 里的 ${token} 运行时替换 JCurlCommand(curl -H Authorization: Bearer ${token} https://api.example.com/user) JUser getUser(JQuickCurlReq req); // 调用时赋值 req.put(token, Bearer xxx);#{变量}绑定方法参数适合业务参数直接传递// curl 里的 #{name} 绑定到方法参数 JCurlCommand(curl -X POST ... -d {\name\:#{name}}) JUser create(Param(name) String name); // 调用时直接传参 api.create(张三);复制粘贴的 curl 动态参数替换 既有文档级的清晰度又有代码级的灵活性。六、XML 配置方式接口多了也能管当项目里接口越来越多全部写在注解里会显得拥挤。JQuickCurl 和 MyBatis 一样支持把 curl 命令统一放到 XML 文件里管理。接口定义和 curl 命令分离改接口不用动代码改 curl 不用重新编译。1. 在 resources 目录下创建 apis.xml?xml version1.0 encodingUTF-8? !DOCTYPE curls PUBLIC -//PAOHAIJIAO//DTD API CURL 1.0//EN classpath:paohaijiao/dtd/Jquick-curl.dtd curls namespacecom.github.paohaijiao.test.xml.UserApi !-- 从浏览器复制的 curl直接粘贴到 curl 标签里 -- curl namegetUserById returnClasscom.github.paohaijiao.test.model.JUser curl -X GET http://localhost:8080/api/users/1 /curl !-- 支持动态参数 #{name} -- curl namecreateUser returnClasscom.github.paohaijiao.test.model.JUser curl -X POST http://localhost:8080/api/users/createUser \ -H Content-Type: application/json \ -d {name:#{name},email:#{email}} /curl !-- 支持全局变量 ${token} -- curl namegetUser returnClasscom.github.paohaijiao.model.JResult curl -X GET https://api.example.com/user \ -H Authorization: Bearer ${token} /curl !-- 文件上传也能写 -- curl nameupload returnClassjava.lang.String curl -X POST http://localhost:8080/api/users/upload \ -F fileD:\test\test.txt /curl !-- 文件下载 -- curl namedownload returnClassbyte[] curl -X GET http://localhost:8080/api/users/download/test.txt \ --output d://test//download.txt /curl /curls2. Java 接口只写方法签名干净利落public interface UserApi { JUser getUserById(JQuickCurlReq req); JUser createUser(Param(name) String name, Param(email) String email); JResult getUser(JQuickCurlReq req); String upload(JQuickCurlReq req); byte[] download(JQuickCurlReq req); }3. 通过工厂加载 XML创建代理JQuickParseHandler parser new JQuickCurlXmlParseFactory(); JQuickFactory factory new JQuickXmlFactory(parser, apis.xml); UserApi userApi factory.createApi(UserApi.class); // 调用 JQuickCurlReq req new JQuickCurlReq(); req.put(token, Bearer xxx); JUser user userApi.getUserById(req);XML 配置方式的好处集中管理 curl 命令统一放在 XML 里一目了然代码干净 接口代码只有方法签名没有注解噪音免编译 修改 curl 不需要重新编译 Java 代码零学习成本 和 MyBatis Mapper XML 用法完全一致粘贴即用 同样支持从浏览器/Postman 复制的 curl工作流升级版浏览器复制 curl - 粘贴到 XML 的 curl 标签 - 定义接口方法 - 调用连注解都不用写直接粘到 XML 里就行。七、完整工作流从调试到上线Step 1 浏览器/Postman 调试接口确认参数正确Step 2 复制 curl 命令Step 3 粘贴到 JCurlCommand 注解 或 XML curl 标签Step 4 定义返回类型创建代理调用Step 5 上线public interface OrderApi { JCurlCommand(curl -X POST http://order-service/api/orders \n -H Content-Type: application/json \n -H Authorization: Bearer ${token} \n -d {\productId\:#{productId},\quantity\:#{qty}}) JOrder createOrder(Param(productId) String productId,Param(qty) int qty); }OrderApi api JCurlInvoker.createProxy(OrderApi.class); JOrder order api.createOrder(P001, 5);从调试到上线curl 命令一个字都没改。浏览器里跑通的生产环境一样跑通。八、还支持这些 curl 特性从浏览器和 Postman 复制的 curl 通常包含各种选项JQuickCurl 全部支持-H / --header 请求头Content-Type、Authorization 等-d / --data POST 请求体--data-raw 原始请求体不解析 --data-urlencode URL 编码的表单数据-X / --request 指定 HTTP 方法-u / --user 基础认证用户名:密码-F / --form 文件上传multipart/form-data-o / --output 文件下载-L / --location 跟随重定向--max-redirs 最大重定向次数-x / --proxy HTTP/HTTPS 代理--socks5-hostname SOCKS5 代理--http2 HTTP/2 协议-k / --insecure 跳过 SSL 证书校验-I 仅获取响应头HEAD 请求也就是说你在浏览器里复制出来的 curl 是什么样贴进去就是什么样。不用删选项不用改格式不用做任何适配。九、谁适合用- 后端开发者 对接第三方 API频繁从文档/Postman 复制 curl- 爬虫工程师 浏览器里调通请求直接粘贴成代码- 测试工程师 把 Postman 调试通过的 curl 快速转成可执行代码- 微服务团队 服务间调用用 curl 风格定义统一管理- 金融支付团队 对接支付网关curl 命令直接来自银行/支付平台文档十、快速开始Step 1添加 Maven 依赖dependency groupIdio.github.paohaijiao/groupId artifactIdjquick-curl/artifactId version${latest.version}/version /dependencyStep 2从浏览器复制 curl粘贴到注解public interface GithubApi { JCurlCommand(curl -u ${user}:${token} https://api.github.com/user -X GET) JGithubAuth getUser(JQuickCurlReq req); }Step 3创建代理调用GithubApi api JCurlInvoker.createProxy(GithubApi.class); JQuickCurlReq req new JQuickCurlReq(); req.put(user, your-emailexample.com); req.put(token, your-token); JGithubAuth auth api.getUser(req); System.out.println(auth);完成。从复制到跑通一分钟内搞定。总结传统 HTTP 客户端开发的问题在于curl 已经完整描述了请求但你还得手动翻译成 Java 代码。这是一道不必要的翻译工序。JQuickCurl 的核心价值粘贴即用 浏览器/Postman 复制的 curl原样粘贴即可使用零翻译 零拆解、零手工拼装动态参数 支持 ${} 和 #{} 两种变量替换XML 配置 curl 命令集中管理改 curl 不用重新编译全选项支持 headers、auth、form、proxy、SSL 等全兼容效率提升 5-8 倍且不易出错兼容性 Java 8Apache License 2.0 开源下次从浏览器复制 curl 的时候别再手动翻译了。粘贴进去直接跑。---------------------------------------------------------------------------------------------------------------------------------GitHub: https://github.com/paohaijiao/jquick-curlLicense: Apache License 2.0Contact: goudingchenggmail.com如果对你有帮助欢迎 Star 支持
