🌐 Stateless REST තේරුම් ගනිමු: ඔබේ API එකට කිසිවක් මතක තියාගන්න බැරි ඇයි? 🧠❌

 REST API ගැන ඉගෙන ගන්න පටන් ගන්නකොට නිතරම අහන්නට ලැබෙන වචනයක් තමයි stateless කියන එක. 🔁 ඇහෙන්නේ සරලයි වගේ, නමුත් ඇත්තටම මේක තමයි නවීන වෙබ් තාක්ෂණයේ පදනම් වූ වැදගත්ම architectural තීරණයක්. ඉතින් සරලවම මේක තේරුම් ගමු. 👇

🤔 "Stateless" කියන්නේ ඇත්තටම මොකක්ද?

Stateless පද්ධතියක සර්වර් 🖥️ එක client ගේ පෙර requests ගැන කිසිම දෙයක් මතක තියාගන්නේ නැහැ. Client කෙනෙකුගෙන් server එකට එන හැම request එකකම, ඒ request එක තේරුම් ගන්නත් process කරන්නත් අවශ්‍ය සම්පූර්ණ තොරතුරු 📦 තිබෙන්නම ඕන — server එකට "කලින් මතක තියෙන" කිසිම දෙයක් නැහැ.

මේක fast-food කවුන්ටරයක ආහාර order කරනවා වගේ දෙයක්. 🍔 හැම වතාවෙම ඔබ ගිහින් ඔබේ සම්පූර්ණ order එක නැවත කියන්න ඕන — "බර්ගර් එකක්, ළූණු නෑ, චීස් වැඩිය, මධ්‍යම ප්‍රමාණයේ ෆ්‍රයිස්, කෝලා එකක්" කියලා 🍟🥤. කැෂියර්ට මතක නැහැ ඔබ පසුගිය සතියේ order කළේ මොකක්ද, මිනිත්තු පහකට කලින් වුනත් සරි. හැම order එකක්ම එකිනෙකට වෙන් වෙලා තියෙනවා. ✅

🏗️ REST APIs වල මේක වැඩ කරන්නේ කොහොමද?

Stateless REST API එකක:

• 🔑 Client එක authentication විස්තර (token එකක් වගේ) හැම request එකකම එක්කම යවනවා.
• 📨 අවශ්‍ය parameters සහ context සියල්ල client එකම request එකේ ඇතුළත් කරනවා.
• 🗄️ Server එක ඒ request එකේ තියෙන දේ විතරක් පාවිච්චි කරලා process කරනවා — server side එකේ session data කිසිවක් store කරලා නැහැ.
• 📤 Server එක response එකක් යවලා, ඊට පස්සේ ඒ interaction එක අමතක කරනවා.

උදාහරණයක් විදිහට, user details ලබාගන්න API එකක් call කරද්දී:

GET /users/123
Authorization: Bearer <token> 🔐

Server එක token එක check කරලා, user 123 ගේ විස්තර ගෙනැල්ලා, response දෙනවා. "කලින් කවුද මොනවද ඇහුවේ" කියන එක track කරලා නැහැ. හැම request එකක්ම අලුතින් විනිශ්චය කරනවා. 🆕

🎯 Statelessness වැදගත් වෙන්නේ ඇයි?

1. 📈 Scalability (පරිමාණය)

කිසිම server එකක session data store කරලා නැති නිසා, requests ඕනෑම server එකකට cluster එකේ handle කරන්න පුළුවන්. Load balancers 🔄 වලට traffic එක multiple machines වලට නිදහසේ බෙදන්න පුළුවන්, කවුරු client එක "මතක තියාගෙන" ඉන්නවද කියලා හිතන්නවත් අවශ්‍ය නැතුව.

2. 🛠️ Simplicity (සරලත්වය)

Developers ට server එකේ complex session storage, synchronization, expiration logic manage කරන්න අවශ්‍ය නැහැ. අඩු state = අඩු bugs 🐛 සහ පහසු debugging.

3. 🔄 Reliability (විශ්වසනීයත්වය)

එක server එකක් crash 💥 වුනොත්, තව server එකකට වහාම එය භාරගන්න පුළුවන් — මොකද කිසිම server එකක unique, replace කරන්න බැරි session data නැති නිසා. මේකෙන් පද්ධති වඩාත් fault-tolerant වෙනවා.

4. 🚀 Better Caching

Requests self-contained සහ predictable නිසා, responses වඩාත් effectively cache 🗃️ කරන්න පුළුවන්, repeated requests වල performance එක වැඩි කරගන්න.

⚖️ ගෙවිය යුතු මිල

Statelessness නොමිලේ ලැබෙන්නේ නැහැ. 💸 හැම request එකක්ම සම්පූර්ණ context එකක් රැගෙන යා යුතු නිසා, payloads ටිකක් විශාල 📦➕ වෙන්න පුළුවන්, සහ clients (mobile apps 📱 හෝ browsers 🌍 වගේ) tokens, session-like data, state manage කරගැනීමේ වගකීම වැඩිපුර භාරගන්නවා (බොහෝවිට cookies, local storage, හෝ JWTs හරහා).

🧩 සැබෑ ලෝකයේ උපමාවක්

හෝටල් receptionist 🏨 කෙනෙක් amnesia තියෙන කෙනෙක් කියලා හිතන්න, එයාට front desk එකෙන් ගියාම හැම guest කෙනෙක්ම අමතක වෙනවා. හැම වතාවෙම ඔබ ළඟට එනකොට, ඔබේ room key 🔑 සහ ID 🪪 නැවත පෙන්වන්න ඕන. කරදරයක්ද? ටිකක් වෙන්න පුළුවන්. නමුත් ඒකෙන් අදහස් වෙන්නේ ඕනෑම shift එකක ඕනෑම receptionist කෙනෙකුට ඔබට ක්ෂණිකව උදව් කරන්න පුළුවන් කියලා, ඔබේ history එක "catch up" කරගන්න අවශ්‍ය නැතුව. ඒක තමයි statelessness වල බලය. 💪

✅ නිගමනය

Stateless REST design කියන්නේ scalable, reliable, සරල web services හදන්න පදනම් 🧱 වුනු දෙයක්. මේකෙන් client එකට වඩාත් වගකීම් පවරද්දී, scalability 📈, fault tolerance 🛡️, simplicity 🎯 වල ලැබෙන ප්‍රතිලාභ නිසා නවීන APIs සඳහා අගය කරන approach එක මේකයි — ඔබේ ප්‍රියතම mobile apps 📱 සිට විශාල cloud platforms ☁️ දක්වා හැම දෙයක්ම බලගන්වන්නේ මේකෙන්.

ඊළඟ වතාවේ ඔබ API request එකක් යවනකොට, මතක තියාගන්න: server එකට ඔබ ගැන කිසිම මතකයක් නැහැ. හැම request එකක්ම අලුත් හඳුනාගැනීමක්. 👋🌟