در این بخش، سلیب قرار است تا امکان ذخیره مقدار (Value) جدید پنبه برای یک کلید (Key) دلخواه را فراهم کند. ابتدا بررسی می‌شود آیا کلید (key) و مقدار (value) در Query String درخواست وجود دارد یا خیر. سپس با استفاده از تابع هش گفته شده، مشخص می‌شود کلید در کدام شارد (Shard) کلاستر ردیسی (Redis Cluster) قرار دارد. شارد هر کلید $key$ به این صورت مشخص خواهد شد:

$$FNV-1a(key) mod 3 + 1$$

• طبق رابطه بالا، پس از محاسبه هش کلید key باقی‌مانده آن را بر ۳ محاسبه کرده و یکی شیفت می‌دهیم تا شارد (Shard) نهایی‌اش محاسبه شود.

پس از محاسبه شارد کلید مورد نظر و افزودن مقدار آن کلید در نود مورد مشخص شده (یا Replica ی آن)، در صورتی که این ذخیره‌سازی موفق بود، خروجی باید یک JSON شامل وضعیت (status) موفقیت (OK)، کلید (key)، مقدار (value) ذخیره‌شده و نام شارد (shard) باشد.

اگر مقدار یا کلید ارسال نشده باشند، باید خطایی با کد 400 به همراه پیام مناسب نمایش داده شود. اگر عملیات SET شکست بخورد (مثلاً ردیسی در دسترس نباشد)، باید خطای 500 به همراه پیام مناسب بازگردانده می‌شود.

همانطور که پیش‌تر توضیح داده شد، در مسیر /set، درخواست‌هایی برای ثبت مقدار (value) برای یک کلید (key) خاص ارسال می‌شوند. این بخش به طور کلی شامل مراحل زیر است:

مراحل پیاده‌سازی

• بررسی وجود key و value در Query String.

• محاسبه هش FNV-1a روی key برای تعیین شارد کلید (یکی از shard1, shard2, shard3).

• تلاش برای اتصال به نود اصلی (Primary Node) ردیس مربوطه.

• تلاش برای اتصال به نود Replica ی شارد مورد نظر در صورت در دسترس نبود نود اصلی، مثلا در صورتی که شارد کلیدی shard1 باشد، سرویس OpenResty باید سعی کند تا به نود ردیسی redis1 متصل شود و در صورت شکست، به نود Replica ی آن یعنی redis1r متصل شود.

• ذخیره‌سازی مقدار مورد نظر برای کلید در دیتابیس ردیسی

• بازگرداندن JSON با کد 200 شامل اطلاعات key, value, shard, status.

مثال‌ها

درخواست‌های موفق برای ثبت مقدار جدید

curl "http://localhost:8080/set?key=key3&value=value3"

{
  "key": "key3",
  "value": "value3",
  "status": "OK",
  "shard": "shard1"
}

curl "http://localhost:8080/set?key=key1&value=value1"

{
  "key": "key2",
  "value": "value2",
  "status": "OK",
  "shard": "shard2"
}

curl "http://localhost:8080/set?key=key6&value=value6"

{
  "key": "key6",
  "value": "value6",
  "status": "OK",
  "shard": "shard3"
}

درخواست‌های ‌نا‌موفق برای ثبت مقدار جدید، بدون کلید و مقدار

curl "http://localhost:8080/set?value=blue"

{
  "error": "Missing 'key'"
}

curl "http://localhost:8080/set?key=color"

{
  "error": "Missing 'value'"
}

درخواست‌ ‌نا‌موفق برای ثبت مقدار جدید، در دسترس نبودن همزمان نود اصلی و Replica

curl "http://localhost:8080/set?key=color&value=green"

{
  "error": "Redis unavailable"
}