JSON エクステンション¶

Fabric Engine version 2.4.0

バージョン 1.13.0 で追加.

JSON エクステンションは基本的なJSONエンコーダーとパーサをKLで実装します。

JSONテキストの構文解析¶

次のコードでは、構文解析のためにJSON文字列を JSONDoc へ受け渡して、その後関連データを抽出するまでを紹介します。

require JSON;

operator entry() {

  String json = "    {\n\
    \"firstName\": \"John\",
    \"lastName\": \"Smith\",
    \"isAlive\": true,
    \"age\": 25,
    \"height_cm\": 167.64,
    \"address\": {
        \"streetAddress\": \"21 2nd Street\",
        \"city\": \"New York\",
        \"state\": \"NY\",
        \"postalCode\": \"10021-3100\"
    },
    \"phoneNumbers\": [
        { \"type\": \"home\", \"number\": \"212 555-1234\" },
        { \"type\": \"fax\",  \"number\": \"646 555-4567\" }
    ]
  }";

  JSONDoc doc();
  doc.parse(json);

  {
    // Now read the data back.
    report("firstName:" + doc.root.getString("firstName"));
    report("lastName:" + doc.root.getString("lastName"));
    report("isAlive:" + doc.root.getBoolean("isAlive"));

    // Test casting
    report("f_age:" + doc.root.getScalar("age"));
    report("i_age:" + doc.root.getInteger("age"));

    report("f_height_cm:" + doc.root.getScalar("height_cm"));
    report("i_height_cm:" + doc.root.getInteger("height_cm"));

    JSONDictValue address = doc.root.get("address");

    JSONArrayValue phoneNumbers = doc.root.get("phoneNumbers");
    JSONDictValue num1 = phoneNumbers.get(0);
    report("number:" + num1.getString("number"));
  }
}

/*
** Output:

firstName:John
lastName:Smith
isAlive:true
f_age:+25.0
i_age:25
f_height_cm:+167.64
i_height_cm:167
number:212 555-1234

*/

頑健性、ロバストネス(Robustness)¶

JSONDoc パーサは可能な限り頑丈に構築されており、少し不正なJSON文字列でも解析処理します。辞書および配列は、辞書または配列定義の終わりに末尾のカンマが残される場合でもイベントを正常に解析します。

require JSON;

operator entry() {

  String json = "    {\n\
    \"address\": {
        \"streetAddress\": \"21 2nd Street\",
        \"city\": \"New York\",
        \"state\": \"NY\",
        \"postalCode\": \"10021-3100\",
    },
    \"phoneNumbers\": [
        { \"type\": \"home\", \"number\": \"212 555-1234\" },
        { \"type\": \"fax\",  \"number\": \"646 555-4567\" },
    ]
  }";

  JSONDoc doc();
  doc.parse(json);

  {
    // Now read the data back.
    JSONDictValue address = doc.root.get("address");
    report("streetAddress:" + address.getString("streetAddress"));

    JSONArrayValue phoneNumbers = doc.root.get("phoneNumbers");
    JSONDictValue num1 = phoneNumbers.get(0);
    report("number:" + num1.getString("number"));
  }

}

/*
** Output:

streetAddress:21 2nd Street
number:212 555-1234

*/

数学構造体¶

JSONDoc パーサは、 Math エクステンションで定義したいくつかの一般的に使用する数学型のロードとセーブを扱います。

require JSON;

operator entry() {

  String json = " \n\n   {\n
    \"vec3\" \n
    : { 'x': 12.3, 'y': 12, 'z': 0 },\n
    \"vec2Array\"  : [ \n
        { 'x': 12.3,'y': 12 }, \n
        {  \n
        'x': 3, \n
        'y':1.2  \n
       } \n
    ], \n
    \"color\": { 'r': 12.3, 'g': 12, 'b': 0, 'a': 0 },\n
  }";

  JSONDoc doc();
  doc.parse(json);

  {
    // Now read the data back.
    report("vec3:" + doc.root.getVec3("vec3"));

    JSONArrayValue vec2Array = doc.root.get("vec2Array");
    report("vec2_1:" + vec2Array.getVec2(0));
    report("vec2_2:" + vec2Array.getVec2(1));

    JSONDictValue dict = doc.root.get("color");
    report("color:" + dict.toColor());
  }

}

/*
** Output:

vec3:{x:+12.3,y:+12.0,z:+0.0}
vec2_1:{x:+12.3,y:+12.0}
vec2_2:{x:+3.0,y:+1.2}
color:{r:+12.3,g:+12.0,b:+0.0,a:+0.0}

*/

書き込み¶

JSONDoc はJSONのエンコードにも使用できます。

require JSON;

