HATEOAS ให้ความสำคัญกับลูกค้าเป็นอย่างไร

ในขณะที่ฉันเข้าใจว่า HATEOAS นั้นเกี่ยวกับการส่งลิงก์ตอบกลับแต่ละลิงก์พร้อมด้วยข้อมูลเกี่ยวกับสิ่งที่ต้องทำ ตัวอย่างง่ายๆอย่างหนึ่งสามารถพบได้ง่ายบนอินเทอร์เน็ต: ระบบธนาคารพร้อมกับทรัพยากรบัญชี ตัวอย่างแสดงการตอบสนองนี้หลังจากได้รับการร้องขอไปยังทรัพยากรบัญชี

GET /account/12345 HTTP/1.1 HTTP/1.1 200 OK 
<?xml version="1.0"?> 
<account> 
    <account_number>12345</account_number> 
    <balance currency="usd">100.00</balance> 
    <link rel="deposit" href="/account/12345/deposit" /> 
    <link rel="withdraw" href="/account/12345/withdraw" /> 
    <link rel="transfer" href="/account/12345/transfer" /> 
    <link rel="close" href="/account/12345/close" /> 
</account>

ร่วมกับข้อมูลมีลิงค์บอกสิ่งที่สามารถทำได้ต่อไป หากยอดคงเหลือเป็นลบเรามี

GET /account/12345 HTTP/1.1 HTTP/1.1 200 OK 
<?xml version="1.0"?> 
<account> 
    <account_number>12345</account_number> 
    <balance currency="usd">-25.00</balance> 
    <link rel="deposit" href="/account/12345/deposit" /> 
</account>

เพื่อให้เราสามารถฝากได้เท่านั้น ไม่เป็นไรถ้าเราใช้พู้ทำเล่นหรือร้องขอกับเบราว์เซอร์เราสามารถเห็นสิ่งที่สามารถทำได้อย่างง่ายดาย ข้อมูลประเภทนี้มีประโยชน์สำหรับเราในการค้นหาความสามารถของ API และเซิร์ฟเวอร์ถูกแยกจากลูกค้า

อย่างไรก็ตามประเด็นก็คือเมื่อเราสร้างลูกค้าเช่นสปาที่มี Javascript หรือแอพ Android หรือสิ่งอื่น ๆ อีกมากมายฉันไม่สามารถเห็นได้ว่า HATEOAS มีความเกี่ยวข้องกันอย่างไร สิ่งที่ฉันหมายถึงมีดังต่อไปนี้: เมื่อฉันเขียนรหัส SPA ใน javascript ฉันต้องรู้สิ่งที่สามารถทำได้ใน API เพื่อที่จะเขียนโค้ด

ดังนั้นฉันจำเป็นต้องรู้แหล่งข้อมูลวิธีการที่สนับสนุนสิ่งที่พวกเขาคาดหวังว่าจะได้รับและสิ่งที่พวกเขาให้คืนเพื่อเขียนการเรียก ajax ไปยังเซิร์ฟเวอร์และเพื่อสร้าง UI เมื่อฉันสร้าง UI ฉันต้องรู้ว่าหลังจากขอบัญชีผู้ใช้สามารถฝากเงินเข้าได้หรือฉันจะไม่สามารถให้ตัวเลือกนี้กับ UI ได้ นอกจากนี้ฉันจะต้องรู้จัก URI เพื่อทำการฝากเพื่อสร้างการโทร ajax

สิ่งที่ฉันหมายถึงคือเมื่อเราทำการร้องขอไปยัง API ลิงก์จะช่วยให้เราค้นพบและใช้ API ได้ดีขึ้น แต่เมื่อเราสร้างลูกค้าแอปที่เรากำลังสร้างจะไม่เพียงมองที่ลิงค์จากนั้นแสดงผลด้วยตัวเอง UI ที่ถูกต้องและโทร ajax ที่ถูกต้อง

ดังนั้น HATEOAS มีความสำคัญต่อลูกค้าอย่างไร ทำไมเราถึงรำคาญกับ HATEOAS ล่ะ?

แอพที่เรากำลังสร้างจะไม่เพียงแค่ดูลิงก์จากนั้นแสดง UI ที่ถูกต้องและทำการโทร ajax ที่ถูกต้อง

