JSON فارمیٹر

اس سادہ ٹول کے ساتھ اپنے JSON کو فارمیٹ اور خوبصورت بنائیں

خام JSON ان پٹ*

فارمیٹ شدہ JSON آؤٹ پٹ

فارمیٹ شدہ JSON یہاں ظاہر ہوگا...

JSON Formatter

تعارف

JSON (JavaScript Object Notation) ایک ہلکا پھلکا ڈیٹا تبادلے کا فارمیٹ ہے جو ویب ایپلیکیشنز میں ڈیٹا کے تبادلے کے لیے معیاری بن چکا ہے۔ اس کی سادگی کے باوجود، JSON ڈیٹا غیر منظم یا مناسب فارمیٹنگ کی کمی کی صورت میں پڑھنے میں مشکل ہو سکتا ہے۔ یہ ٹول آپ کی مدد کرتا ہے کہ خام، غیر منظم JSON سٹرنگز کو ایک اچھی طرح سے منظم، انڈینٹڈ فارمیٹ میں تبدیل کیا جائے جو پڑھنے اور تجزیہ کرنے میں بہت آسان ہو۔

JSON کی فارمیٹنگ (جسے "پریٹی پرنٹنگ" بھی کہا جاتا ہے) کمپیکٹ، منیفائیڈ JSON میں مستقل انڈینٹیشن، لائن بریک، اور اسپیسنگ شامل کرتی ہے تاکہ JSON ڈیٹا کے ہیرارکی کی ساخت بصری طور پر واضح ہو سکے۔ یہ خاص طور پر پیچیدہ نیسٹڈ آبجیکٹس یا بڑے ڈیٹا سیٹس کے ساتھ کام کرتے وقت قیمتی ہوتا ہے جہاں عناصر کے درمیان تعلقات بصورت دیگر سمجھنا مشکل ہو سکتا ہے۔

ہمارا JSON فارمیٹر ٹول آپ کے JSON ڈیٹا کو مناسب انڈینٹیشن اور ساخت کے ساتھ خوبصورت بنانے کے لیے ایک سادہ انٹرفیس فراہم کرتا ہے، جس سے یہ انسانوں کے لیے زیادہ پڑھنے کے قابل ہے جبکہ مشینوں کے لیے اس کی درستگی برقرار رہتی ہے۔

JSON کی نحو اور ساخت

JSON دو بنیادی ساختوں پر مبنی ہے:

آبجیکٹس: نام/قدر کے جوڑوں کے مجموعے جو کہ curly braces {} میں بند ہوتے ہیں۔ ہر نام کے بعد ایک کولن : ہوتا ہے اور جوڑے کو کاما , سے الگ کیا جاتا ہے۔

   {"name": "جان", "age": 30, "city": "نیویارک"}

ایریاز: اقدار کی ترتیب جو کہ square brackets [] میں بند ہوتی ہیں۔ اقدار کو کاما , سے الگ کیا جاتا ہے۔

   ["سیب", "کیلا", "چیری"]

JSON کی اقدار ہو سکتی ہیں:

سٹرنگز (ڈبل کوٹس میں): "ہیلو ورلڈ"
نمبر: 42 یا 3.14159
بولین: true یا false
نل: null
آبجیکٹس: {"key": "value"}
ایریاز: [1, 2, 3]

صحیح JSON کو ان نحو کے قواعد کی پیروی کرنی چاہیے:

ناموں کو ڈبل کوٹس میں ہونا چاہیے
اقدار کو ایک درست JSON ڈیٹا ٹائپ میں ہونا چاہیے
کوئی ٹریلنگ کاما نہیں ہونا چاہیے
کوئی تبصرے کی اجازت نہیں ہے
کوئی فنکشنز یا طریقے کی اجازت نہیں ہے

عام نحو کی غلطیوں میں شامل ہیں:

گمشدہ یا غیر متوازن brackets/braces
پراپرٹی ناموں کے گرد گمشدہ کوٹس
پراپرٹی ناموں کے گرد ڈبل کوٹس کے بجائے سنگل کوٹس کا استعمال
ٹریلنگ کامے شامل کرنا
ناپید (undefined) کو بطور قدر استعمال کرنا

JSON فارمیٹنگ کیسے کام کرتی ہے

JSON فارمیٹنگ کمپیکٹ، منیفائیڈ JSON کو ایک زیادہ پڑھنے کے قابل شکل میں تبدیل کرتی ہے:

