ทรัพยากรทุกรายการมีช่องเวอร์ชันที่จะเปลี่ยนทุกครั้งที่ทรัพยากรมีการเปลี่ยนแปลง ซึ่งก็คือช่อง etag
Etag เป็นส่วนมาตรฐานของ HTTP และรองรับใน Calendar API สำหรับ 2 กรณีต่อไปนี้
- ในการแก้ไขทรัพยากรเพื่อให้แน่ใจว่าไม่มีการเขียนอื่นไปยังทรัพยากรนี้ในระหว่างนี้ (การแก้ไขแบบมีเงื่อนไข)
- ในการดึงข้อมูลทรัพยากร ให้ดึงข้อมูลทรัพยากรเฉพาะในกรณีที่ทรัพยากรมีการเปลี่ยนแปลง (การดึงข้อมูลแบบมีเงื่อนไข)
การแก้ไขแบบมีเงื่อนไข
หากต้องการอัปเดตหรือลบทรัพยากรเฉพาะในกรณีที่ไม่มีการเปลี่ยนแปลงนับตั้งแต่ที่คุณเรียกข้อมูลครั้งล่าสุด คุณสามารถระบุส่วนหัว If-Match
ที่มีค่าของ ETag จากการเรียกข้อมูลครั้งก่อนได้ ซึ่งมีประโยชน์อย่างยิ่งในการป้องกันไม่ให้การแก้ไขทรัพยากรสูญหาย ไคลเอ็นต์มีตัวเลือกในการดึงข้อมูล
ทรัพยากรอีกครั้งและใช้การเปลี่ยนแปลงอีกครั้ง
หากรายการ (และ ETag ของรายการ) ไม่มีการเปลี่ยนแปลงนับตั้งแต่การดึงข้อมูลครั้งล่าสุด การแก้ไขจะสำเร็จและระบบจะแสดงผลทรัพยากรเวอร์ชันใหม่พร้อม ETag ใหม่ ไม่เช่นนั้น คุณจะได้รับรหัสการตอบกลับ 412 (ไม่เป็นไปตามเงื่อนไขเบื้องต้น)
ข้อมูลโค้ดตัวอย่างด้านล่างแสดงวิธีทำการแก้ไขแบบมีเงื่อนไขด้วยไลบรารีของไคลเอ็นต์ Java
private static void run() throws IOException { // Create a test event. Event event = Utils.createTestEvent(client, "Test Event"); System.out.println(String.format("Event created: %s", event.getHtmlLink())); // Pause while the user modifies the event in the Calendar UI. System.out.println("Modify the event's description and hit enter to continue."); System.in.read(); // Modify the local copy of the event. event.setSummary("Updated Test Event"); // Update the event, making sure that we don't overwrite other changes. int numAttempts = 0; boolean isUpdated = false; do { Calendar.Events.Update request = client.events().update("primary", event.getId(), event); request.setRequestHeaders(new HttpHeaders().setIfMatch(event.getEtag())); try { event = request.execute(); isUpdated = true; } catch (GoogleJsonResponseException e) { if (e.getStatusCode() == 412) { // A 412 status code, "Precondition failed", indicates that the etag values didn't // match, and the event was updated on the server since we last retrieved it. Use // {@link Calendar.Events.Get} to retrieve the latest version. Event latestEvent = client.events().get("primary", event.getId()).execute(); // You may want to have more complex logic here to resolve conflicts. In this sample we're // simply overwriting the summary. latestEvent.setSummary(event.getSummary()); event = latestEvent; } else { throw e; } } numAttempts++; } while (!isUpdated && numAttempts <= MAX_UPDATE_ATTEMPTS); if (isUpdated) { System.out.println("Event updated."); } else { System.out.println(String.format("Failed to update event after %d attempts.", numAttempts)); } }
การดึงข้อมูลแบบมีเงื่อนไข
หากต้องการดึงข้อมูลทรัพยากรเฉพาะในกรณีที่มีการเปลี่ยนแปลงนับตั้งแต่ที่คุณดึงข้อมูลครั้งล่าสุด
คุณสามารถระบุส่วนหัว If-None-Match
ซึ่งมีค่าของ ETag จากการดึงข้อมูลครั้งก่อนได้ หากรายการ (และ ETag ของรายการ) มีการเปลี่ยนแปลงนับตั้งแต่การดึงข้อมูลครั้งล่าสุด ระบบจะแสดงผลทรัพยากรเวอร์ชันใหม่พร้อม ETag ใหม่ มิฉะนั้น คุณจะได้รับรหัสตอบกลับ 304 (ไม่มีการแก้ไข)
ข้อมูลโค้ดตัวอย่างด้านล่างแสดงวิธีดึงข้อมูลแบบมีเงื่อนไขด้วยไลบรารีของไคลเอ็นต์ Java
private static void run() throws IOException { // Create a test event. Event event = Utils.createTestEvent(client, "Test Event"); System.out.println(String.format("Event created: %s", event.getHtmlLink())); // Pause while the user modifies the event in the Calendar UI. System.out.println("Modify the event's description and hit enter to continue."); System.in.read(); // Fetch the event again if it's been modified. Calendar.Events.Get getRequest = client.events().get("primary", event.getId()); getRequest.setRequestHeaders(new HttpHeaders().setIfNoneMatch(event.getEtag())); try { event = getRequest.execute(); System.out.println("The event was modified, retrieved latest version."); } catch (GoogleJsonResponseException e) { if (e.getStatusCode() == 304) { // A 304 status code, "Not modified", indicates that the etags match, and the event has // not been modified since we last retrieved it. System.out.println("The event was not modified, using local version."); } else { throw e; } } }