如何为Java应用设置支持传入不同参数的HTTP调用入口

以下是三类不同场景下的实现方案，按从轻量到可扩展的顺序排列，你可以根据自己的项目需求选择：

1. 最轻量无依赖方案：JDK自带HttpServer #

JDK 1.6及以上版本原生自带HttpServer能力，无需引入任何第三方依赖，也不需要额外部署Servlet容器，适合只需要简单HTTP入口的轻量场景：

import com.sun.net.httpserver.HttpServer;
import java.io.IOException;
import java.io.OutputStream;
import java.net.InetSocketAddress;
import java.nio.charset.StandardCharsets;

public class SimpleHttpEntry {
    public static void main(String[] args) throws IOException {
        // 监听8080端口，请求队列长度设置为0
        HttpServer server = HttpServer.create(new InetSocketAddress(8080), 0);
        // 定义接口路径和请求处理逻辑
        server.createContext("/api/entry", exchange -> {
            // 可自行解析GET请求的query参数、POST请求的body参数
            String query = exchange.getRequestURI().getQuery();
            // 执行业务逻辑
            String resp = "传入参数：" + query + "，业务处理完成";
            // 返回响应结果
            exchange.sendResponseHeaders(200, resp.getBytes(StandardCharsets.UTF_8).length);
            try (OutputStream os = exchange.getResponseBody()) {
                os.write(resp.getBytes(StandardCharsets.UTF_8));
            }
        });
        server.start();
    }
}

• 优点：零额外依赖，十行左右代码即可运行，不需要Tomcat等容器支持
• 缺点：没有内置参数解析、类型转换、异常处理、权限校验等能力，复杂业务开发成本高

2. 高效开发优先方案：Spring Boot Web #

如果是新项目开发，后续还会迭代更多HTTP接口，优先选择该方案，开发效率最高，不需要手动处理底层HTTP逻辑：

• 仅需引入spring-boot-starter-web依赖，写Controller即可快速定义接口
• 自带参数自动解析、类型转换、异常统一处理、接口文档生成等成熟能力
• 内置Tomcat/Jetty/Undertow容器，直接打jar包即可运行，无需单独部署容器

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
@RestController
public class SpringBootHttpEntry {
    public static void main(String[] args) {
        SpringApplication.run(SpringBootHttpEntry.class, args);
    }

    @GetMapping("/api/entry")
    public String entry(@RequestParam String param1, @RequestParam Integer param2) {
        // 参数会自动解析为对应类型，直接执行业务逻辑即可
        return "参数1：" + param1 + "，参数2：" + param2 + "，处理完成";
    }
}

3. Servlet实现方案 #

仅推荐在已有基于Servlet容器（比如Tomcat）部署的传统Java Web项目中使用，新项目不优先选择：

• 需要打包为war包部署到Servlet容器中运行
• 需要手动处理参数解析、类型转换等逻辑，相比Spring Boot开发效率更低
• 适配现有老Web项目的兼容性最好

选型建议 #

• 仅需要临时简单的HTTP入口，不想增加额外依赖：选择JDK自带HttpServer
• 新项目开发，后续会有更多接口迭代：选择Spring Boot Web
• 已有传统Java Web项目需要新增调用入口：选择Servlet实现

内容的提问来源于stack exchange，提问作者Smile88