پارسنگ: JSON سٹرنگ کو پہلے درست ہونے کی تصدیق کے لیے پارس کیا جاتا ہے اور ڈیٹا کی ساخت کی ایک یاداشت میں نمائندگی تیار کی جاتی ہے۔
انڈینٹیشن: آبجیکٹس اور ایریاز کی ہر نیسٹڈ سطح کو بصری طور پر ہیرارکی کی نمائندگی کے لیے انڈینٹ کیا جاتا ہے (عام طور پر 2 یا 4 اسپیسز کے ذریعہ)۔
لائن بریکس: ہر پراپرٹی یا ایریا عنصر کے بعد نئی لائنیں شامل کی جاتی ہیں تاکہ پڑھنے کی سہولت بڑھ سکے۔
اسپیسنگ: کولن اور کاموں کے گرد مستقل اسپیسنگ شامل کی جاتی ہے۔

مثال کے طور پر، یہ منیفائیڈ JSON:

{"name":"جان ڈو","age":30,"address":{"street":"123 مین اسٹریٹ","city":"اینٹ ٹاؤن","state":"CA"},"hobbies":["پڑھنا","ہائیکنگ","فوٹوگرافی"]}

اس فارمیٹڈ JSON میں تبدیل ہو جاتا ہے:

{
  "name": "جان ڈو",
  "age": 30,
  "address": {
    "street": "123 مین اسٹریٹ",
    "city": "اینٹ ٹاؤن",
    "state": "CA"
  },
  "hobbies": [
    "پڑھنا",
    "ہائیکنگ",
    "فوٹوگرافی"
  ]
}

ہمارا فارمیٹر ہر سطح کے لیے 2 اسپیسز کی معیاری انڈینٹیشن استعمال کرتا ہے، جو ترقیاتی کمیونٹی میں ایک عام روایتی ہے اور پڑھنے کی سہولت اور کمپیکٹنس کے درمیان ایک اچھا توازن فراہم کرتا ہے۔

JSON کی توثیق

JSON فارمیٹنگ کا ایک اہم پہلو توثیق ہے۔ JSON کو فارمیٹ کرنے سے پہلے اس کی نحو کے مطابق درست ہونا ضروری ہے۔ عام توثیق کی غلطیوں میں شامل ہیں:

نحو کی غلطیاں:
- غیر اقتباس شدہ پراپرٹی نام
- گمشدہ یا اضافی کامے
- غلط طور پر نیسٹڈ ڈھانچے
- بند نہ ہونے والی سٹرنگز، آبجیکٹس، یا ایریاز
ڈیٹا ٹائپ کی غلطیاں:
- بہت بڑے انٹیجرز یا فلوٹنگ پوائنٹ اقدار کے ساتھ مسائل
- کنٹرول کریکٹرز اور ای اسکیپ سیکوئنس کے ساتھ مسائل
- JSON کی توثیق کے لیے غلط فارمیٹڈ ڈیٹا

جب آپ کو غیر درست JSON کا سامنا ہو، تو غلطی کا پیغام مسئلے کی نشاندہی کرنے میں مدد کر سکتا ہے۔ زیادہ تر JSON پارسرز اس جگہ کی نشاندہی کریں گے جہاں پارسنگ ناکام ہوئی، جو مسئلے کو تلاش کرنے میں مدد کر سکتا ہے۔ ہمارا ٹول واضح غلطی کے پیغامات فراہم کرتا ہے تاکہ آپ اپنے JSON ڈیٹا میں مسائل کی نشاندہی اور انہیں درست کر سکیں۔

استعمال کے کیسز

JSON کی فارمیٹنگ متعدد منظرناموں میں قیمتی ہے:

API کی ترقی اور جانچ

جب RESTful APIs کے ساتھ کام کرتے وقت، فارمیٹ شدہ JSON آپ کو مدد کرتا ہے:

جواب کے پیلوڈز کا معائنہ کرنا
درخواست کے جسم کی خرابیوں کا سراغ لگانا
API کی مثالوں کی دستاویز کرنا
یہ تصدیق کرنا کہ ڈیٹا کی ساختیں توقعات کے مطابق ہیں

کنفیگریشن منیجمنٹ

بہت سی جدید ایپلیکیشنز JSON کو کنفیگریشن کے لیے استعمال کرتی ہیں:

ایپلیکیشن کی سیٹنگز کی فائلیں
ماحول کی کنفیگریشن
بلڈ اور ڈپلائمنٹ کی وضاحتیں
انفراسٹرکچر بطور کوڈ کی ٹیمپلیٹس (جیسے AWS CloudFormation، Terraform)

