Yorumlar JSON'da kullanılabilir mi?

Bir JSON dosyasının içindeki yorumları kullanabilir miyim? Öyleyse nasıl?

Hayır.

JSON'un tamamı veri olmalıdır ve bir yorum eklerseniz, veri de olur.

Adlı bir veri öğeniz olabilir. "_comment"JSON verilerini kullanan uygulamalar tarafından göz ardı edilecek (veya bir şey) öğeniz olabilir.

JSON verilerinin / almalarının, JSON verilerinin önceden ne olacağını veya en azından yapısını bilmeleri gerektiğinden, muhtemelen yorumda bulunmanız daha iyi olur.

Ama eğer karar verdiyseniz:

{
   "_comment": "comment text goes here...",
   "glossary": {
      "title": "example glossary",
      "GlossDiv": {
         "title": "S",
         "GlossList": {
            "GlossEntry": {
               "ID": "SGML",
               "SortAs": "SGML",
               "GlossTerm": "Standard Generalized Markup Language",
               "Acronym": "SGML",
               "Abbrev": "ISO 8879:1986",
               "GlossDef": {
                  "para": "A meta-markup language, used to create markup languages such as DocBook.",
                  "GlossSeeAlso": ["GML", "XML"]
               },
               "GlossSee": "markup"
            }
         }
      }
   }
}

Hayır , formun yorumlarına //…veya /*…*/JSON'da izin verilmiyor. Bu cevap aşağıdakilere dayanmaktadır:

• http://www.json.org
• RFC 4627 :application/json JavaScript Nesne Gösterimi için Medya Türü (JSON)
• RFC 8259 JavaScript Nesne Gösterimi (JSON) Veri Değişim Biçimi (supercedes RFCs 4627, 7158, 7159)

İsterseniz yorumları ekleyin; ayrıştırmadan veya iletmeden önce bunları bir kıyma makinesiyle çıkarın.

Ben sadece bir JSON bloğundan yorumlar ve boşluk çıkarır ve ayrıştırılabilir geçerli JSON yapar JSON.minify () yayımladı . Yani, şöyle kullanabilirsiniz:

JSON.parse(JSON.minify(my_str));

Onu serbest bıraktığımda, fikri bile kabul etmeyen büyük bir tepki aldım, bu yüzden yorumların neden JSON'da mantıklı olduğuna dair kapsamlı bir blog yazısı yazmaya karar verdim . JSON'un yaratıcısından gelen bu önemli yorumu içerir:

Açıklama eklemek istediğiniz yapılandırma dosyalarını saklamak için JSON kullandığınızı varsayalım. Devam edin ve beğendiğiniz tüm yorumları ekleyin. Sonra JSON ayrıştırıcısına teslim etmeden önce JSMin üzerinden boru. - Douglas Crockford, 2012

Umarım bu JSON.minify () 'in neden yararlı olabileceğine katılmayanlar için faydalıdır.

Yorumlar tasarımla JSON'dan kaldırıldı.

JSON'dan yorumları kaldırdım çünkü insanların bunları birlikte çalışma yönergesini yok edecek bir uygulama olan ayrıştırma yönergelerine sahip olduklarını gördüm. Yorum eksikliğinin bazı insanları üzdüğünü biliyorum, ama olmamalı.

Ek açıklama eklemek istediğiniz yapılandırma dosyalarını saklamak için JSON kullandığınızı varsayalım. Devam edin ve istediğiniz tüm yorumları ekleyin. Sonra JSON ayrıştırıcısına teslim etmeden önce JSMin üzerinden boru.

Kaynak: Douglas Crockford'un G + hakkında kamuoyu açıklaması

YASAL UYARI: GARANTİNİZ GEÇERSİZ

Belirtildiği gibi, bu kesmek spesifikasyonun uygulanmasından yararlanır. Tüm JSON ayrıştırıcıları bu tür JSON'u anlamayacaktır. Özellikle akış ayrıştırıcılar boğulur.

Bu ilginç bir merak, ama gerçekten hiçbir şey için kullanmamalısınız . Orijinal cevap aşağıdadır.

Ayrıştırmayı etkilemeyecek bir JSON dosyasına yorum eklemenize veya herhangi bir şekilde temsil edilen verileri değiştirmenize izin veren küçük bir kesmek buldum.

