නව QUERY HTTP ක්‍රමය .NET 10 සමඟ: 600+ ෆිල්ටර් 414 දෝෂය තවත් නොවේ!

ASP.NET Core සංවර්ධකයන්ට නව HTTP ක්‍රමයක් – QUERY – .NET 10 සමඟ පැමිණේ. මේ ක්‍රමය, URL දිග වැඩිවීම නිසා සිදුවන 414 Request‑URI Too Long දෝෂය ඉවත් කරයි, විශේෂයෙන් බොහෝ SKU (Stock Keeping Unit) ගණනක් සමඟ නිෂ්පාදන සෙවීම් කරන වෙළඳපලේ.

කථාංගයක් ලෙස, පාරිභෝගිකයන්ට නිෂ්පාදන සෙවීමට GET ඉල්ලීමේ query string තුළ sku පරාමිතීන් එක් කර ඇත. 100, 200, … 600 දක්වා ෆිල්ටර් එකතු කරද්දී, Kestrel සර්වර්ගේ 8 KB ඉල්ලීම් රේඛා සීමාව හේතුවෙන් 600‑වෙනි ෆිල්ටර් පසු 414 දෝෂයක් ලැබුණි.

GET‑හි බොඩි යෙදීම නිර්දේශ නොකළ නිසා, POST භාවිතා කිරීම “දත්ත වෙනස් විය හැකිය” කියා කෑෂ් පද්ධතිවලට ගැටළුවක් වෙයි. Header තුළ ෆිල්ටර් රැඳවීමද තාවකාලික විසඳුමක් පමණක්. ඒ වෙනුවට, RFC 1008 විසින් නව HTTP ක්‍රමයක් ලෙස QUERY නිර්දේශ කර තිබේ. මෙය ඉල්ලීම් බොඩියට JSON දත්ත රැගෙන යයි, එමඟින් ආරක්ෂිත, idempotent, cache‑able වීමේ ගුණාංග රැගෙන එයි.

ASP.NET Core 10 තුළ QUERY ක්‍රමය භාවිතා කිරීම සඳහා MapMethods හරහා මාර්ගයක් සකස් කරයි. උදාහරණයක්:

app.MapMethods("/products/search", new[] { HttpMethods.Query }, async ctx => { var filter = await JsonSerializer.DeserializeAsync(ctx.Request.Body); var result = RunSearch(filter.Skus, filter.MaxPrice); ctx.Response.Headers.ContentLocation = $"/products/search-results/{result.Execution}"; return Results.Ok(result); });

කාර්ය සාධනයේදී, Content‑Type හිස් නම් හෝ JSON නොවේ නම් 400/415 පළ කිරීම අත්‍යවශ්‍ය වේ. එය සිදුකළ නොහොත් ASP.NET Core එම වැරදි පරීක්ෂා නොකරයි.

ශ්‍රී ලංකාවට ඇති වැදගත්කම

ශ්‍රී ලංකාවේ තාක්ෂණික සමාගම්, e‑commerce වෙළඳපල, සහ විශ්වවිද්‍යාල සිසුන්ට මේ නව QUERY ක්‍රමය විශාල වාසියක් ගෙනෙනු ඇත:

• දෘඩාංග සීමා නොමැති API – බොහෝ SKU සමඟ සෙවීම් කරන වෙළඳපලවල 414 දෝෂය නැතිවෙයි.
• කෑෂ්‑හිතකාමී ඉල්ලීම් – GET‑වල වාගේම QUERY‑ද cache‑able, එයින් පරිශීලක අත්දැකීම වේගවත් වේ.
• අදාල ලේඛන සහිත API – Content‑Location ශීර්ෂකය මඟින් GET URL එකක් ලබා දී, ඊළඟ ප්‍රවේශය පහසු කරයි.
• දේශීය සංවර්ධකයන්ට නව දක්ෂතා – .NET 10 නව API ක්‍රමය ඉගෙන ගැනීම, ග්ලෝබල් තාක්ෂණ සමඟ සමාන වේගයෙන් ඉදිරියට යාමට උපකාරී.

ඉදිරියේදී, .NET 10 හි QUERY ක්‍රමය සමඟ ASP.NET Core වෙබ් API සෑදීම, ශ්‍රී ලංකාවේ තාක්ෂණික ආරම්භකයන්ට සහ ව්‍යාපාරිකයින්ට තරඟකාරීත්වය වැඩි කරයි.

සාරාංශයෙන්, QUERY ක්‍රමය GET‑වල URL දිග සීමාව ඉක්මවා යන ප්‍රශ්නයට පරිශුද්ධ විසඳුමක්. .NET 10 භාවිතා කරන සංවර්ධකයන්ට මේ අලුත් පියවර අත්හදා බැලීමට දැන් සුදුසු වේ.