Modern REST, GET üzerinden çalışan GraphQL ve webhook uç noktaları; çok değerli dizileri, iç içe filtre nesnelerini, Base64 imleçlerini (cursor) ve URL kodlamalı arama ifadelerini sıklıkla tek bir sorgu dizisine veya application/x-www-form-urlencoded istek gövdesine sığdırır. Bu verileri düz bir ham metin olarak incelemek veya düzenlemek, bozuk %26 kaçış dizilerine ve eşleşmeyen parantezlere yol açar.
+ ile kodlanmış boşlukları, tekrarlanan anahtarları, iç içe parantezli filtreleri, yüzde kodlamalı = dolgusu (padding) içeren bir Base64 sayfalama imlecini ve değersiz bir bayrak (flag) parametresini birleştiren şu API arama sorgusunu ele alalım:
?q=distributed+tracing&tag=otel&tag=grpc&filter[status]=open&filter[priority]=high&cursor=eyJpZCI6NDIwfQ%3D%3D&dry_run
Bu diziyi ayrıştırmak, anında okunabilir ve güçlü bir şekilde yapılandırılmış bir JSON temsili üretir:
{
"q": "distributed tracing",
"tag": [
"otel",
"grpc"
],
"filter": {
"status": "open",
"priority": "high"
},
"cursor": "eyJpZCI6NDIwfQ==",
"dry_run": ""
}
Sınırlayıcı Bölme İşlemi Neden Yüzde Çözümlemeden Önce Gelmelidir?
cursor=eyJpZCI6NDIwfQ%3D%3D ifadesinin nasıl temiz bir şekilde "eyJpZCI6NDIwfQ==" değerine çözümlendiğine dikkat edin. Ayrıştırıcı önce ham diziyi & karakterlerinden böler, her çifti ilk düz = karakterinden ayırır ve ancak bundan sonra + ile %XX dizilerinin kodunu çözer. Basit bir betik & ve = üzerinden bölme yapmadan önce tüm sorgu dizisi üzerinde decodeURIComponent() çalıştırsaydı, kaçış karakterli bir ve işareti (R%26D -> R&D) içeren herhangi bir parametre değeri iki hatalı parametreye bölünürdü.
JSON görünümü ve anahtar-değer tablosu çift yönlü olarak senkronize kaldığından, uygulama kodunuzdan bir JSON filtre nesnesi yapıştırabilir ve HTTP istekleri için hazır, düzgünce kodlanmış bir sorgu dizisini anında serileştirebilirsiniz.