Bir nesne hazır bilgisini bildirirken aynı anahtarla iki değer belirtebileceğiniz ve sonuncunun öncelikli olduğu anlaşılıyor. İster inanın ister inanmayın, JSON ayrıştırıcılarının aynı şekilde çalıştığı ortaya çıkıyor. Bu nedenle, kaynak JSON'da bir ayrıştırılmış nesne sunumunda bulunmayacak yorumlar oluşturmak için bunu kullanabiliriz.

({a: 1, a: 2});
// => Object {a: 2}
Object.keys(JSON.parse('{"a": 1, "a": 2}')).length; 
// => 1

Bu tekniği uygularsak, yorumladığınız JSON dosyanız şöyle görünebilir:

{
  "api_host" : "The hostname of your API server. You may also specify the port.",
  "api_host" : "hodorhodor.com",

  "retry_interval" : "The interval in seconds between retrying failed API calls",
  "retry_interval" : 10,

  "auth_token" : "The authentication token. It is available in your developer dashboard under 'Settings'",
  "auth_token" : "5ad0eb93697215bc0d48a7b69aa6fb8b",

  "favorite_numbers": "An array containing my all-time favorite numbers",
  "favorite_numbers": [19, 13, 53]
}

Yukarıdaki kod geçerli JSON . Ayrıştırırsanız, bunun gibi bir nesne alırsınız:

{
    "api_host": "hodorhodor.com",
    "retry_interval": 10,
    "auth_token": "5ad0eb93697215bc0d48a7b69aa6fb8b",
    "favorite_numbers": [19,13,53]
}

Bu, yorumların izi olmadığı ve garip yan etkilerinin olmayacağı anlamına gelir.

Mutlu hack!

JSON yorumları desteklemez. Ayrıca, yorumların gerekli olacağı yapılandırma dosyaları için asla kullanılması amaçlanmamıştır.

Hjson insanlar için bir yapılandırma dosyası biçimidir. Rahat sözdizimi, daha az hata, daha fazla yorum.

JavaScript, Java, Python, PHP, Rust, Go, Ruby ve C # kütüphaneleri için hjson.org adresine bakın .

YAML kullanmayı düşünün. Neredeyse JSON'un bir üst kümesidir (neredeyse tüm geçerli JSON geçerli YAML'dir) ve yorumlara izin verir.

Yapamazsın. En azından bu benim json.org'a hızlı bir bakışla deneyimim .

JSON sözdizimini bu sayfada görselleştirmiştir. Yorumlar hakkında not yok.

Bazı ayrıştırıcılar C ++ tarzı yorumları desteklese de yorumlar resmi bir standart değildir. Kullandığım biri JsonCpp . Örneklerde bu var:

// Configuration options
{
    // Default encoding for text
    "encoding" : "UTF-8",

    // Plug-ins loaded at start-up
    "plug-ins" : [
        "python",
        "c++",
        "ruby"
        ],

    // Tab indent size
    "indent" : { "length" : 3, "use_space": true }
}

jsonlint bunu doğrulamaz. Dolayısıyla yorumlar ayrıştırıcıya özgü bir uzantıdır ve standart değildir.

Başka bir ayrıştırıcı JSON5 .

JSON TOML'a bir alternatif .

Başka bir alternatif jsonc'dir .

Bunun yerine bir JSON şeması yazmalısınız . JSON şeması şu anda önerilen bir Internet taslak belirtimidir. Dokümanların yanı sıra şema, JSON verilerinizi doğrulamak için de kullanılabilir.

Misal:

{
    "description":"A person",
    "type":"object",
    "properties":
        {
            "name":
                {
                    "type":"string"
                },
            "age":
                {
                    "type":"integer",
                    "maximum":125
                }
        }
}

Açıklama şeması özniteliğini kullanarak dokümantasyon sağlayabilirsiniz .

JSON ayrıştırıcısı olarak Jackson kullanıyorsanız , yorumlara izin vermek için bu şekilde etkinleştirirsiniz:

ObjectMapper mapper = new ObjectMapper().configure(Feature.ALLOW_COMMENTS, true);