ڈیٹا تجزیہ اور بصریات

فارمیٹ شدہ JSON اس وقت مددگار ہوتا ہے جب:

ڈیٹا سیٹس کی کھوج کرنا
بصریات کے لیے ڈیٹا تیار کرنا
ڈیٹا کے خاکے کو سمجھنا
ساختی ڈیٹا میں پیٹرن کی شناخت کرنا

خرابیوں کا سراغ لگانا اور مسائل حل کرنا

صحیح طور پر فارمیٹ شدہ JSON اس وقت ضروری ہے جب:

ویب ایپلیکیشنز کی خرابیوں کا سراغ لگانا
localStorage یا sessionStorage کا معائنہ کرنا
نیٹ ورک کے جوابات کا تجزیہ کرنا
ڈیٹا کے انضمام کے مسائل کو حل کرنا

تعلیمی مقاصد

صاف JSON کی فارمیٹنگ تعلیمی مقاصد کے لیے قیمتی ہے:

ڈیٹا کی ساختوں کی تعلیم دینا
نیسٹڈ تعلقات کی وضاحت کرنا
API کے تصورات کی وضاحت کرنا
ڈیٹا ماڈلنگ کے اصولوں کی وضاحت کرنا

متبادل

جبکہ ہمارا ویب پر مبنی JSON فارمیٹر فوری فارمیٹنگ کے کاموں کے لیے آرام دہ ہے، مختلف منظرناموں کے لیے کئی متبادل موجود ہیں:

براؤزر کے ڈویلپر ٹولز

جدید براؤزرز JSON کی فارمیٹنگ کی صلاحیتیں شامل کرتے ہیں:

Chrome اور Edge DevTools نیٹ ورک ٹیب میں JSON جوابات کو خودکار طور پر فارمیٹ کرتے ہیں
Firefox کا JSON ویور ایک انٹرایکٹو درخت کی شکل فراہم کرتا ہے
براؤزر کے توسیع جیسے JSONView JSON کو براہ راست براؤزر میں فارمیٹ کر سکتے ہیں

کوڈ ایڈیٹرز اور IDEs

زیادہ تر ترقیاتی ماحول JSON کی فارمیٹنگ پیش کرتے ہیں:

Visual Studio Code میں بلٹ ان JSON فارمیٹنگ ہے (Alt+Shift+F)
JetBrains IDEs (WebStorm، IntelliJ) میں طاقتور JSON ٹولز شامل ہیں
Sublime Text اور Atom پلگ ان کے ذریعے JSON کی فارمیٹنگ کی حمایت کرتے ہیں

کمانڈ لائن ٹولز

ٹرمینل صارفین یا خودکار کے لیے:

jq ایک طاقتور کمانڈ لائن JSON پروسیسر ہے
json_pp بہت سے Unix سسٹمز پر پہلے سے انسٹال ہوتا ہے
python -m json.tool Python کا استعمال کرتے ہوئے فوری فارمیٹنگ فراہم کرتا ہے

پروگراماتی طریقے

ایپلیکیشنز میں JSON کی فارمیٹنگ کرتے وقت:

// جاوا اسکرپٹ
const formatted = JSON.stringify(jsonObject, null, 2);

# Python
import json
formatted = json.dumps(json_object, indent=2)

// جاوا کے ساتھ Gson
Gson gson = new GsonBuilder().setPrettyPrinting().create();
String formatted = gson.toJson(jsonObject);

# Ruby
require 'json'
formatted = JSON.pretty_generate(json_object)

// PHP
$formatted = json_encode($jsonObject, JSON_PRETTY_PRINT);

تاریخ

JSON کو ڈوگلس کروکفورڈ نے 2000 کی دہائی کے اوائل میں XML کے ہلکے متبادل کے طور پر بنایا تھا۔ یہ فارمیٹ جاوا اسکرپٹ آبجیکٹ لیٹرل نحو سے ماخوذ تھا لیکن زبان سے آزاد ہونے کے لیے ڈیزائن کیا گیا تھا۔ 2006 میں، JSON کو RFC 4627 میں باقاعدہ طور پر بیان کیا گیا، اور یہ جلد ہی اپنی سادگی اور جاوا اسکرپٹ کے ساتھ ہم آہنگی کی وجہ سے مقبولیت حاصل کر گیا۔

