Lambda 极简调用：不定义接口直接执行 curl 命令，JQuick-Curl 让 Java HTTP 调用更短更快
项目地址：https://github.com/dromara/jquick-curl
Maven坐标
<dependency>
<groupId>io.github.paohaijiao</groupId>
<artifactId>jquick-curl</artifactId>
<version>2.1.0</version>
</dependency>
前言
很多人第一次看到 JQuick-Curl，会自然地接受注解接口代理这种写法。但很快又会问一个问题：如果我不想专门定义一个接口，只是想快速执行一条 curl，有没有更短的方式？这个问题很合理。毕竟在很多临时联调、脚本化验证、一次性第三方接口调用中，专门为一条请求再建一个接口，多少还是有些重。
JQuick-Curl 提供了另一种更轻量的方式：通过方法引用，也就是很多人习惯称的 Lambda 风格调用。它不是凭空执行任意字符串，而是复用已有 @JCurlCommand 方法定义，通过 JCurlInvoker.invoke(...) 来直接运行。
它的价值在于：保留框架已有解析和转换能力，同时减少显式代理接口调用的样板步骤。对于熟悉 Java 8 方法引用的开发者来说，这种写法很顺手。
正文
先澄清一个概念
这里说的“Lambda 极简调用”，不是在运行时传一条裸 curl 字符串进去执行，而是通过“带有 @JCurlCommand 的方法引用”来执行。也就是说，你仍然需要有一个已经定义好的方法，只不过调用入口不再是 createProxy，而是 JCurlInvoker.invoke。
这和很多人理解的“真正无接口字符串执行”不完全一样，但在实际开发中已经足够轻便，而且更安全、更贴合现有 API。
为什么这种方式有价值
它适合以下几类场景：
- 单元测试中快速执行某个请求方法
- 临时脚本式调用已有请求定义
- 想直接拿方法返回值，不想先创建代理对象
- 想结合上下文、配置做局部调用实验
换句话说，这种方式更偏“执行入口优化”，不是“定义方式替代”。
实战代码块
先定义一个带 @JCurlCommand 的方法
import com.github.paohaijiao.anno.JCurlCommand;
import com.github.paohaijiao.domain.req.JQuickCurlReq;
public class UserServiceImpl {
@JCurlCommand("curl -X GET https://api.example.com/users/1")
public static String getUserById(JQuickCurlReq request) {
return null;
}
}
这里的方法本身并不需要自己实现请求逻辑，真正执行时会由 JQuick-Curl 处理。
直接通过方法引用执行
import com.github.paohaijiao.domain.req.JQuickCurlReq;
import com.github.paohaijiao.executor.JCurlInvoker;
public class LambdaDemo {
public static void main(String[] args) throws Exception {
JQuickCurlReq req = new JQuickCurlReq();
String result = JCurlInvoker.invoke(UserServiceImpl::getUserById, req, String.class);
System.out.println(result);
}
}
这就是最典型的 Lambda 风格调用。对于很多快速验证场景来说，它比“定义接口 + createProxy + 调用方法”更短。
返回实体对象
如果你已经定义了业务对象，也可以直接接实体。
public class UserProfile {
private Long id;
private String name;
public Long getId() {
return id;
}
public void setId(Long id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
public class UserServiceImpl {
@JCurlCommand("curl -X GET https://api.example.com/users/1")
public static UserProfile getUser(JQuickCurlReq request) {
return null;
}
}
UserProfile profile = JCurlInvoker.invoke(UserServiceImpl::getUser, new JQuickCurlReq(), UserProfile.class);
带上下文和配置执行
当你需要更细粒度控制时，还可以传入 JContext 和 JQuickCurlConfig。
import com.github.paohaijiao.config.JQuickCurlConfig;
import com.github.paohaijiao.domain.req.JQuickCurlReq;
import com.github.paohaijiao.executor.JCurlInvoker;
import com.github.paohaijiao.param.JContext;
JQuickCurlReq req = new JQuickCurlReq();
JContext context = new JContext();
JQuickCurlConfig config = JQuickCurlConfig.getInstance();
String result = JCurlInvoker.invoke(UserServiceImpl::getUserById, req, context, config, String.class);
这类写法更适合测试、调试或局部能力验证。
它和接口代理方式怎么选
如果你的目标是面向业务组织能力、形成清晰 API 接口，优先注解接口代理；如果你的目标是快速执行已有方法、测试或局部调用，方法引用方式很方便。
简单理解：
- 代理方式：更像稳定 API 层
- 方法引用方式：更像轻量执行入口
为什么说这仍然适合第三方接口调用
因为第三方接口调用里，很多时候你已经定义过方法了，后续只是想在某个测试类、排查工具类中单独再执行一遍。这个时候，JQuick-Curl 的方法引用执行就非常省事。
它和常见 java http 客户端 的最大不同仍然在于：你操作的是请求定义，而不是一堆 Builder 细节。
注意点 / 踩坑提示
1. 不是“任意 Lambda 都能执行”
方法引用最终指向的方法，仍然需要带 @JCurlCommand，否则没有请求定义可解析。
2. 返回类型要和实际响应匹配
如果响应是 JSON 字符串，而你直接声明成复杂对象，前提是结构必须能被正确转换。
3. 更适合已有方法复用，不适合完全动态字符串
当前公开 API 的最佳实践是复用已有方法定义，而不是把 curl 字符串动态拼接后直接注入执行。
4. 测试里特别好用
这类写法非常适合单元测试、冒烟测试、接口验证，不必每次都新建代理对象。
总结
JQuick-Curl 的 Lambda 极简调用，本质上是通过方法引用把已有 @JCurlCommand 方法作为执行入口。这种方式虽然不是“裸字符串直接执行”，但已经足够轻、足够实用，尤其适合测试、排查、临时验证和局部复用。
对 Java 开发者来说，它的意义在于进一步降低 java curl 执行的门槛。你既可以走接口代理的稳定开发路径，也可以在需要时用方法引用获得更短的调用链路。这种灵活性在第三方接口调用场景里非常有价值。
下一篇预告
下一篇我们正式讲动态参数：${} 全局变量和 #{} 方法参数到底怎么用，哪些场景该用哪一种，为什么很多人占位符会失效。
