当找不到REST资源时返回404是否正确？

Question

@Path("/foos")
public class MyRestlet
        extends BaseRestlet
{

    @GET
    @Path("/{fooId}")
    @Produces(MediaType.APPLICATION_XML)
    public Response getFoo(@PathParam("fooId") final String fooId)
            throws IOException, ParseException
    {
        final Foo foo = fooService.getFoo(fooId);

        if (foo != null)
        {
            return Response.status(Response.Status.OK).entity(foo).build();
        }
        else
        {
            return Response.status(Response.Status.NOT_FOUND).build();
        }
    }

}

Answer 1

在这种情况下，404响应是非常典型的，API用户很容易使用。

一个问题是，由于没有找到特定的实体，或者由于URI中的结构问题，客户端很难判断他们是否得到了404。在您的示例中，/foos/5可能返回404，因为ID=5的foo不存在。但是，/food/1将返回404，即使存在ID=1的foo（因为foos拼写错误）。换句话说，404意味着一个构造不良的URI或对不存在的资源的引用。

当您有一个引用多个资源的URI时，会出现另一个问题。通过一个简单的404响应，客户机不知道哪个引用的资源没有找到。