Sonra böyle yorumlarınız olabilir:

{
  key: "value" // Comment
}

Ayrıca, aşağıdakileri ayarlayarak da yorum yapabilirsiniz #:

mapper.configure(Feature.ALLOW_YAML_COMMENTS, true);

Ancak genel olarak (daha önce yanıtlandığı gibi) şartname yorumlara izin vermez.

Google Firebase belgelerinde JSON'a yorum yazmanıza olanak sağlayan bulduğum şey :

{
  "//": "Some browsers will use this to enable push notifications.",
  "//": "It is the same for all projects, this is not your project's sender ID",
  "gcm_sender_id": "1234567890"
}

HAYIR . JSON yorumları destekliyordu, ancak istismar edildi ve standarttan çıkarıldı.

JSON'un yaratıcısından:

JSON'dan yorumları kaldırdım, çünkü insanların bunları birlikte çalışabilirliği yok edecek bir uygulama olan ayrıştırma direktiflerini tutmak için kullandıklarını gördüm. Yorum eksikliğinin bazı insanları üzdüğünü biliyorum, ama olmamalı. - Douglas Crockford, 2012

Resmi JSON sitesi JSON.org adresindedir . JSON, ECMA International tarafından standart olarak tanımlanmaktadır . Standartların revize edilmesi için her zaman bir dilekçe süreci vardır. Ek açıklamaların birkaç nedenden dolayı JSON standardına eklenmesi olası değildir.

Tasarım ile JSON, XML için kolayca tersine mühendislikle (insan tarafından ayrıştırılmış) bir alternatiftir. Ek açıklamaların gereksiz olduğu noktaya kadar basitleştirilmiştir. Bir biçimlendirme dili bile değildir. Amaç istikrar ve birlikte çalışabilirliktir.

Nesne yöneliminin "has-a" ilişkisini anlayan herkes herhangi bir JSON yapısını anlayabilir - bütün mesele budur. Bu, neredeyse evrensel bir veri yapısı olan düğüm etiketlerine (anahtar / değer çiftleri) sahip yönlendirilmiş bir döngüsel grafiktir (DAG).

Gereken bu ek açıklama "// Bunlar DAG etiketleri" olabilir. Anahtar isimleri istenildiği kadar bilgilendirici olabilir ve keyfi anlamsal düzene izin verir.

Herhangi bir platform JSON'u yalnızca birkaç satır kodla ayrıştırabilir. XML, birçok platformda geçerli olmayan karmaşık OO kitaplıkları gerektirir.

Ek açıklamalar yalnızca JSON'un daha az birlikte çalışabilir olmasını sağlar. Gerçekten ihtiyacınız olan şey bir biçimlendirme dili (XML) değilse ve kalıcı verilerinizin kolayca ayrıştırılıp ayrıştırılmadığı umurumda olmadığı sürece eklenecek başka bir şey yoktur.

AMA JSON'un yaratıcısı da gözlemlediğinden, yorumlar için her zaman JS boru hattı desteği olmuştur:

Devam edin ve istediğiniz tüm yorumları ekleyin. Sonra JSON ayrıştırıcısına teslim etmeden önce JSMin üzerinden boru. - Douglas Crockford, 2012

JSON dizesi olan metin dosyanız bir program tarafından okunacaksa, kullanmadan önce C veya C ++ tarzı yorumları çıkarmak ne kadar zor olurdu?

Cevap: Tek bir astar olurdu. Bunu yaparsanız, JSON dosyaları yapılandırma dosyaları olarak kullanılabilir.

ASP.NET ile Newtonsoft.Json kütüphanesini okumak / serisini kaldırmak için kullanıyorsanız JSON içeriğindeki yorumları kullanabilirsiniz:

// "ad": "dize"

// "id": int

veya

