如何在宁静的java服务中满足无效返回警告

Question

Java 代码：

      @GET
      @Path("/stop/{id}")
      public void stop(
      @PathParam("id") String id,
      @Context HttpServletRequest request,
      @Context HttpServletResponse response) throws ServletException,
      IOException
      {
        server.stop(id);
      }

Java 警告被抛出到控制台：

警告：HTTP GET 方法，public void com.myPackage.stop(java.lang.String,javax.servlet.http.HttpServletRequest,javax.servlet.http.HttpServletResponse)抛出 javax.servlet.ServletException、java.io.IOException，必须返回非 void 类型。

Answer 1

您确实不应该使用 GET 操作。

我将使用 POST 操作并返回 201 Created ，其中包含指向描述系统新状态的资源的链接。

例如，我将重定向到关闭状态资源：

POST /stop/123
...
201 CREATED
Location:
  http://acme.com/shutdownstatus/123

客户端可以轮询资源以检查状态。

GET /shutdownstatus/123
...
<shutdown xmlns="http://schemas.serverapp.com/shutdown">
  <status>pending</status>
  <message>Looks good so far</message>
</shutdown> 

这个新的 GET 操作将始终返回该 id 的服务器状态。这样您就知道它是否正确关闭。如果服务器关闭需要很长时间，客户端可以轮询该资源以检查不同的关闭状态，直到完成。这样你就可以从原来的服务器关闭请求中快速返回。

如果您的进程中抛出异常，我不会将其返回给客户端，我会在服务器状态资源中获得异常的状态。当我可以将客户端表示为资源时，我总是避免让客户端处理异常情况。这允许您自由更改资源，例如当更改或修复导致异常的方法时，无需更改外部 API。

Answer 2

警告是正确的。 GET 操作应该是幂等的，因此不应影响服务器状态。如果您没有返回任何内容，则该方法不能做任何有用的事情。您应该将其更改为 POST 或其他一些适当的 HTTP 操作。

Answer 3

url 必须如下。
{服务器名称}：{端口}/{应用程序名称}/{标准名称}/{您的服务名称}/{您的操作名称}

例如：http://localhost:8080/restful/jersy/user/service/getUserDets

休息 - 应用程序名称
球衣 - 标准名称{可选}
用户/服务 - 服务名称
getuserdets - 操作名称

Answer 4

尝试将其定义为 *V*oid 并返回 null。

  @GET
  @Path("/stop/{id}")
  public void stop(
  @PathParam("id") String id,
  @Context HttpServletRequest request,
  @Context HttpServletResponse response) throws ServletException,
  IOException
  {
    server.stop(id);
    return null;
  }