operator entry() {

  JSONDoc doc();
  doc.root.setString("firstName", "John");
  doc.root.setString("lastName", "Smith");
  doc.root.setBoolean("isAlive", true);
  doc.root.setInteger("age", 25);
  doc.root.setScalar("height_cm", 167.64);

  JSONDictValue address();
  address.setString("streetAddress", "21 2nd Street");
  address.setString("city", "New York");
  address.setString("state", "NY");
  address.setString("postalCode", "10021-3100");
  doc.root.set("address", address);

  JSONDictValue num1();
  num1.setString("type", "home");
  num1.setString("number", "212 555-1234");
  JSONDictValue num2();
  num2.setString("type", "home");
  num2.setString("number", "212 555-1234");

  JSONArrayValue phoneNumbers();
  phoneNumbers.add(num1);
  phoneNumbers.add(num2);
  doc.root.set("phoneNumbers", phoneNumbers);

  JSONArrayValue vec2Array();
  vec2Array.add(JSONDictValue(Vec2( 12.3, 12 )));
  vec2Array.add(JSONDictValue(Vec2( 3, 1.2 )));
  doc.root.set("vec2Array", vec2Array);

  JSONArrayValue numbers1();
  numbers1.addInteger(1);
  numbers1.addInteger(2);
  numbers1.addInteger(3);
  numbers1.addInteger(4);
  numbers1.addInteger(5);
  numbers1.addInteger(6);
  doc.root.set("numbers1", numbers1);

  JSONArrayValue numbersAndVec();
  numbersAndVec.addInteger(1);
  numbersAndVec.addInteger(2);
  numbersAndVec.add(JSONDictValue(Vec2( 12.3, 12 )));
  doc.root.set("numbersAndVec", numbersAndVec);

  JSONArrayValue numbersAndSimpleString();
  numbersAndSimpleString.addInteger(1);
  numbersAndSimpleString.addInteger(2);
  numbersAndSimpleString.addInteger(3);
  numbersAndSimpleString.addInteger(4);
  numbersAndSimpleString.addInteger(5);
  numbersAndSimpleString.addInteger(6);
  numbersAndSimpleString.addInteger(7);
  numbersAndSimpleString.addInteger(8);
  numbersAndSimpleString.addString("Foo");
  doc.root.set("numbersAndSimpleString", numbersAndSimpleString);

  JSONArrayValue numbersAndBigString();
  numbersAndBigString.addInteger(1);
  numbersAndBigString.addInteger(2);
  numbersAndBigString.addString(
    "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor " +
    "incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud " +
    "exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute " +
    "irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla " +
    "pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia " +
    "deserunt mollit anim id est laborum.");
  doc.root.set("numbersAndBigString", numbersAndBigString);

  String json = doc.write(2);
  report(json);
}

/*
** Output:

{
  "firstName": "John", 
  "lastName": "Smith", 
  "isAlive": true, 
  "age": 25, 
  "height_cm": 167.64, 
  "address": {"streetAddress": "21 2nd Street", "city": "New York", "state": "NY", "postalCode": "10021-3100"}, 
  "phoneNumbers": [
    {"type": "home", "number": "212 555-1234"}, 
    {"type": "home", "number": "212 555-1234"}
  ], 
  "vec2Array": [
    {"x": 12.3, "y": 12.0}, 
    {"x": 3.0, "y": 1.2}
  ], 
  "numbers1": [1, 2, 3, 4, 5, 6], 
  "numbersAndVec": [
    1, 
    2, 
    {"x": 12.3, "y": 12.0}
  ], 
  "numbersAndSimpleString": [
    1, 
    2, 
    3, 
    4, 
    5, 
    6, 
    7, 
    8, 
    "Foo"
  ], 
  "numbersAndBigString": [
    1, 
    2, 
    "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."
  ]
}

*/

マージ¶

JSONDoc は、データのツリーをマージした新しいドキュメントを作るために他のJSONドキュメントをマージできます。

require JSON;

operator entry() {

  String json1 = "{
    'firstName': 'John',
    'lastName': 'Smith',
    'isAlive': true,
    'age': 25,
    'height_cm': 167.64,
    'address': {
        'streetAddress': '54 Queen Street'
    },
    'phoneNumbers': [
        { 'type': 'cell',  'number': '514 561-6312' }
    ]
  }";

  JSONDoc doc1();
  doc1.parse(json1);

  String json2 = "{
    'firstName': 'Fred',
    'height_cm': 187.64,
    'address': {
        'streetAddress': '21 2nd Street',
        'city': 'New York',
        'state': 'NY',
        'postalCode': '10021-3100'
    },
    'phoneNumbers': [
        { 'type': 'home', 'number': '212 555-1234' },
        { 'type': 'fax',  'number': '646 555-4567' }
    ]
  }";


  JSONDoc doc2();
  doc2.parse(json2);

  doc1.merge(doc2);


  {
    // Now read the data back.
    report("firstName:" + doc1.root.getString("firstName"));
    report("lastName:" + doc1.root.getString("lastName"));
    report("isAlive:" + doc1.root.getBoolean("isAlive"));

    // Test casting
    report("f_age:" + doc1.root.getScalar("age"));
    report("i_age:" + doc1.root.getInteger("age"));

    report("f_height_cm:" + doc1.root.getScalar("height_cm"));
    report("i_height_cm:" + doc1.root.getInteger("height_cm"));

    JSONDictValue address = doc1.root.get("address");

    JSONArrayValue phoneNumbers = doc1.root.get("phoneNumbers");
    JSONDictValue num1 = phoneNumbers.get(0);
    report("number type:" + num1.getString("type") + " number:" + num1.getString("number"));
    JSONDictValue num3 = phoneNumbers.get(2);
    report("number type:" + num3.getString("type") + " number:" + num3.getString("number"));
  }
}

/*
** Output:

firstName:Fred
lastName:Smith
isAlive:true
f_age:+25.0
i_age:25
f_height_cm:+187.64
i_height_cm:187
number type:cell number:514 561-6312
number type:fax number:646 555-4567

*/

目次¶

None

JSON エクステンション¶

JSONテキストの構文解析¶

頑健性、ロバストネス(Robustness)¶

数学構造体¶

書き込み¶

マージ¶

目次¶

索引と検索¶

目次

前のトピックへ

次のトピックへ

このページ