JSON اسکیما کے لیے گائیڈ
اس سے پہلے کہ ہم JSON اسکیما میں جائیں، JSON اور JSON اسکیما کے درمیان فرق جاننا ضروری ہے۔
JSON
JSON JavaScript آبجیکٹ نوٹیشن کے لیے مختصر ہے، اور یہ ایک زبان سے آزاد ڈیٹا فارمیٹ ہے جسے APIs درخواستیں اور جوابات بھیجنے کے لیے استعمال کرتے ہیں۔ JSON لوگوں اور مشینوں کے لیے یکساں پڑھنے اور لکھنے میں آسان ہے۔ JSON ایک متن پر مبنی فارمیٹ ہے جو زبان کا پابند نہیں ہے (زبان آزاد)۔
JSON اسکیما
JSON Schema JSON ڈیٹا سٹرکچر کی تصدیق کے لیے ایک مفید ٹول ہے۔ JSON کی ساخت بتانے کے لیے، JSON پر مبنی فارمیٹ استعمال کریں۔ اس کا مقصد یہ یقینی بنانا ہے کہ JSON ڈیٹا قابل قبول ہے۔ ہماری ایپلیکیشن کے JSON ڈیٹا کے کنونشن کی وضاحت اسکیما کے ذریعے کی جا سکتی ہے۔
JSON اسکیما تفصیلات کے تین اہم حصے ہیں:
JSON ہائپر اسکیما:
JSON Hyper-Schema ایک JSON اسکیما زبان ہے جو JSON دستاویزات کو ہائپر لنکس کے ساتھ لیبل کرنے کے لیے استعمال کی جا سکتی ہے اور متن کے ذریعے بیرونی JSON وسائل کو تبدیل کرنے اور تبدیل کرنے کے لیے ہدایات جیسے HTTP پر مبنی ماحول۔ کلک کریں۔ یہاں JSON Hyper-Schema کے بارے میں مزید جاننے کے لیے۔
JSON اسکیما کور:
یہ JSON دستاویزات کو لیبل لگانے اور ان کی توثیق کرنے کے لیے قواعد کا ایک مجموعہ ہے۔
JSON اسکیما کور:
- اس وقت آپ کے پاس موجود ڈیٹا فارمیٹ کی وضاحت کرتا ہے۔
- ڈیٹا کی توثیق کرتا ہے جسے خودکار جانچ میں استعمال کیا جا سکتا ہے۔
- گاہکوں کی طرف سے دیے گئے ڈیٹا کی درستگی کو یقینی بنانا۔
- انسانوں اور مشینوں دونوں کے لیے پڑھنے کے قابل دستاویزات فراہم کرتا ہے۔
JSON اسکیما کی توثیق:
JSON اسکیما پر مبنی توثیق مثال کے اعداد و شمار کے ڈھانچے پر حدیں عائد کرتی ہے۔ اس کے بعد، کوئی بھی مطلوبہ الفاظ جس میں غیر دعویٰ ہو۔ معلومات، جیسا کہ وضاحتی میٹا ڈیٹا اور استعمال کے اشارے، مثال کی پوزیشن میں شامل کیے جاتے ہیں جو تمام اعلان کردہ رکاوٹوں کو پورا کرتا ہے۔
Newtonsoft کا JSON اسکیما Validator ٹول ایک ایسا ٹول ہے جسے آپ اپنے براؤزر میں بلا معاوضہ استعمال کر سکتے ہیں۔ آپ اپنے JSON اسکیما کی ساخت کو جانچنے کے لیے اس ٹول کا استعمال کر سکتے ہیں۔ یہ صفحہ آپ کو شروع کرنے کے لیے کنٹرولز اور وضاحتوں پر مشتمل ہے۔ اس طرح، یہ دیکھنا آسان ہے کہ اپنے JSON ڈھانچے کو کیسے بہتر بنایا جائے۔
ہم اپنے JSON آبجیکٹ کو JSON اسکیما توثیق کے آلے کا استعمال کرتے ہوئے چیک کر سکتے ہیں:
ہمارے پاس عمر کی توثیق ہے (کم از کم = 20 اور زیادہ سے زیادہ = 40) جیسا کہ اوپر کی تصویر میں دکھایا گیا ہے۔ کوئی غلطیاں نہیں پائی گئیں۔
اگر عمر کی توثیق غلط طریقے سے درج کی گئی تھی تو اس نے ایک غلطی ظاہر کی۔
JSON اسکیما کی تخلیق
آئیے یہ دیکھنے کے لیے JSON اسکیما کی ایک مثال دیکھیں کہ ہم کس کے بارے میں بات کر رہے ہیں۔ ایک بنیادی JSON آبجیکٹ جو پروڈکٹ کیٹلاگ کو بیان کرتا ہے اس طرح ہے:
اس کا JSON اسکیما اس طرح لکھا جا سکتا ہے:
ایک JSON سکیما ایک JSON دستاویز ہے، اور وہ دستاویز ایک آبجیکٹ ہونی چاہیے۔ کلیدی الفاظ JSON اسکیما کے ذریعہ متعین کردہ آبجیکٹ ممبرز/خصوصیات ہیں۔ JSON اسکیما میں "کلیدی الفاظ" کسی شے میں کلید/قدر کے امتزاج کے "کلیدی" حصے کا حوالہ دیتے ہیں۔ JSON اسکیما لکھنے میں زیادہ تر حصے کے لیے کسی چیز کے اندر ایک قدر کے ساتھ ایک خاص "کلیدی لفظ" کا نقشہ بنانا شامل ہے۔
آئیے ہم نے اپنی مثال میں استعمال کیے گئے مطلوبہ الفاظ پر گہری نظر ڈالیں:
JSON اسکیما جس پر وسائل کا اسکیما تعمیل کرتا ہے اس وصف کے ذریعہ لکھا جاتا ہے۔ یہ اسکیما ڈرافٹ v4 معیار کے بعد لکھا گیا ہے، جیسا کہ "ma اسکیما"کلیدی لفظ. یہ آپ کے اسکیما کو موجودہ ورژن پر واپس آنے سے روکتا ہے، جو پرانے ورژن کے ساتھ مطابقت رکھتا ہے یا نہیں بھی۔
"عنوان"اور"تفصیل" مطلوبہ الفاظ صرف وضاحتی ہیں؛ وہ چیک کیے جانے والے ڈیٹا پر کوئی پابندی عائد نہیں کرتے ہیں۔ یہ دو مطلوبہ الفاظ اسکیما کے مقصد کو بیان کرتے ہیں: یہ ایک پروڈکٹ کی وضاحت کرتا ہے۔
"قسم” کلیدی لفظ ہمارے JSON ڈیٹا کی پہلی باؤنڈری حالت کی وضاحت کرتا ہے۔ یہ JSON آبجیکٹ ہونا چاہیے۔ اگر ہم تمام اسکیموں کے لیے ٹائپ سیٹ نہیں کرتے ہیں تو کوڈ کام نہیں کرے گا۔ کچھ عام قسمیں ہیں "نمبر" "بولین" "انٹیجر" "نول" "آبجیکٹ" "ارے" "سٹرنگ"۔
JSON اسکیما کو درج ذیل لائبریریوں سے تعاون حاصل ہے:
زبان | لائبریری |
C | ڈبلیو جے ایلیمنٹ |
ازگر | jschon |
پی ایچ پی | آپس Json سکیما |
جاوا سکرپٹ | اے جے وی |
Go | gojsonschema |
کوٹلن | میڈیا کی توثیق کرنے والا |
روبی | JSONSchemer |
JSON (نحو)
آئیے JSON کے بنیادی نحو پر ایک مختصر نظر ڈالتے ہیں۔ JSON نحو جاوا اسکرپٹ نحو کا ایک ذیلی سیٹ ہے جس میں درج ذیل عناصر شامل ہیں:
- نام/قدر کے جوڑے استعمال کیے جاتے ہیں جو ڈیٹا کی نمائندگی کرتے ہیں۔
- اشیاء کو گھوبگھرالی منحنی خطوط وحدانی میں رکھا جاتا ہے، اور ہر نام کی قیادت ایک ':' (بڑی آنت) سے ہوتی ہے، جس میں قدر کے جوڑے “,” (کوما) سے الگ ہوتے ہیں۔
- قدروں کو "،" (کوما) سے الگ کیا جاتا ہے اور صفوں کو مربع بریکٹ میں رکھا جاتا ہے۔
مندرجہ ذیل دو ڈیٹا ڈھانچے JSON کے ذریعہ تعاون یافتہ ہیں:
- قدروں کی ترتیب شدہ فہرست: یہ ایک صف، ایک فہرست، یا ایک ویکٹر ہو سکتا ہے۔
- نام/قدر کے جوڑوں کا مجموعہ: کمپیوٹر کی مختلف زبانیں اس ڈیٹا سٹرکچر کو سپورٹ کرتی ہیں۔
JSON (آبجیکٹ)
JSON اسکیما ایک JSON آبجیکٹ ہے جو مختلف JSON آبجیکٹ کی قسم اور ساخت کا خاکہ پیش کرتا ہے۔ JavaScript آبجیکٹ ایکسپریشن JavaScript رن ٹائم ماحول میں JSON آبجیکٹ کی نمائندگی کر سکتا ہے۔ درست اسکیما آبجیکٹ کی کچھ مثالیں درج ذیل ہیں:
سکیم | میچ |
{} | کوئی قدر |
{ قسم: 'آبجیکٹ' } | جاوا اسکرپٹ آبجیکٹ |
{قسم: 'نمبر' } | جاوا اسکرپٹ نمبر |
{قسم: 'سٹرنگ'} | جاوا اسکرپٹ کی تار |
جیسے:
ایک نئی چیز بنانا جو خالی ہے:
var JSON_Obj = {};
نئی آبجیکٹ کی تخلیق:
var JSON_Obj = نئی آبجیکٹ()
JSON (XML کے ساتھ موازنہ)
JSON اور XML زبان سے آزاد انسان کے پڑھنے کے قابل فارمیٹس ہیں۔ حقیقی دنیا کے منظرناموں میں، وہ دونوں تخلیق، پڑھ اور ڈی کوڈ کر سکتے ہیں۔ درج ذیل معیارات کی بنیاد پر، ہم JSON کا XML سے موازنہ کر سکتے ہیں۔
پیچیدگی
چونکہ XML JSON سے زیادہ پیچیدہ ہے، پروگرامرز JSON کو ترجیح دیتے ہیں۔
Arrays کا استعمال
XML کا استعمال سٹرکچرڈ ڈیٹا کے اظہار کے لیے کیا جاتا ہے۔ تاہم، XML صفوں کی حمایت نہیں کرتا، لیکن JSON کرتا ہے۔
پارس کرنا
JSON کی تشریح JavaScript کے eval فنکشن کے ذریعے کی جاتی ہے۔ eval بیان کردہ آبجیکٹ واپس کرتا ہے جب JSON کے ساتھ استعمال ہوتا ہے۔
: مثال کے طور پر
JSON | XML |
{ "کمپنی": فیراری، "نام": "GTS"، "قیمت": 404000 } |
فراری
جی ٹی ایس
404000
|
JSON اسکیما کے فوائد
JSON کو انسانی اور مشین کے ذریعے پڑھنے کے قابل زبان میں انحراف کرنے کے لیے ڈیزائن کیا گیا ہے۔ تاہم، کچھ ٹھیک ٹیوننگ کے بغیر، یہ نہیں ہو سکتا. JSON اسکیما میں JSON کو مشینوں اور انسانوں دونوں کے لیے زیادہ قابل فہم بنانے کا فائدہ ہے۔
JSON اسکیما کا استعمال متعدد کلائنٹ سائیڈ اپ ڈیٹس کی ضرورت کو بھی دور کرتا ہے۔ عام ایچ ٹی ایم ایل کوڈز کی فہرست بنانا اور پھر انہیں کلائنٹ سائیڈ پر لاگو کرنا کلائنٹ سائیڈ کی تعمیر کا ایک عام لیکن غلط طریقہ ہے۔ API ایپس تاہم، یہ سب سے بڑی حکمت عملی نہیں ہے کیونکہ سرور سائیڈ پر تبدیلیاں بعض افعال کو خراب کرنے کا سبب بن سکتی ہیں۔
JSON اسکیما کا بنیادی فائدہ مختلف پروگرامنگ زبانوں کے ساتھ اس کی مطابقت کے ساتھ ساتھ درستگی اور توثیق کی مستقل مزاجی ہے۔
JSON اسکیما براؤزرز کی وسیع رینج کو سپورٹ کرتا ہے اور آپریٹنگ سسٹملہذا JSON میں لکھی گئی ایپس کو تمام براؤزر کو ہم آہنگ بنانے کے لیے زیادہ محنت نہیں کرنی پڑتی۔ ترقی کے دوران، ڈویلپرز کئی براؤزرز پر غور کرتے ہیں، حالانکہ JSON کے پاس پہلے سے ہی صلاحیتیں موجود ہیں۔
JSON آڈیو، ویڈیو اور دیگر میڈیا سمیت کسی بھی سائز کا ڈیٹا شیئر کرنے کا سب سے موثر طریقہ ہے۔ یہ اس حقیقت کی وجہ سے ہے کہ JSON ڈیٹا کو صفوں میں محفوظ کرتا ہے، جس سے ڈیٹا کی منتقلی آسان ہو جاتی ہے۔ نتیجے کے طور پر، JSON آن لائن APIs اور ترقی کے لیے بہترین فائل فارمیٹ ہے۔
جیسے جیسے APIs زیادہ عام ہو رہے ہیں، یہ سمجھنا منطقی ہے کہ API کی توثیق اور جانچ تیزی سے اہم ہو جائے گی۔ یہ توقع کرنا بھی حقیقت پسندانہ ہے کہ وقت کے ساتھ ساتھ JSON کے زیادہ آسان ہونے کا امکان نہیں ہے۔ اس سے یہ ظاہر ہوتا ہے کہ آپ کے ڈیٹا کے لیے اسکیما ہونا وقت کے ساتھ ساتھ مزید نازک ہونے والا ہے۔ چونکہ JSON APIs کے ساتھ کام کرنے کے لیے معیاری فائل فارمیٹ ہے، JSON اسکیما APIs کے ساتھ کام کرنے والوں کے لیے ایک اچھا متبادل ہے۔