/* Bu bir

yorum örneği * /

Not: Tek satırlı yorumlar yalnızca Newtonsoft Json'un 6+ sürümünde desteklenir.

Kutudan çıkamayanlar için ek not: Yaptığım bir ASP.NET web uygulamasındaki temel ayarlar için JSON biçimini kullanıyorum. Dosyayı okudum, Newtonsoft kütüphanesiyle ayarlar nesnesine dönüştürdüm ve gerektiğinde kullanıyorum.

JSON dosyasının kendisinde her bir ayar hakkında yorum yazmayı tercih ediyorum ve kullandığım kütüphane tamam olduğu sürece gerçekten JSON formatının bütünlüğünü umursamıyorum.

Bunun ayrı bir 'settings.README' dosyası oluşturup içindeki ayarları açıklamaktan ziyade 'kullanımı / anlaşılması' kolay bir yol olduğunu düşünüyorum.

Bu tür kullanımla ilgili bir sorununuz varsa; Üzgünüm, cin lambadan çıktı. İnsanlar JSON biçimi için başka kullanımlar bulabilir ve bu konuda yapabileceğiniz hiçbir şey yoktur.

JSON'un arkasındaki fikir, uygulamalar arasında basit veri alışverişi sağlamaktır. Bunlar genellikle web tabanlıdır ve dil JavaScript'tir.

Verilerdeki ad / değer çiftlerinden biri olarak bir yorum iletmek kesinlikle işe yarayacaktır, ancak bu verilerin açıkça ayrıştırma kodu tarafından göz ardı edilmesi veya ele alınması gerektiği halde, yorumlara gerçekten izin vermez.

Bütün bunlar, JSON dosyasının geleneksel anlamda yorumlar içermesi gerektiği niyetinde değildir. Sadece veri olmalı.

Göz at JSON web Daha fazla ayrıntı için.

Ben sadece yapılandırma dosyaları için bu karşılaşıyorum. XML (ayrıntılı, grafiksel, çirkin, okunması zor) veya "ini" biçimini (hiyerarşi yok, gerçek standart yok, vb.) Veya Java "Özellikler" biçimini (.ini gibi) kullanmak istemiyorum .

JSON yapabildikleri her şeyi yapabilir, ancak daha az ayrıntılı ve daha insan tarafından okunabilir - ve ayrıştırıcılar birçok dilde kolay ve her yerde bulunur. Sadece bir veri ağacı. Ancak bant dışı yorumlar genellikle "varsayılan" konfigürasyonları ve benzerlerini belgelemek için bir gerekliliktir. Konfigürasyonlar asla "tam doküman" olmamalıdır, ancak gerektiğinde insanlar tarafından okunabilen kaydedilmiş veri ağaçları.

Biri "#": "comment", "geçerli" JSON için kullanabilirsiniz sanırım .

JSON yorumları yerel olarak desteklemez, ancak yorumları çözmek için kendi kod çözücünüzü veya en azından ön işlemcinizi oluşturabilirsiniz, bu mükemmel bir şekilde iyi (sadece yorumları görmezden geldiğiniz ve uygulamanızın JSON verilerini nasıl işlemesi gerektiğini yönlendirmek için kullanmamanız durumunda) ).

JSON adlı kullanıcının yorumu yok. Bir JSON kodlayıcı yorum YAPMAMALIDIR. Bir JSON dekoderi yorumları kabul edebilir ve yok sayabilir.

Yorumlar asla anlamlı bir şey iletmek için kullanılmamalıdır. JSON bunun içindir.

Cf: Douglas Crockford, JSON spec .

JSON kütüphanenize bağlıdır. Json.NET JavaScript tarzı yorumları destekler /* commment */.

Başka bir Yığın Taşması sorusuna bakın .

JSON, yapılandırma dosyaları ve diğer yerel kullanım için çok anlamlı çünkü her yerde ve XML'den çok daha basit.

Kişilerin verileri iletirken (geçerli olsun ya da olmasın) JSON'da yorum yapmamaları için güçlü nedenleri varsa, muhtemelen JSON ikiye bölünebilir:

• JSON-COM: Kablodaki JSON veya JSON verilerini iletirken uygulanan kurallar.
• JSON-DOC: JSON belgesi veya dosyalarda veya yerel olarak JSON. Geçerli bir JSON belgesi tanımlayan kurallar.

JSON-DOC yorumlara izin verir ve boşlukları yönetmek gibi diğer küçük farklılıklar olabilir. Ayrıştırıcılar bir özellikten diğerine kolayca dönüştürebilir.

Douglas Crockford'un bu konularda yaptığı açıklama ile ilgili olarak (@Artur Czajka tarafından referansta bulunulan)