JSON سے پہلے، XML ڈیٹا کے تبادلے کا غالب فارمیٹ تھا، لیکن اس کی وضاحت اور پیچیدگی نے بہت سی ایپلیکیشنز کے لیے اسے مشکل بنا دیا۔ JSON نے ایک زیادہ مختصر نحو پیش کیا جو انسانوں اور مشینوں دونوں کے لیے پڑھنے اور لکھنے میں آسان تھا۔ اس نے جاوا اسکرپٹ کے آبجیکٹ ماڈل کے ساتھ بھی مکمل ہم آہنگی کی، جسے ویب ایپلیکیشنز کے لیے قدرتی انتخاب بنایا۔

2000 کی دہائی کے وسط میں AJAX اور RESTful APIs کے عروج کے ساتھ JSON کی اپنائیت میں تیزی آئی۔ 2010 کی دہائی تک، یہ ویب APIs، کنفیگریشن کی فائلوں، اور NoSQL ڈیٹا بیس جیسے MongoDB اور CouchDB میں ڈیٹا اسٹوریج کے لیے معیاری بن چکا تھا۔

آج، JSON تقریباً ہر پروگرامنگ زبان کی حمایت کرتا ہے اور یہ ویب پر بے شمار ایپلیکیشنز میں استعمال ہوتا ہے۔ اس کی سادگی، لچک، اور عالمی حمایت نے اسے جدید کمپیوٹنگ میں سب سے اہم ڈیٹا فارمیٹس میں سے ایک بنا دیا ہے۔

کوڈ کے نمونے

یہاں مختلف پروگرامنگ زبانوں میں JSON کی فارمیٹنگ کے طریقے ہیں:

// جاوا اسکرپٹ JSON کی فارمیٹنگ
function formatJSON(jsonString) {
  try {
    const parsedData = JSON.parse(jsonString);
    return JSON.stringify(parsedData, null, 2);
  } catch (error) {
    return `غلطی: ${error.message}`;
  }
}

// مثال کا استعمال
const rawJSON = '{"name":"جان","age":30,"city":"نیویارک"}';
console.log(formatJSON(rawJSON));

# Python JSON کی فارمیٹنگ
import json

def format_json(json_string):
    try:
        parsed_data = json.loads(json_string)
        return json.dumps(parsed_data, indent=2)
    except json.JSONDecodeError as e:
        return f"غلطی: {str(e)}"

# مثال کا استعمال
raw_json = '{"name":"جان","age":30,"city":"نیویارک"}'
print(format_json(raw_json))

// جاوا JSON کی فارمیٹنگ کے ساتھ Gson
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.JsonSyntaxException;

public class JSONFormatter {
    public static String formatJSON(String jsonString) {
        try {
            Gson gson = new GsonBuilder().setPrettyPrinting().create();
            Object parsedJson = gson.fromJson(jsonString, Object.class);
            return gson.toJson(parsedJson);
        } catch (JsonSyntaxException e) {
            return "غلطی: " + e.getMessage();
        }
    }
    
    public static void main(String[] args) {
        String rawJSON = "{\"name\":\"جان\",\"age\":30,\"city\":\"نیویارک\"}";
        System.out.println(formatJSON(rawJSON));
    }
}

// PHP JSON کی فارمیٹنگ
function formatJSON($jsonString) {
    $result = json_decode($jsonString);
    if (json_last_error() !== JSON_ERROR_NONE) {
        return "غلطی: " . json_last_error_msg();
    }
    return json_encode($result, JSON_PRETTY_PRINT);
}

// مثال کا استعمال
$rawJSON = '{"name":"جان","age":30,"city":"نیویارک"}';
echo formatJSON($rawJSON);

# Ruby JSON کی فارمیٹنگ
require 'json'

def format_json(json_string)
  begin
    parsed_data = JSON.parse(json_string)
    return JSON.pretty_generate(parsed_data)
  rescue JSON::ParserError => e
    return "غلطی: #{e.message}"
  end
end

# مثال کا استعمال
raw_json = '{"name":"جان","age":30,"city":"نیویارک"}'
puts format_json(raw_json)

// C# JSON کی فارمیٹنگ کے ساتھ Newtonsoft.Json
using Newtonsoft.Json;
using System;

class JSONFormatter
{
    public static string FormatJSON(string jsonString)
    {
        try
        {
            object parsedJson = JsonConvert.DeserializeObject(jsonString);
            return JsonConvert.SerializeObject(parsedJson, Formatting.Indented);
        }
        catch (JsonException e)
        {
            return $"غلطی: {e.Message}";
        }
    }
    
    static void Main()
    {
        string rawJSON = "{\"name\":\"جان\",\"age\":30,\"city\":\"نیویارک\"}";
        Console.WriteLine(FormatJSON(rawJSON));
    }
}

