리소스를 찾을 수 없을 때 204 또는 404 응답을 반환해야합니까?

토너먼트 및 일정에 대한 간단한 RESTful 서비스를 개발 중입니다. JSON 본문을 포함하는 POST 요청을 통해 토너먼트가 작성되면 토너먼트는에 삽입되어 BiMapDAO 구현에서 다음과 같이 선언됩니다.

private BiMap<String, Tournament> tournaments = Maps.synchronizedBiMap(HashBiMap.create());

토너먼트가 작성되면 연관된 문자열 ID가 리턴되므로 사용자 는 해당 토너먼트에 대한 나중에 참조 할 수 있습니다. 다음 요청을 수행하여 새 토너먼트에서 정보를 다시 얻을 수 있습니다.

GET http://localhost:8080/eventscheduler/c15268ce-474a-49bd-a623-b0b865386f39

그러나 그러한 ID를 가진 토너먼트가 없으면 어떻게해야합니까? 지금까지 204 응답을 반환합니다. 글쎄, 저지는 null그 방법 중 하나에서 돌아올 때 나를 위해 그것을 하고 있습니다. 위의 경로에 해당하는 방법입니다.

@Path("/{id}")
@GET
@Produces(MediaType.APPLICATION_JSON)
public Tournament getTournament(@PathParam("id") String id) {
    Optional<Tournament> optTournament = tournamentDao.getTournament(id);
    if (optTournament.isPresent())
        return optTournament.get();
    return null;
}

내 질문은 : 204: No Content응답 을 반환해도 괜찮 404습니까? 아니면 리소스를 찾지 못했기 때문에 응답 이어야 합니까?

404로 변경 해야하는 경우 명백한 질문 : 메소드 서명을 올바르게 변경해야합니까? 토너먼트 (유형 Tournament)가 반환되지 않을 수 있으므로 메소드가 다르게 보일 것입니다. Response대신 타입을 리턴 타입으로 사용해야 합니까?

HTTP 204무언가 를 찾았지만 비어 있음을 의미합니다 . 예를 들어 http://example.com/logs/[date-goes-here] 와 같은 요청으로 HTTP를 통해 로그 파일을 제공한다고 가정합니다 . 2015 년 5 월 18 일 :

• http://example.com/logs/2015-05-19 는을 반환합니다 HTTP 404. 이는 로그가 없기 때문에 미래를 기록하기가 어렵 기 때문입니다.

• 그러나 http://example.com/logs/2015-05-18HTTP 200 은 응답 내용의 로그 항목과 함께 또는 HTTP 204로그 파일이 생성되었지만 아직 기록 된 로그가없는 경우 반환합니다. 데이트.

null요청에 대한 응답으로 프레임 워크에 제공 하는 경우 항목을 찾았으며이 항목이 비어 있다고 가정합니다 HTTP 204. 대신, throw new NotFoundException();항목이 존재하지 않음을 프레임 워크에 표시하여 항목을 생성해야합니다 HTTP 404.

404로 변경 해야하는 경우 명백한 질문 : 메소드 서명을 올바르게 변경해야합니까?

아뇨 에 대한 좋은 점 throw new NotFoundException();입니다. 메소드의 실제 리턴 유형이 무엇이든 상관없이 작동합니다.

404를 반환해야합니다 . NotFoundException ( https://jersey.java.net/apidocs/2.6/jersey/javax/ws/rs/NotFoundException.html )을 발생 시켜 404를 반환 할 수 있습니다 .

또한 반환 된 콘텐츠 유형을 제어 해야하는 경우이 SO 질문을 참조하십시오 https : //.com/questions/23858488/how-i-return-http-404-json-xml-response-in-jax-rs- 저지 온 톰캣

귀하의 요청은 GET http://localhost:8080/eventscheduler/c15268ce-474a-49bd-a623-b0b865386f39입니다.

경우 http://localhost:8080/eventscheduler/엔드 포인트로 존재하지 않습니다, 당신은 당신은 (리소스에 액세스를 시도 할 때 (404) 반환해야합니다 /eventscheduler/존재하지 않음). 이것은 서버에 서버가 존재 localhost:8080하지만 클라이언트 에 eventscheduler엔드 포인트 가 없음을 나타냅니다 .

경우 http://localhost:8080/eventscheduler/엔드 포인트로 존재하지만 필요한 자원을 사용할 수 없습니다하는 5XX 오류가 적합하다. 데이터베이스가 오프라인 상태 인 경우 503을 반환 할 수 있습니다. 물론 특정 인스턴스 대신 일반 500 오류를 반환 할 수도 있습니다.

경우에 http://localhost:8080/eventscheduler/존재하지만이 나타내는 것은 c15268ce-474a-49bd-a623-b0b865386f39존재하지 않는, 나는 세부 사항을 나타내는 몸 200을 반환합니다. 엔드 포인트가 존재하고 요청이 완전히 유효하며 처리 될 수 있지만 일치하는 것이 없습니다.

엔드 포인트에 대한 클라이언트 요청이 유효하지 않은 경우 다른 4xx 오류를 볼 수 있습니다. 클라이언트가 엔드 포인트 또는 401 또는 403으로 요청한 항목에 액세스 할 권한이 없음을 표시하거나 400을 사용하여 요청이 유효하지 않음을 표시 할 수 있습니다. 이 중 하나를 사용하면 추가 정보가 응답 본문에 제공 될 수 있습니다.