Ek açıklama eklemek istediğiniz yapılandırma dosyalarını saklamak için JSON kullandığınızı varsayalım. Devam edin ve istediğiniz tüm yorumları ekleyin. Sonra JSON ayrıştırıcısına teslim etmeden önce JSMin üzerinden boru.

Genel bir yapılandırma dosyası sorunu (çapraz dil / platform) hakkında konuşuyoruz ve JS'ye özgü bir yardımcı programla yanıt veriyor!

JSON'a özel bir küçültmenin herhangi bir dilde uygulanabileceğinden emin olun, ancak bunu standartlaştırın, böylece tüm dillerde ve platformlarda ayrıştırıcılar arasında her yerde her yerde bulunur, böylece insanlar özellik için eksik zamanlarını boşa harcarlar, çünkü sorunu iyi ararlar. çevrimiçi forumlarda ve kullanıcıların onlara bunun kötü bir fikir olduğunu söylemesi veya metin dosyalarından sıyırma yorumlarını uygulamanın kolay olduğunu öne sürmesini sağlamak.

Diğer konu birlikte çalışabilirliktir. Bir kütüphane veya API'nız veya onunla ilişkili bazı yapılandırma veya veri dosyaları olan herhangi bir alt sisteminiz olduğunu varsayalım. Ve bu alt sisteme farklı dillerden erişilecek. Sonra insanlara söylemeye mi gidiyorsunuz? Bu arada, ayrıştırıcıya iletmeden önce JSON dosyalarındaki yorumları çıkarmayı unutmayın!

JSON5 kullanıyorsanız yorum ekleyebilirsiniz.

JSON5, insanların elle yazmasını ve bakımını yapmasını kolaylaştıran JSON'un önerilen bir uzantısıdır . Bunu doğrudan ECMAScript 5'ten en az sözdizimi özellikleri ekleyerek yapar.

Dojo Araç Seti JavaScript araç seti (en azından 1.4 sürümünden itibaren), JSON'unuza yorum eklemenize olanak tanır. Yorumlar /* */biçiminde olabilir. Dojo Toolkit, JSON'udojo.xhrGet() çağrı .

Diğer JavaScript araç setleri de benzer şekilde çalışabilir.

Bu, son bir seçenek seçmeden önce alternatif veri yapıları (hatta veri listeleri) ile denemeler yaparken yardımcı olabilir.

JSON çerçeveli bir protokol değildir . Dilsiz bir formattır . Dolayısıyla, JSON için bir yorumun biçimi tanımlanmamıştır.

Birçok kişinin önerdiği gibi, bazı hileler vardır, örneğin, yinelenen anahtarlar veya _commentkullanabileceğiniz belirli bir anahtar . Sana kalmış.

Sen edebilirsiniz içinde yorumlarınız JSONP değil saf JSON. Programımın Highcharts'tan bu örnekle çalışmasını sağlamak için bir saat geçirdim: http://www.highcharts.com/samples/data/jsonp.php?filename=aapl-c.json&callback=?

Bağlantıyı takip ederseniz, göreceksiniz

?(/* AAPL historical OHLC data from the Google Finance API */
[
/* May 2006 */
[1147651200000,67.79],
[1147737600000,64.98],
...
[1368057600000,456.77],
[1368144000000,452.97]
]);

Yerel klasörümde benzer bir dosya bulunduğundan, Aynı menşe politikasıyla ilgili herhangi bir sorun yoktu , bu yüzden saf JSON kullanmaya karar verdim ... ve elbette, $.getJSONyorumlar nedeniyle sessizce başarısız oluyordu.

Sonunda yukarıdaki adrese manuel bir HTTP isteği gönderdim ve içerik türünün text/javascriptJSONP'nin saf JavaScript döndürdüğünden beri fark ettim . Bu durumda yorumlara izin verilir . Ancak uygulamam içerik türü döndürdü application/json, bu yüzden yorumları kaldırmak zorunda kaldım.

Bu bir "yapabilir misin" sorusudur. Ve işte "evet" yanıtı.

Hayır, yan kanal verilerini JSON kodlamasına doldurmak için yinelenen nesne üyelerini kullanmamalısınız. ( "Bir nesne içinde adları benzersiz olmalıdır *" bölümüne bakınız RFC ).