ในความเป็นจริงนี้เป็นว่าสิ่งที่ HATEOAS จะให้การ UI ไม่ใช่สิ่งที่เป็นไปได้ แต่เมื่อเป็นไปได้ HATEOAS ที่เป็นทางการเช่นHALในฐานะคำถามจะให้ลิงก์ที่บ่งบอกถึงสิ่งที่เป็นไปได้ แต่เมื่อลิงค์เหล่านั้นปรากฏขึ้นขึ้นอยู่กับสถานะของแอปพลิเคชัน ดังนั้นลิงก์สามารถเปลี่ยนแปลงทรัพยากรเมื่อเวลาผ่านไป (ขึ้นอยู่กับการกระทำที่ได้ทำไปแล้ว)

สิ่งนี้ทำให้เราสามารถสร้าง UI ที่มีสถานะที่เป็นไปได้ทั้งหมดแต่ไม่ต้องกังวลเมื่อสถานะเหล่านั้นเปิดใช้งาน ตัวอย่างเช่นการมีอยู่ของrel="deposit"สามารถบอก UI โดยตรงเมื่อมันตกลงเพื่อแสดงmake depositแบบฟอร์ม ซึ่งอนุญาตให้ผู้ใช้ป้อนค่าและส่งโดยใช้ลิงก์

ในขณะที่ฉันเข้าใจว่า HATEOAS นั้นเกี่ยวกับการส่งลิงก์ตอบกลับแต่ละลิงก์พร้อมด้วยข้อมูลเกี่ยวกับสิ่งที่ต้องทำต่อไป

HATEOAS เป็นมากกว่าการเชื่อมโยง มันคือ "สื่อไฮเปอร์" เป็นเครื่องมือของรัฐแอพลิเคชัน

สิ่งที่พลาดในคำอธิบายของคุณคือประเภทเนื้อหาคำจำกัดความที่เป็นทางการของสื่อไฮเปอร์ที่ส่งผ่านระหว่างไคลเอนต์และเซิร์ฟเวอร์

HTML เป็นตัวอย่างของสื่อหลายมิติและตัวอย่างว่าทำไม HATEOS ถึงทำงาน หน้า HTML นั้นเป็นเอ็นจิ้นที่อนุญาตให้ไคลเอนต์ (เช่นผู้ใช้) เลื่อนผ่านเว็บไซต์ เบราว์เซอร์ที่มีเพียงความสามารถในการแสดง HTML นำเสนอให้กับผู้ใช้เว็บไซต์นำทางได้อย่างสมบูรณ์ ไม่ใช่เพียงแค่มันส่งผ่านลิงค์ไปยังหน้าอื่น ๆ แต่มันส่งผ่านไปในทางที่มีความหมายซึ่งจะให้บริบทกับลิงค์และในลักษณะที่ทำให้เบราว์เซอร์สามารถสร้างไซต์นำทางได้

และที่สำคัญที่สุดคือเบราว์เซอร์สามารถทำสิ่งนี้ได้ด้วย ZERO ที่มีความเข้าใจล่วงหน้าของเว็บไซต์ เบราว์เซอร์รู้ HTTP และ HTML เท่านั้น จากความเข้าใจง่าย ๆ ว่าสามารถนำเสนอนิวยอร์กไทม์สให้กับผู้ใช้เพื่อนำทางผ่าน

สิ่งนี้จะเก็บไว้แม้ว่า "ผู้ใช้" เป็นโปรแกรมคอมพิวเตอร์อื่น สื่อไฮเปอร์เองควรกำหนดบริบทของการนำทาง

คุณไม่จำเป็นต้องสร้างส่วนต่อประสานที่สร้างขึ้นแบบไดนามิก แม้ว่ามันอาจจะดี แต่ก็ไม่จำเป็น หากคุณไม่สามารถสร้างอินเทอร์เฟซแบบไดนามิกให้ใช้ลิงก์และทำ ข้อเสียคือคุณจะเชื่อมโยงกับแบ็กเอนด์อย่างหนักอีกครั้งและจะเกิดปัญหาหากมีการเปลี่ยนแปลงบางอย่าง

การใช้เลย์เอาต์แบบไดนามิกสามารถทำได้ง่ายๆ btw:

links.forEach(function(link) {

  switch(link.rel) {

    case 'deposit':
      showDepositButton();
      break;

    case 'withdraw':
      loadWithdrawForm(link.href);
      showWithdrawButton();
      break;
  }

});

มันช่วยให้คุณประหยัดในรหัสลูกค้าของคุณเช่น:

if (balance <= 0 && negativeBalanceAllowed === false) {
  showWithdrawButton();
}

คุณสามารถใช้ตำแหน่งเชิงลบที่ได้รับอนุญาต (โดยการยืมเงินตัวอย่าง) โดยไม่ต้องเปลี่ยนลูกค้าของคุณ