JSON فارمیٹر اور ویلیڈیٹر

JSON کی تعریف RFC 8259 میں کی گئی ہے (جو اپنی اصل میں ECMA-404 جیسی ہے)۔ ایک دستاویز صرف ایک ویلیو ہوتی ہے: آبجیکٹ، ارے، اسٹرنگ، نمبر، true، false یا null۔ آبجیکٹ کی کیز ہمیشہ ڈبل کوٹس میں اسٹرنگ ہوتی ہیں۔ اسٹرنگ میں صرف ڈبل کوٹس چلتے ہیں اور کوٹ، بیک سلیش اور U+0020 سے نیچے کے ہر کنٹرول کریکٹر کو ایسکیپ کرنا لازمی ہے؛ اس لیے اسٹرنگ کے اندر ٹیب اور نئی لائن \t اور \n کی صورت میں لکھی جاتی ہیں۔ RFC 8259 یہ بھی لازمی قرار دیتا ہے کہ سسٹمز کے درمیان بھیجا جانے والا JSON UTF-8 میں ہو۔

نمبر اعشاری ہوتے ہیں: شروع میں صفر نہیں، ہیکسا ڈیسیمل نہیں، NaN یا Infinity نہیں، اور آگے پلس کا نشان نہیں۔ اس فارمیٹ میں کمنٹس نہیں ہوتے اور آخر میں اضافی کوما بھی نہیں چلتا۔ حقیقی دنیا کی زیادہ تر غلطیاں انہی دو اصولوں سے ہوتی ہیں، کیونکہ JavaScript آبجیکٹ لٹرلز، JSON5 اور کئی کنفیگ فائلیں دونوں کی اجازت دیتی ہیں۔ نیچے دیا گیا حوالہ جاتی جدول ہر عام غلطی کو اسی پارسر میں چلا کر بنایا گیا ہے جو فارمیٹر استعمال کرتا ہے۔

پریٹی پرنٹنگ میں لائن بریک اور انڈینٹیشن شامل ہوتی ہے تاکہ ساخت پڑھنے میں آسان ہو؛ JavaScript پروجیکٹس میں دو اسپیس سب سے عام ہیں، Python کے json.dumps(indent=4) کے ساتھ چار اسپیس عام انتخاب ہیں، اور ٹیب ہر قاری کو اپنی چوڑائی چننے دیتے ہیں۔ منیفائی ہر غیر ضروری اسپیس ہٹا دیتا ہے، جس سے API پے لوڈ چھوٹے ہوتے ہیں اور دستاویز لاگز یا انوائرنمنٹ ویری ایبلز کے لیے ایک لائن میں آ جاتی ہے۔

کیز ترتیب دیں ہر آبجیکٹ کے اراکین کو حروفِ تہجی کی ترتیب میں رکھتا ہے، اندر تک ہر سطح پر۔ تعریف کے مطابق JSON آبجیکٹ غیر ترتیب شدہ ہوتے ہیں، اس لیے ترتیب سے مفہوم نہیں بدلتا، مگر مختلف سسٹمز کی دو دستاویزات کا موازنہ بہت آسان ہو جاتا ہے۔ یاد رکھیں کہ پارسنگ نمبروں کو JavaScript ڈبلز میں بدل دیتی ہے: 2^53 (9,007,199,254,740,992) سے بڑے عدد، جیسے بعض ڈیٹا بیس IDs، دوبارہ فارمیٹ کرنے پر درستگی کھو دیتے ہیں، اس لیے انہیں اسٹرنگ کے طور پر رکھیں۔

فارمیٹ شدہ دستاویز پڑھنا آسان ہوتا ہے، لیکن کبھی اسے دوسری شکل میں چاہیے ہوتا ہے۔ آبجیکٹس کی ارے JSON سے CSV کے ذریعے اسپریڈشیٹ بن جاتی ہے، اور ڈیٹا کنورٹر پوری فائلوں کو JSON، XML، YAML اور CSV کے درمیان منتقل کرتا ہے۔