REST යනු වෙබයේ යටින් පවතින වාස්තු විද්‍යාත්මක මූලධර්මයයි. වෙබයේ ඇති පුදුමාකාර දෙය නම් සේවාදායකයා සහ එය සපයන සත්කාරක සම්පත් පිළිබඳව සේවාදායකයා කලින් කිසිවක් නොදැන සේවාදායකයින්ට (බ්‍රව්සර්) සහ සේවාදායකයන්ට සංකීර්ණ ආකාරවලින් අන්තර්ක්‍රියා කළ හැකි වීමයි. ප්‍රධාන බාධකය නම්, සේවාදායකයා සහ සේවාදායකයා යන දෙදෙනාම භාවිතා කරන මාධ්‍යයට එකඟ විය යුතු අතර , එය වෙබයේ HTML වේ.
REST හි මූලධර්මවලට අනුකූල වන API එකකට සේවාදායකයාගේ API ව්‍යුහය ගැන කිසිවක් දැන ගැනීමට අවශ්ය නොවේ. ඒ වෙනුවට, සේවාදායකයාට සේවාව සමඟ අන්තර් ක්‍රියා කිරීමට අවශ්ය තොරතුරු සේවාදායකයාට සැපයිය යුතුය. ක HTML ආකෘති පත්රය මේ උදාහරණයක්: මෙම සේවාදායකය සම්පත් හා අවශ්ය ක්ෂේත්ර ස්ථානය දක්වයි. තොරතුරු ඉදිරිපත් කළ යුත්තේ කොතැනදැයි බ්‍රව්සරය කල්තියා නොදන්නා අතර ඉදිරිපත් කළ යුතු තොරතුරු කල්තියා නොදනී. තොරතුරු ආකාර දෙකම මුළුමනින්ම සපයනු ලබන්නේ සේවාදායකයා විසිනි. (මෙම මූලධර්මය HATEOAS ලෙස හැඳින්වේ : යෙදුම් රාජ්‍යයේ එන්ජිම ලෙස හයිපර්මීඩියා .)
ඉතින්, මෙය HTTP සඳහා අදාළ වන්නේ කෙසේද, එය ප්‍රායෝගිකව ක්‍රියාත්මක කරන්නේ කෙසේද? HTTP ක්රියාපද හා සම්පත් වටා නැඹුරු වේ. ප්‍රධාන ධාරාවේ භාවිතයේ ඇති ක්‍රියා පද දෙක වන GETඅතර POST, එය සෑම කෙනෙකුම හඳුනා ගනු ඇතැයි මම සිතමි. කෙසේ වෙතත්, HTTP ප්‍රමිතිය PUTසහ වැනි තවත් කිහිපයක් අර්ථ දක්වයි DELETE. සේවාදායකයා විසින් සපයනු ලබන උපදෙස් අනුව මෙම ක්රියාපද සම්පත් සඳහා යොදනු ලැබේ.
උදාහරණයක් ලෙස, වෙබ් සේවාවක් මගින් කළමනාකරණය කරනු ලබන පරිශීලක දත්ත ගබඩාවක් අප සතුව ඇතැයි සිතමු. අපගේ සේවා JSON මත පදනම් වූ අභිරුචි hypermedia, එය සඳහා අප mimetype අනුයුක්ත භාවිතා application/json+userdb(ද ඇති විය හැකි application/xml+userdbඅතර application/whatever+userdb- බොහෝ මාධ්ය වර්ග සහාය විය හැක). සේවාදායකයා සහ සේවාදායකයා යන දෙදෙනාම මෙම ආකෘතිය අවබෝධ කර ගැනීම සඳහා වැඩසටහන්ගත කර ඇත, නමුත් ඔවුන් එකිනෙකා ගැන කිසිවක් නොදනිති. ලෙස රෝයි දෝනි පෙන්වා දෙයි:
REST API විසින් එහි විස්තරාත්මක උත්සාහයන් සියල්ලම පාහේ සම්පත් නියෝජනය කිරීම සහ යෙදුම් තත්වය ධාවනය කිරීම සඳහා භාවිතා කරන මාධ්ය වර්ගය (ය) නිර්වචනය කිරීමට හෝ දීර් extended සම්බන්ධතා නම් නිර්වචනය කිරීමට සහ / හෝ පවතින සම්මත මාධ්ය වර්ග සඳහා අධි-පෙළ සක්‍රීය සලකුණු කිරීම සඳහා වැය කළ යුතුය.
මූලික සම්පත් සඳහා ඉල්ලීමක් /මෙවැනි දෙයක් ආපසු ලබා දිය හැකිය:
ඉල්ලීම
GET /
Accept: application/json+userdb
ප්‍රතිචාර
200 OK
Content-Type: application/json+userdb
{
"version": "1.0",
"links": [
{
"href": "/user",
"rel": "list",
"method": "GET"
},
{
"href": "/user",
"rel": "create",
"method": "POST"
}
]
}
"සබැඳි" යනුවෙන් හැඳින්වෙන කොටස් වලින් අදාළ සම්පත් පිළිබඳ තොරතුරු සොයාගත හැකි බව අපගේ මාධ්‍යයේ විස්තරයෙන් අපි දනිමු. මෙය හයිපර්මීඩියා පාලක ලෙස හැඳින්වේ . මෙම අවස්ථාවේදී, අපට එවැනි ඉල්ලීමකින් පරිශීලක ලැයිස්තුවක් සොයාගත හැකි බව එවැනි කොටසකින් අපට පැවසිය හැකිය /user:
ඉල්ලීම
GET /user
Accept: application/json+userdb
ප්‍රතිචාර
200 OK
Content-Type: application/json+userdb
{
"users": [
{
"id": 1,
"name": "Emil",
"country: "Sweden",
"links": [
{
"href": "/user/1",
"rel": "self",
"method": "GET"
},
{
"href": "/user/1",
"rel": "edit",
"method": "PUT"
},
{
"href": "/user/1",
"rel": "delete",
"method": "DELETE"
}
]
},
{
"id": 2,
"name": "Adam",
"country: "Scotland",
"links": [
{
"href": "/user/2",
"rel": "self",
"method": "GET"
},
{
"href": "/user/2",
"rel": "edit",
"method": "PUT"
},
{
"href": "/user/2",
"rel": "delete",
"method": "DELETE"
}
]
}
],
"links": [
{
"href": "/user",
"rel": "create",
"method": "POST"
}
]
}
මෙම ප්‍රතිචාරයෙන් අපට බොහෝ දේ පැවසිය හැකිය. උදාහරණයක් ලෙස, අපි විසින් කරන ලද නව පරිශීලක නිර්මාණය කළ හැකි අප දැන් දන්නා POSTආශා දනවන්නක් /user:
ඉල්ලීම
POST /user
Accept: application/json+userdb
Content-Type: application/json+userdb
{
"name": "Karl",
"country": "Austria"
}
ප්‍රතිචාර
201 Created
Content-Type: application/json+userdb
{
"user": {
"id": 3,
"name": "Karl",
"country": "Austria",
"links": [
{
"href": "/user/3",
"rel": "self",
"method": "GET"
},
{
"href": "/user/3",
"rel": "edit",
"method": "PUT"
},
{
"href": "/user/3",
"rel": "delete",
"method": "DELETE"
}
]
},
"links": {
"href": "/user",
"rel": "list",
"method": "GET"
}
}
පවතින දත්ත වෙනස් කළ හැකි බව ද අපි දනිමු:
ඉල්ලීම
PUT /user/1
Accept: application/json+userdb
Content-Type: application/json+userdb
{
"name": "Emil",
"country": "Bhutan"
}
ප්‍රතිචාර
200 OK
Content-Type: application/json+userdb
{
"user": {
"id": 1,
"name": "Emil",
"country": "Bhutan",
"links": [
{
"href": "/user/1",
"rel": "self",
"method": "GET"
},
{
"href": "/user/1",
"rel": "edit",
"method": "PUT"
},
{
"href": "/user/1",
"rel": "delete",
"method": "DELETE"
}
]
},
"links": {
"href": "/user",
"rel": "list",
"method": "GET"
}
}
අපි වෙනස් HTTP ක්රියාපද (භාවිතා කරන බව දැනුම් GET, PUT, POST, DELETEමෙම සම්පත් මෙහෙයවීම සඳහා ආදිය), සහ සේවාදායකයාගේ පැත්තෙන් අපි අනුමාන එකම දැනුම අපගේ මාධ්ය අර්ථ දැක්වීම බව.
වැඩිදුර කීයවීම:
. මුලින්ම මෙය ලිව්වේ එහි සැබෑ අර්ථයට වඩා ය. සැබෑ අර්ථය වඩා හොඳින් නිරූපණය කිරීම සඳහා මම පිළිතුර සංශෝධනය කළෙමි.)
