java - 一个类中有多个@POST标签

Question

一个类/接口(interface)中是否可以有多个@POST标签。让我知道这段代码是否有问题，如果有的话为什么:

@Produces("application/json")
@Consumes("application/json")
@Path("/user/raflets/{appId}/admin/batch/{batchId}/instance")
public interface RafletJobInstanceRestService {

@GET
@Path("/{instanceId}")
JobInstanceBean getJobInstanceDetails(@Context UriInfo uriInfo,
        @PathParam("appId") int appId, @PathParam("batchId") int batchId,
        @PathParam("instanceId") int instanceId);

@POST
@Path("/{instanceId}")
JobInstanceBean updateInstance(@Context UriInfo uriInfo,
        @PathParam("appId") int appId, @PathParam("batchId") int batchId,
        @PathParam("instanceId") int instanceId,
        JobInstanceBean batchInstance);

@POST
@Path("/clone/{instanceId}")
JobInstanceBean cloneInstance(@Context UriInfo uriInfo,
        @PathParam("appId") int appId, @PathParam("batchId") int batchId,
        @PathParam("instanceId") int instanceId,
        JobInstanceBean batchInstance);
}

我想既然每个post调用都有不同的路径，那么就不会有问题，对吧？

Answer 1

是的，可以有多个@POST注释。就此而言，拥有多个 @GET 注释也很好。它们只是指定 API 端点应响应的 HTTP 谓词。

与此相关的是，如果您的 API 通过 HTTPS 提供服务，并且您在这些 POST 请求中发送敏感数据，您可能需要考虑将该数据作为 header 而不是 URL 中的 POST 参数发送。 URL 中的 API 端点和参数仍然可见，但您的敏感数据将在 header 中加密。为此，您只需从服务的路径中删除它们，并使用 @FormParam 而不是 @PathParam 检索它们。