Ve evet, JSON'un etrafına ayrıştırabileceğiniz yorumlar ekleyebilirsiniz .

Ancak, geçerli bir JSON'a rastgele yan kanal verileri eklemek ve çıkarmak için bir yol istiyorsanız, işte bir cevap. Bir JSON kodlamasında verilerin benzersiz olmayan sunumundan yararlanıyoruz. Buna "altı yapısal karakterden herhangi birinden önce veya sonra boşluk bırakılabilir" başlığı altında RFC'nin ikinci bölümünde ^* izin verilir.

^* RFC yalnızca "altı yapısal karakterden herhangi birinden önce veya sonra boşluklara izin verilir" ifadesini belirtir; açıkça dizelerden, sayılardan, "false", "true" ve "null" dan bahsetmez. Bu ihmal TÜM uygulamalarda göz ardı edilmektedir.

İlk olarak, JSON'unuzu küçülterek standartlaştırın:

$jsonMin = json_encode(json_decode($json));

Ardından yorumunuzu ikili olarak kodlayın:

$hex = unpack('H*', $comment);
$commentBinary = base_convert($hex[1], 16, 2);

Ardından ikili dosyalarınızı yönlendirin:

$steg = str_replace('0', ' ', $commentBinary);
$steg = str_replace('1', "\t", $steg);

İşte çıktı:

$jsonWithComment = $steg . $jsonMin;

YASAL UYARI: BU SILLY

Aslında yorum eklemek ve spec içinde kalmak için bir yol var (ek ayrıştırıcı gerekmez). Yine de herhangi bir ayrıştırma olmaksızın okunabilir yorumlarla sonuçlanmaz.

Aşağıdakileri kötüye kullanabilirsiniz:

Herhangi bir jetondan önce veya sonra önemsiz boşluklara izin verilir. Boşluk, aşağıdaki kod noktalarından bir veya daha fazlasının herhangi bir dizisidir: karakter tablolaması (U + 0009), satır besleme (U + 000A), satır başı (U + 000D) ve boşluk (U + 0020).

Saldırgan bir şekilde, yorum eklemek için bunu kötüye kullanabilirsiniz. Örneğin: yorumunuzu bir sekmeyle başlatın ve bitirin. Yorumu base3 olarak kodlayın ve diğer beyaz boşluk karakterlerini kullanarak bunları temsil edin. Örneğin.

010212 010202 011000 011000 011010 001012 010122 010121 011021 010202 001012 011022 010212 011020 010202 010202

