RESTful Web Service中服务端如何向客户端发起问询获取股票查询参数

核心逻辑说明 #

HTTP 本身是「客户端请求-服务端响应」的无状态协议，服务端无法主动向客户端发起询问，你需要的交互流程需要调整为符合HTTP规范的模式，常用两种实现方案：

• 方案1（需要用户选股票的场景）：客户端先调用「股票列表查询接口」获取可选股票列表，用户在客户端选中目标股票后，再携带股票标识调用「股票详情查询接口」拉取数据
• 方案2（用户知道股票代码/名称的场景）：客户端直接在查询请求中携带要查询的股票标识，一次请求完成数据拉取，性能最优

现有代码优化 #

你当前的POST接口用@QueryParam接收参数不符合POST接口的常规设计规范，参数会暴露在URL中，也有长度限制，建议改成从请求体接收参数，同时修复原有代码的逻辑问题：

import jakarta.ws.rs.*;
import jakarta.ws.rs.core.MediaType;
import com.alibaba.fastjson.JSONObject; // 可替换成你实际使用的JSON工具类

@Path("/stock")
public class StockResource { // 类名建议遵循Java驼峰命名规范
    
    // 股票详情查询接口：从POST请求体接收参数
    @POST
    @Path("/detail")
    @Consumes(MediaType.APPLICATION_JSON) // 声明接收JSON格式的请求体
    @Produces(MediaType.APPLICATION_JSON)
    public String getStockDetail(StockQueryRequest request) throws Exception {
        // 先校验参数非空
        if (request.getSymbolName() == null || request.getSymbolName().trim().isEmpty()) {
            return Utility.constructJSON("Fail", false, "股票名称不能为空").toString();
        }
        
        JSONObject stockInfo = checkStock(request.getSymbolName());
        // 修复原有判断逻辑：obj.toString()永远不会返回null，改为判断对象本身是否为空
        if (stockInfo != null && !stockInfo.isEmpty()) {
            return stockInfo.toString();
        } else {
            return Utility.constructJSON("Fail", false, "未查询到对应股票信息").toString();
        }
    }
    
    // 可选：股票列表查询接口，供客户端拉取可选股票展示给用户选择
    @GET
    @Path("/list")
    @Produces(MediaType.APPLICATION_JSON)
    public String getStockList() {
        // 这里实现从数据库查询所有可选股票的名称、代码等基础信息返回
        List<StockBasicInfo> list = queryAllAvailableStocks();
        return JSONObject.toJSONString(list);
    }

    // 接收请求参数的实体类示例，也可以直接用JSONObject接收请求体
    public static class StockQueryRequest {
        private String symbolName;
        // getter和setter方法
        public String getSymbolName() { return symbolName; }
        public void setSymbolName(String symbolName) { this.symbolName = symbolName; }
    }
}

交互流程步骤 #

1. 客户端先调用GET /stock/list接口获取所有可选股票列表，展示给用户选择
2. 用户选中目标股票后，客户端发起POST /stock/detail请求，请求体格式示例：

{
    "symbolName": "要查询的股票名称/代码"
}

3. 服务端接收参数后校验合法性，查询数据库返回对应股票的详情数据

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