// Go JSON کی فارمیٹنگ
package main

import (
    "encoding/json"
    "fmt"
)

func formatJSON(jsonString string) string {
    var parsedData interface{}
    err := json.Unmarshal([]byte(jsonString), &parsedData)
    if err != nil {
        return fmt.Sprintf("غلطی: %s", err.Error())
    }
    
    formattedBytes, err := json.MarshalIndent(parsedData, "", "  ")
    if err != nil {
        return fmt.Sprintf("غلطی: %s", err.Error())
    }
    
    return string(formattedBytes)
}

func main() {
    rawJSON := `{"name":"جان","age":30,"city":"نیویارک"}`
    fmt.Println(formatJSON(rawJSON))
}

کنارے کے معاملات اور غور و فکر

جب JSON کی فارمیٹنگ کے ساتھ کام کرتے ہیں، تو ان ممکنہ چیلنجز سے آگاہ رہیں:

بڑے JSON فائلیں

بہت بڑی JSON فائلیں (کئی میگابائٹس یا اس سے زیادہ) براؤزر پر مبنی فارمیٹرز میں کارکردگی کے مسائل پیدا کر سکتی ہیں۔ ایسے معاملات میں:

کمانڈ لائن ٹولز جیسے jq کا استعمال کرنے پر غور کریں
JSON کو چھوٹے حصوں میں تقسیم کریں
بغیر پوری فائل کو یاداشت میں لوڈ کیے بغیر پروسیسنگ کے لیے اسٹریمنگ پارسرز کا استعمال کریں

انتہائی نیسٹڈ ساختیں

انتہائی نیسٹڈ JSON (10-20 سطحوں سے زیادہ) پڑھنے میں مشکل ہو سکتا ہے، یہاں تک کہ فارمیٹ ہونے کے باوجود بھی۔ ان صورتوں میں:

اگر ممکن ہو تو ساخت کو ہموار کرنے پر غور کریں
قابل توسیع JSON ویورز کا استعمال کریں
JSON کے مخصوص حصوں کے ساتھ کام کریں

خاص کردار اور Unicode

JSON Unicode کی حمایت کرتا ہے، لیکن کچھ فارمیٹرز کچھ کرداروں کے ساتھ مسائل کا سامنا کر سکتے ہیں:

یہ یقینی بنائیں کہ آپ کا فارمیٹر ایموجی اور دیگر Unicode کرداروں کو صحیح طریقے سے ہینڈل کرتا ہے
کنٹرول کرداروں اور ای اسکیپ سیکوئنس کے ساتھ محتاط رہیں
یہ تصدیق کریں کہ فارمیٹ شدہ آؤٹ پٹ تمام اصل کرداروں کو محفوظ رکھتا ہے

عددی درستگی

JSON عددوں کے لیے درستگی کی وضاحت نہیں کرتا، جو بہت بڑے انٹیجرز یا فلوٹنگ پوائنٹ اقدار کے ساتھ مسائل پیدا کر سکتا ہے:

آگاہ رہیں کہ کچھ جاوا اسکرپٹ کے نفاذ 53 بٹس سے زیادہ انٹیجرز کے لیے درستگی کھو سکتے ہیں
درست عددی اقدار کے لیے سٹرنگ کی نمائندگی کا استعمال کرنے پر غور کریں
اگر آپ کی ایپلیکیشن کو اعلی درستگی کی ضرورت ہو تو انتہائی اقدار کے ساتھ جانچ کریں

خالی آبجیکٹس اور ایریاز

درست JSON میں خالی آبجیکٹس {} اور ایریاز [] شامل ہیں، جنہیں صحیح طریقے سے فارمیٹ کیا جانا چاہیے:

خالی آبجیکٹس کو {} کے طور پر ظاہر ہونا چاہیے
خالی ایریاز کو [] کے طور پر ظاہر ہونا چاہیے
نیسٹڈ خالی ڈھانچے کو مناسب انڈینٹیشن برقرار رکھنی چاہیے

حوالہ جات

JSON.org - JSON کی سرکاری وضاحت کی ویب سائٹ
RFC 8259 - JSON ڈیٹا کے تبادلے کا فارمیٹ
MDN Web Docs: JSON - جاوا اسکرپٹ میں JSON پر جامع دستاویزات
JSON Lint - ایک مقبول آن لائن JSON توثیق کرنے والا
jq - ایک ہلکا پھلکا اور لچکدار کمانڈ لائن JSON پروسیسر