Camel Rest（Restlet组件）路径参数混淆：/order/customer接口失效

我一眼就看出问题出在参数声明缺失上——你给/order/{orderId}接口明确定义了路径参数，但/order/customer接口完全没声明它需要的customerId参数，Camel根本不知道该从哪获取这个值传给OrderService的findOrderByCustomerId方法，这肯定会导致接口无法正常工作！

核心问题分析 #

你的findOrderByCustomerId方法必然需要接收customerId参数，但当前的API定义里没有告诉Camel：

• 这个参数是从路径里取？还是从查询参数里取？
• 参数的数据类型是什么？
• 参数的名称对应方法里的哪个参数？

两种常见场景的修正方案 #

场景1：customerId作为查询参数（请求示例：/order/customer?customerId=123）

给/order/customer接口添加查询参数声明：

rest("/order") 
 .get("/{orderId}").produces("application/json") 
 .param().dataType("int").type(RestParamType.path).name("orderId").endParam() 
 .route() 
 .bean(OrderService.class, "findOrderById") 
 .endRest() 
 .get("/customer").produces("application/json")
 // 新增查询参数声明，告诉Camel从URL查询参数中获取customerId
 .param().dataType("int").type(RestParamType.query).name("customerId").endParam()
 .route() 
 .bean(OrderService.class, "findOrderByCustomerId") 
 .endRest()

场景2：customerId作为路径参数（请求示例：/order/customer/123）

修改接口路径，把customerId作为路径变量，并添加路径参数声明：

rest("/order") 
 .get("/{orderId}").produces("application/json") 
 .param().dataType("int").type(RestParamType.path).name("orderId").endParam() 
 .route() 
 .bean(OrderService.class, "findOrderById") 
 .endRest() 
 // 修改路径，将customerId纳入路径变量
 .get("/customer/{customerId}").produces("application/json")
 // 声明路径参数
 .param().dataType("int").type(RestParamType.path).name("customerId").endParam()
 .route() 
 .bean(OrderService.class, "findOrderByCustomerId") 
 .endRest()

额外注意事项 #

• 确保OrderService的findOrderByCustomerId方法参数名和你声明的name("customerId")一致，比如：

  public Order findOrderByCustomerId(int customerId) {
      // 业务逻辑
  }
  

  如果方法参数名和API参数名不一致，可以用@Param注解映射：

  public Order findOrderByCustomerId(@Param("customerId") int id) {
      // 业务逻辑
  }
  

• 如果customerId是字符串类型，记得把dataType("int")改成dataType("String")。

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