(hello base three ASCII'de) Ancak 0 yerine boşluk kullanın, 1 satır besleme ve 2 satır taşıyıcı kullanın.

Bu size çok fazla okunamayan boşluk bırakacaktır (onu IDE eklentisini anında kodlamak / kodunu çözmek için yapmazsanız).

Bunu hiçbir zaman denemedim, bariz nedenlerle ve sen de yapmamalısın.

strip-json-commentsProjemiz için kullanıyoruz . Gibi bir şeyi destekler:

/*
 * Description 
*/
{
    // rainbows
    "unicorn": /* ❤ */ "cake"
}

Basitçe npm install --save strip-json-commentskurmak ve kullanmak için:

var strip_json_comments = require('strip-json-comments')
var json = '{/*rainbows*/"unicorn":"cake"}';
JSON.parse(strip_json_comments(json));
//=> {unicorn: 'cake'}

Benim durumumda, JSON yapısının çıkışından önce hata ayıklama amacıyla yorumları kullanmam gerekiyor. Bu yüzden istemciyi kırmamak için HTTP üstbilgisinde hata ayıklama bilgilerini kullanmaya karar verdim:

header("My-Json-Comment: Yes, I know it's a workaround ;-) ");

JSON kendi başına yorumlara izin vermez. Muhakeme JSON kullanamaması için tamamen aptalca kendisini tamamen muhakeme ortadan kaldırır hangi, yorum oluşturmak için, ve yükler için hiç sebepsiz ayrıştırıcı veri alanı tam olarak aynı sonucu ve bunlar gibi potansiyel sorunlar,: JSON yorum içeren dosya.

( //Veya /* */veya kullanarak) yorum koymaya çalışırsanız #, bazı ayrıştırıcılar başarısız olur, çünkü bu kesinlikle JSON belirtimi dahilinde değildir. Yani bunu asla yapmamalısın .

Örneğin, görüntü işleme sistemimin görüntü gösterimlerini ve bunlarla ilgili bazı temel biçimlendirilmiş (yorum) bilgileri kaydettiği bir örnek :

{
    "Notations": [
        {
            "anchorX": 333,
            "anchorY": 265,
            "areaMode": "Ellipse",
            "extentX": 356,
            "extentY": 294,
            "opacity": 0.5,
            "text": "Elliptical area on top",
            "textX": 333,
            "textY": 265,
            "title": "Notation 1"
        },
        {
            "anchorX": 87,
            "anchorY": 385,
            "areaMode": "Rectangle",
            "extentX": 109,
            "extentY": 412,
            "opacity": 0.5,
            "text": "Rect area\non bottom",
            "textX": 98,
            "textY": 385,
            "title": "Notation 2"
        },
        {
            "anchorX": 69,
            "anchorY": 104,
            "areaMode": "Polygon",
            "extentX": 102,
            "extentY": 136,
            "opacity": 0.5,
            "pointList": [
                {
                    "i": 0,
                    "x": 83,
                    "y": 104
                },
                {
                    "i": 1,
                    "x": 69,
                    "y": 136
                },
                {
                    "i": 2,
                    "x": 102,
                    "y": 132
                },
                {
                    "i": 3,
                    "x": 83,
                    "y": 104
                }
            ],
            "text": "Simple polygon",
            "textX": 85,
            "textY": 104,
            "title": "Notation 3"
        }
    ],
    "imageXW": 512,
    "imageYW": 512,
    "imageName": "lena_std.ato",
    "tinyDocs": {
        "c01": "JSON image notation data:",
        "c02": "-------------------------",
        "c03": "",
        "c04": "This data contains image notations and related area",
        "c05": "selection information that provides a means for an",
        "c06": "image gallery to display notations with elliptical,",
        "c07": "rectangular, polygonal or freehand area indications",
        "c08": "over an image displayed to a gallery visitor.",
        "c09": "",
        "c10": "X and Y positions are all in image space. The image",
        "c11": "resolution is given as imageXW and imageYW, which",
        "c12": "you use to scale the notation areas to their proper",
        "c13": "locations and sizes for your display of the image,",
        "c14": "regardless of scale.",
        "c15": "",
        "c16": "For Ellipses, anchor is the  center of the ellipse,",
        "c17": "and the extents are the X and Y radii respectively.",
        "c18": "",
        "c19": "For Rectangles, the anchor is the top left and the",
        "c20": "extents are the bottom right.",
        "c21": "",
        "c22": "For Freehand and Polygon area modes, the pointList",
        "c23": "contains a series of numbered XY points. If the area",
        "c24": "is closed, the last point will be the same as the",
        "c25": "first, so all you have to be concerned with is drawing",
        "c26": "lines between the points in the list. Anchor and extent",
        "c27": "are set to the top left and bottom right of the indicated",
        "c28": "region, and can be used as a simplistic rectangular",
        "c29": "detect for the mouse hover position over these types",
        "c30": "of areas.",
        "c31": "",
        "c32": "The textx and texty positions provide basic positioning",
        "c33": "information to help you locate the text information",
        "c34": "in a reasonable location associated with the area",
        "c35": "indication.",
        "c36": "",
        "c37": "Opacity is a value between 0 and 1, where .5 represents",
        "c38": "a 50% opaque backdrop and 1.0 represents a fully opaque",
        "c39": "backdrop. Recommendation is that regions be drawn",
        "c40": "only if the user hovers the pointer over the image,",
        "c41": "and that the text associated with the regions be drawn",
        "c42": "only if the user hovers the pointer over the indicated",
        "c43": "region."
    }
}

Bir JSON öğesini parçalara kesmek için "kukla yorum" satırları ekliyorum:

{

"#############################" : "Part1",

"data1"             : "value1",
"data2"             : "value2",

"#############################" : "Part2",

"data4"             : "value3",
"data3"             : "value4"

}