ฉันควรส่งคืนการตอบสนอง 204 หรือ 404 เมื่อไม่พบทรัพยากรหรือไม่

ฉันกำลังพัฒนาบริการ RESTful ที่เรียบง่ายสำหรับทัวร์นาเมนต์และกำหนดเวลา เมื่อมีการสร้างทัวร์นาเมนต์ผ่านคำขอ POST ที่มีเนื้อความ JSON การแข่งขันจะถูกแทรกใน a BiMapประกาศดังต่อไปนี้ในการนำ DAO ไปใช้:

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

เมื่อมีการสร้างทัวร์นาเมนต์ id ของสตริงที่เกี่ยวข้องจะถูกส่งคืนเพื่อให้ผู้ใช้สามารถมีการอ้างอิงในอนาคตของทัวร์นาเมนต์นั้น เขา / เธอสามารถรับข้อมูลคืนจากทัวร์นาเมนต์ใหม่ที่ทำตามคำขอต่อไปนี้:

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

แต่ถ้าหากไม่พบการแข่งขันที่มีรหัสดังกล่าวล่ะ จนถึงตอนนี้ฉันกำลังตอบกลับ 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 มีการร้องขอเช่นhttp://example.com/logs/[date-goes-here] ในวันที่ 18 พฤษภาคม 2015:

• http://example.com/logs/2015-05-19จะกลับมาHTTP 404ซึ่งหมายความว่าไม่มีบันทึกเพราะดีมันยากที่จะบันทึกอนาคต

• อย่างไรก็ตามhttp://example.com/logs/2015-05-18จะกลับมาHTTP 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 )

นอกจากนี้โปรดดูคำถาม SO นี้หากคุณต้องการควบคุมประเภทเนื้อหาที่คืนมา/programming/23858488/how-i-return-http-404-json-xml-response-in-jax-rs-ประเภทเนื้อหาที่ส่งคืนเสื้อ-on-คราว

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 เพื่อระบุว่าคำขอนั้นไม่ถูกต้อง ด้วยสิ่งเหล่านี้ข้อมูลเพิ่มเติมสามารถให้ในการตอบสนองเนื้อความ