TestJSON

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #typescript #android #machine-learning #deep-learning #nodejs #java #windows #kubernetes #pytorch #ios #open-source

(★ 50)

A simple project to test JSON libraries with Delphi and C++Builder.

File Explorer

Download Latest Version (.zip)

- Github-01-A.png
- Github-01-B.png
- Github-02-A-McJSON.png
- Github-02-B-uLkJSON.png
- Github-02-C-System.JSON.png
- Github-02-D-JsonDataObjects.png
- Github-02-E-JsonTools.png
- Github-02-F-Json4Delphi.png
- Github-03-A-McJSON.png
- Github-03-B-uLkJSON.png
- Github-03-C-System.JSON.png
- Github-03-D-JsonDataObjects.png
- Github-03-E-SuperObject.png
- Github-03-F-X-SuperObject.png
- Github-03-G-JsonTools.png
- Github-03-H-Json4Delphi.png
- Github-03-I-GrijjyBson.png
- Github-03-J-NeslibJson.png
- Github-03-K-DwsJSON.png
- Github-03-L-ChimeraJson.png
- Test-Open-DX-12.1-CE-chimera.json.png
- Test-Open-DX-12.1-CE-dwsJSON.png
- Test-Open-DX-12.1-CE-DynamicDataObjects.png
- Test-Open-DX-12.1-CE-GrijjyBson.png
- Test-Open-DX-12.1-CE-Json4Delphi.png
- Test-Open-DX-12.1-CE-JsonDataObjects.png
- Test-Open-DX-12.1-CE-jsonDoc.png
- Test-Open-DX-12.1-CE-JsonTools.png
- Test-Open-DX-12.1-CE-McJSON.png
- Test-Open-DX-12.1-CE-MormotJson.png
- Test-Open-DX-12.1-CE-Neslib.Json.png
- Test-Open-DX-12.1-CE-QDAC.png
- Test-Open-DX-12.1-CE-SuperObject.png
- Test-Open-DX-12.1-CE-System.JSON.png
- Test-Open-DX-12.1-CE-uLkJSON.png
- Test-Open-DX-12.1-CE-VSoft.YAML.png
- Test-Open-DX-12.1-CE-X-SuperObject.png
- Test-Speed-CX-12.3-Pro-chimera.json.png
- Test-Speed-CX-12.3-Pro-dwsJSON.png
- Test-Speed-CX-12.3-Pro-DynamicDataObjects.png
- Test-Speed-CX-12.3-Pro-EasyJson.png
- Test-Speed-CX-12.3-Pro-GrijjyBson.png
- Test-Speed-CX-12.3-Pro-Json4Delphi.png
- Test-Speed-CX-12.3-Pro-JsonDataObjects.png
- Test-Speed-CX-12.3-Pro-jsonDoc.png
- Test-Speed-CX-12.3-Pro-JsonTools.png
- Test-Speed-CX-12.3-Pro-McJSON.json.png
- Test-Speed-CX-12.3-Pro-MormotJson.png
- Test-Speed-CX-12.3-Pro-Neslib.Json.png
- Test-Speed-CX-12.3-Pro-QDAC.png
- Test-Speed-CX-12.3-Pro-SuperObject.png
- Test-Speed-CX-12.3-Pro-System.JSON.png
- Test-Speed-CX-12.3-Pro-uLkJSON.png
- Test-Speed-CX-12.3-Pro-VSoft.YAML.png
- Test-Speed-CX-12.3-Pro-X-SuperObject.png
- Test-Speed-DX-12.1-CE-chimera.json.png
- Test-Speed-DX-12.1-CE-dwsJSON.png
- Test-Speed-DX-12.1-CE-DynamicDataObjects.png
- Test-Speed-DX-12.1-CE-EasyJson.png
- Test-Speed-DX-12.1-CE-GrijjyBson.png
- Test-Speed-DX-12.1-CE-Json4Delphi.png
- Test-Speed-DX-12.1-CE-JsonDataObjects-Leaks.png
- Test-Speed-DX-12.1-CE-JsonDataObjects.png
- Test-Speed-DX-12.1-CE-jsonDoc.png
- Test-Speed-DX-12.1-CE-JsonTools.png
- Test-Speed-DX-12.1-CE-McJSON.json.png
- Test-Speed-DX-12.1-CE-MormotJson.png
- Test-Speed-DX-12.1-CE-Neslib.Json.png
- Test-Speed-DX-12.1-CE-QDAC.png
- Test-Speed-DX-12.1-CE-SuperObject.png
- Test-Speed-DX-12.1-CE-System.JSON.png
- Test-Speed-DX-12.1-CE-uLkJSON.png
- Test-Speed-DX-12.1-CE-VSoft.YAML.png
- TestJSON.ico
- preset.json
- PrjTestJsonCXE102.cbproj
- PrjTestJsonCXE102.cpp
- PrjTestJsonCXE102.res
- PrjTestJsonCXE102PCH.h
- PrjTestJsonCXE123.cbproj
- PrjTestJsonCXE123.cpp
- PrjTestJsonCXE123PCH1.h
- PrjTestJsonDX101.dpr
- PrjTestJsonDX101.dproj
- PrjTestJsonDX101.res
- PrjTestJsonDX104.dpr
- PrjTestJsonDX104.dproj
- PrjTestJsonDX104.res
- PrjTestJsonDX113.dpr
- PrjTestJsonDX113.dproj
- PrjTestJsonDX113.res
- PrjTestJsonDX121.dpr
- PrjTestJsonDX121.dproj
- PrjTestJsonDX121.res
- - EasyJson.pas
  - JsonDataObjects
  - JsonDataObjects.pas
  - jsonDoc.pas
  - JsonTools.pas
  - McJSON.pas
  - McUtils.pas
  - mormot.commit.inc
  - mormot.defines.inc
  - myJSON.pas
  - uJSON.pas
  - uLkJSON.pas
  - vsoft.yaml
- FoMain.cpp
- FoMain.dfm
- FoMain.h
- FoMainDx.dfm
- FoMainDx.pas
- Mc.Param.pas
- TJ.Lib.pas
- TJ.LibChimeraJson.pas
- TJ.LibDwsJSON.pas
- TJ.LibDynamicDataObjects.pas
- TJ.LibEasyJson.pas
- TJ.LibGrijjyBson.pas
- TJ.LibJDO.pas
- TJ.LibJson4Delphi.pas
- TJ.LibJsonDoc.pas
- TJ.LibJsonTools.pas
- TJ.LibLkJSON.pas
- TJ.LibMcJSON.pas
- TJ.LibMormot.pas
- TJ.LibNeslibJson.pas
- TJ.LibQDAC.pas
- TJ.LibSuperObject.pas
- TJ.LibSystemJSON.pas
- TJ.LibVSoftYAML.pas
- TJ.LibXSuperObject.pas
- TJ.Test.pas
- TJ.TestFOpen.pas
- TJ.TestSpeedRun.pas
- TJ.TestValid.pas
- - test.json
- - dummy.txt
- - fail01.json
  - fail02.json
  - fail03.json
  - fail04.json
  - fail05.json
  - fail06.json
  - fail07.json
  - fail08.json
  - fail09.json
  - fail10.json
  - fail11.json
  - fail12.json
  - fail13.json
  - fail14.json
  - fail15.json
  - fail16.json
  - fail17.json
  - fail18.json
  - fail19.json
  - fail20.json
  - fail21.json
  - fail22.json
  - fail23.json
  - pass01.json
  - pass02.json
  - pass03.json
  - pass04.json
  - pass05.json
  - pass06.json
  - should01.json
.gitignore
.gitmodules
LICENSE
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Test JSON Libraries
A simple project to test JSON libraries with Delphi and C++Builder.

![](https://raw.githubusercontent.com/hydrobyte/TestJSON/main/images/Github-01-B.png) ![](https://raw.githubusercontent.com/hydrobyte/TestJSON/main/images/Github-01-A.png)

## Disclaimer
This is a *simple* project and not a final product. I know that there are many points that could be better structured. The initial goal was to quickly deploy a single unit "FoMain" kind of project, spending time to include and test the most popular JSON libraries for `Delphi`. The same Pascal code is also compiled and tested with `C++Builder`. The code has a simple structure with `TLib` and `TTest` classes. Also, it is important to mention that the size of JSON objects used in tests here doesn't represent the most common cases of data manipulation in JSON. Finally, the analysis of the results is not intended to detract from any of the tested libraries and should not be seen as any kind of criticism of the authors of the libraries. Knowledge is freedom.

## Tested libraries
Library          | Delphi | C++Builder |
:----------------|:-------|:-----------|
[McJSON](https://github.com/hydrobyte/McJSON)                                              | ✓ | ✓ |
[uLkJSON](https://sourceforge.net/projects/lkjson/)                                        | ✓ | ✓ |
[System.JSON](https://docwiki.embarcadero.com/Libraries/Sydney/en/System.JSON.TJSONObject) | ✓ | ✓ |
[JsonDataObjects](https://github.com/ahausladen/JsonDataObjects)                           | ✓ | ✓ |
[SuperObject](https://github.com/hgourvest/superobject)                                    | ✓ | ✓ |
[X-SuperObject](https://github.com/onryldz/x-superobject)                                  | ✓ | ✓ |
[JsonTools](https://github.com/sysrpl/JsonTools)                                           | ✓ | ✓ |
[Json4Delphi](https://github.com/MaiconSoft/json4delphi)                                   | ✓ | ✓ |
[Grijjy.Bson](https://github.com/grijjy/GrijjyFoundation)                                  | ✓ | ✓ |
[Neslib.Json](https://github.com/neslib/Neslib.Json)                                       | ✓ | ✓ |
[dwsJSON](https://github.com/EricGrange/DWScript)                                          | ✓ | ✓ |
[chimera.json](https://bitbucket.org/sivv/chimera/src/develop/)                            | ✓ | ✓ |
[DynamicDataObjects](https://github.com/SeanSolberg/DynamicDataObjects)                    | ✓ | ✓ |
[EasyJson](https://github.com/tinyBigGAMES/EasyJson)                                       | ✓ | ✓ |
[jsonDoc](http://github.com/stijnsanders/jsonDoc#jsonDoc)                                  | ✓ | ✓ |
[mORMot2](https://github.com/synopse/mORMot2/tree/master/src/core)                         | ✓ | ✓ |
[VSoft.YAML](https://github.com/VSoftTechnologies/VSoft.YAML)                              | ✓ | ✓ |
[QDAC](https://github.com/chinawsb/qdac)                                                   | ✓ | ✓ |

Note: in order of inclusion.

## Compilers and computer
- `Delphi` VCL 32-bits project built with version `12.1` (Athens Community Edition).
- `C++Builder` VCL 32-bits project built with version `12.3` (Athens Professional).
- Old 64-bits machine: AMD A12-9700P RADEON R7, 10 COMPUTE CORES 4C+6G - 2.50 GHz - 12 GB RAM.

## Tests
There are three test types:
- Speed Run
  - Generate `N` items `{ ... "key_i":"value_i", ... }`
  - Save to file
  - Clear
  - Load from file
  - Find `M` items
  - Clone/parse
- Validation
- Open File

## Procedure
For each library and test type the app was ran and closed.
The results of `Speed Run` compute the average time of 5 repetitions.
The Memory consuption is logged and will be part of some results.

## Speed Run test
This is a performance test with the following configuration (select `Default` in the `Preset` list).
- `N` = 50k items.
- `M` = 1k items (keep same random sequence for all tests).
- 5 repetitions.
- `Memory` collumn is the app memory consuption after the `Genereate` sub-test.
- It is expected that the `Clone/Parse` sub-test consumes twice as memory as the `Generate` or `Load from file` sub-test.
- See [images](https://github.com/hydrobyte/TestJSON/tree/main/images) as confirmation.

### Results with Delphi

Library             | Generate  | Save     | Load     | Find     | Parse    | [Total]   | Memory    | Pitfalls |
:-------------------|----------:|---------:|---------:|---------:|---------:|----------:|----------:|---------:|
`JsonDataObjects`   |     .03 s |    .01 s |    .02 s |    .02 s |    .02 s |    0.15 s |  9.39 MiB |          |
`Neslib.Json`       |     .03 s |    .03 s |    .03 s |    .00 s |    .04 s |    0.18 s | 10.19 MiB |          |
`mORMot2`           |     .02 s |    .01 s |    .02 s |    .12 s |    .02 s |    0.23 s |  7.91 MiB |          |
`DynamicDataObjects`|     .03 s |    .02 s |    .04 s |    .00 s |    .05 s |    0.23 s | 14.22 MiB |          |
`Grijjy.Bson`       |     .03 s |    .04 s |    .04 s |    .01 s |    .06 s |    0.24 s |  7.70 MiB |          |
`chimera.json`      |     .04 s |    .03 s |    .08 s |    .01 s |    .08 s |    0.30 s |  8.78 MiB |          |
`QDAC`              |     .02 s |    .03 s |    .03 s |    .21 s |    .05 s |    0.39 s | 11.19 MiB |          |
`McJSON`            |     .02 s |    .06 s |    .02 s |    .18 s |    .08 s |    0.41 s |  9.85 MiB |          |
`System.JSON`       |     .02 s |    .01 s |    .06 s |    .22 s |    .06 s |    0.43 s | 11.38 MiB |          |
`EasyJson`          |     .02 s |    .01 s |    .06 s |    .23 s |    .07 s |    0.45 s | 11.38 MiB |          |
`LkJson`            |     .06 s |    .05 s |    .10 s |    .01 s |    .14 s |    0.45 s |  2.99 MiB |          |
`JsonDoc`           |     .11 s |    .05 s |    .12 s |    .01 s |    .17 s |    0.52 s |  7.77 MiB |          |
`VSoft.YAML`        |     .04 s |    .08 s |    .14 s |    .00 s |    .19 s |    0.53 s |  7.94 MiB |          |
`SuperObject`       |     .13 s |   1.21 s |    .05 s |    .00 s |    .06 s |    1.53 s |  9.68 MiB |          |
`dwsJSON`           |     .01 s |    .01 s |    .92 s |    .03 s |    .91 s |    1.92 s |  9.88 MiB |          |
`JsonTools`         |   10.36 s |        - |        - |    .22 s |   8.55 s |   19.18 s |  7.88 MiB | Fails    |
`Json4Delphi`       |     .02 s |    .06 s |  35.00 s |    .40 s |  35.71 s |   71.23 s | 11.57 MiB |          |
`X-SuperObject`     |  5.18 min |    .06 s | 1.77 min |   6.18 s | 1.76 min |  8.81 min | 11.48 MiB |          |

Notes:
- Ordered by [Total] ASC.
- See [Conclusions](#Conclusions) about the `EasyJson` and `System.JSON`.
- See [Know issues](#know-issues) about the incomplete test for `JsonTools`.

### Results with C++Builder

Library             | Generate  | Save     | Load     | Find     | Parse    | Total     | Memory    | Pitfalls |
:-------------------|----------:|---------:|---------:|---------:|---------:|----------:|----------:|---------:|
`Neslib.Json`       |     .05 s |    .02 s |    .03 s |    .00 s |    .06 s |    0.24 s |     - MiB |          |
`mORMot2`           |     .05 s |    .00 s |    .03 s |    .11 s |    .02 s |    0.28 s |     - MiB |          |
`Grijjy.Bson`       |     .06 s |    .04 s |    .06 s |    .00 s |    .08 s |    0.32 s |     - MiB |          |
`DynamicDataObjects`|     .07 s |    .02 s |    .05 s |    .00 s |    .06 s |    0.33 s |     - MiB |          |
`QDAC`              |     .04 s |    .03 s |    .03 s |    .24 s |    .07 s |    0.53 s |     - MiB |          |
`System.JSON`       |     .03 s |    .01 s |    .07 s |    .25 s |    .07 s |    0.55 s |     - MiB |          |
`chimera.json`      |     .10 s |    .04 s |    .15 s |    .01 s |    .16 s |    0.56 s |     - MiB |          |
`JsonDoc`           |     .14 s |    .04 s |    .11 s |    .01 s |    .17 s |    0.57 s |     - MiB |          |
`EasyJson`          |     .04 s |    .02 s |    .07 s |    .25 s |    .07 s |    0.60 s |     - MiB |          |
`McJSON`            |     .03 s |    .11 s |    .03 s |    .23 s |    .14 s |    0.64 s |     - MiB |          |
`VSoft.YAML`        |     .05 s |    .12 s |    .15 s |    .01 s |    .22 s |    0.65 s |     - MiB |          |
`LkJson`            |     .09 s |    .11 s |    .23 s |    .06 s |    .33 s |    0.91 s |     - MiB |          |
`SuperObject`       |     .28 s |   1.29 s |    .06 s |    .01 s |    .07 s |    1.83 s |     - MiB |          |
`dwsJSON`           |     .03 s |    .02 s |    .91 s |    .02 s |    .91 s |    1.97 s |     - MiB |          |
`JsonDataObjects`   |    5.75 s |    .02 s |    .10 s |    .13 s |    .10 s |    6.15 s |     - MiB |          |
`JsonTools`         |   13.85 s |   1.13 s |        - |        - |        - |   17.91 s |     - MiB | Fails    |
`Json4Delphi`       |     .03 s |    .45 s | 4.43 min |   1.68 s |        - |  4.63 min |     - MiB | Fails    |
`X-SuperObject`     |  4.47 min |    .25 s | 1.55 min |   5.32 s | 1.54 min |  7.65 min |     - MiB |          |

Notes:
- Ordered by [Total] ASC.
- See [Know issues](#know-issues) about the incomplete test for `JsonTools`.

## Validation test
This validation test should be analyzed carefully. Some libraries have violations for some sort of self-management in reading JSON data.
- `.\test\valid` files extracted from [MJPA/SimpleJSON](https://github.com/MJPA/SimpleJSON)
- These are not valid JSON files because the first line has a text as description.
- The `shouldNN.json` files test for default behavior flagged as "should" rules, such as the existence of "duplicated keys" (See [Issue 16](https://github.com/hydrobyte/TestJSON/issues/16)).
- The libraries are presented in the order in which they were added to this project.
- Ideally, you should have only one "-" as results.

### Results with Delphi and C++Builder

Library             | Expected to Fail but Passed                      | Expected to Pass but Failed | Duplicates Fail |
:-------------------|-------------------------------------------------:|----------------------------:|:---------------:|
`McJSON`            |                                                - |                           - | Yes             |
`LkJson`            |             fail(01, 07, 08, 16, 18, 19, 20, 21) |                           - | No              |
`System.JSON`       |                                         fail(07) |                    pass(04) | No              |
`JsonDataObjects`   |                                                - |                           - | No              |
`SuperObject`       | fail(01, 06, 07, 08, 10, 11, 16, 18, 19, 20, 21) |                           - | No              |
`X-SuperObject`     |     fail(01, 06, 08, 15, 16, 17, 18, 19, 20, 21) |            pass(01, 04, 05) | No              |
`JsonTools`         |                             fail(01, 16, 20, 21) |                pass(04, 05) | No              |
`Json4Delphi`       |                                                - |    pass(01, 03, 04, 05, 06) | Yes             |
`Grijjy.Bson`       |                                     fail(15, 20) |        pass(01, 02, 04, 05) | Yes             |
`Neslib.Json`       |                 fail(07, 15, 16, 18, 19, 20, 21) |                pass(04, 05) | No              |
`dwsJSON`           |                             fail(16, 18, 19, 21) |                           - | No              |
`chimera.json`      |         fail(01, 08, 10, 16, 18, 19, 20, 21, 23) |                           - | No              |
`DynamicDataObjects`|                                     fail(18, 19) |                    pass(01) | No              |
`EasyJson`          |                                         fail(07) |                pass(04, 05) | No              |
`JsonDoc`           |                                 fail(15, 20, 21) |        pass(01, 02, 04, 05) | No              |
`mORMot2`           |             fail(05, 06, 10, 11, 15, 18, 19, 21) |                pass(04, 05) | No              |
`VSoft.YAML`        |                                                - |                           - | No              |
`QDAC`              |                      fail(01, 06, 07, 08, 15~22) |                    pass(01) | No              |

List of test files names and description
- `fail01.json = \x is not a valid escape character`
- `fail02.json = Objects require colon between name/value`
- `fail03.json = Objects do not have comma separators`
- `fail04.json = Arrays don't have colon separators`
- `fail05.json = Truth is not a valid boolean value`
- `fail06.json = Strings need double quotes, not single quotes`
- `fail07.json = Line break in a string value is not valid`
- `fail08.json = Escaped line break char is still not valid`
- `fail09.json = Unclosed array`
- `fail10.json = Numbers require exponent if 'e' is there`
- `fail11.json = Only 1 sign char can precede the value`
- `fail12.json = Commas cannot close objects`
- `fail13.json = Brackets must be matching`
- `fail14.json = Double quotes must be escaped`
- `fail15.json = Key string must be quoted`
- `fail16.json = Arrays must not have comma after last value`
- `fail17.json = Arrays must have values between commas`
- `fail18.json = Nothing but whitespace can follow the root value`
- `fail19.json = Each opening bracket must be closed`
- `fail20.json = Extra comma after object`
- `fail21.json = Numbers cannot have leading 0s`
- `fail22.json = Numbers can't be hex encoded`
- `fail23.json = Decimal numbers need a digit before the dot`
- `pass01.json = General large array testing valid values`
- `pass02.json = Heavily nested array`
- `pass03.json = Nested object`
- `pass04.json = Simple string value`
- `pass05.json = Unicode character string`
- `pass06.json = From https://json.org/example.html`
- `should01.json = The names within an object SHOULD be unique (RFC 8259)`

## Open File test
This is a simple test to open files with any library included into this project using a large JSON files (~ 1 MiB in size).
- Opens file with `Verbose` unchecked.
- Statistics for memory allocated and loading time.
- Opens file with `Verbose` checked.
- Checks JSON was read and processed by `ToString` method.
- Checks memory leaking when closing the app.
- Load time in milliseconds.

### Results with Delphi

Library             |  Memory | Factor  | Load Time | Pitfalls         |
:-------------------|--------:|--------:|----------:|-----------------:|
`JsonDataObjects`   |  2143.2 |      2x |     12.20 |                  |
`Grijjy.Bson`       |  4313.1 |      4x |     28.20 |                  |
`dwsJSON`           |  4776.2 |      5x |     15.40 |                  |
`JsonDoc`           |  5024.6 |      5x |     18.80 |                  |
`Neslib.Json`       |  4676.6 |      5x |     21.80 |                  |
`LkJson`            |  6291.7 |      6x |     72.00 |                  |
`SuperObject`       |  7180.1 |      7x |     68.60 |                  |
`DynamicDataObjects`|  8871.1 |      9x |     27.80 |                  |
`System.JSON`       |  9420.3 |      9x |     40.60 |                  |
`EasyJson`          |  9420.3 |      9x |     50.20 |                  |
`McJSON`            | 10385.7 |     10x |     46.80 |                  |
`X-SuperObject`     | 10388.4 |     10x |    121.80 | ToString() fails |
`Json4Delphi`       |  9505.3 |     10x |    243.60 |                  |
`chimera.json`      | 12086.7 |     12x |    915.60 |                  |
`QDAC`              | 14302.3 |     14x |     84.20 |                  |
`VSoft.YAML`        | 19845.2 |     19x |    177.80 |                  |
`JsonTools`         |       - |       - |         - | Load file fails  |
`mORMot2`           |       - |       - |         - | Load file fails  |

Notes:
- Ordered by: Factor, Load Time ASC.
- Memory in kiB.
- Allocation Factor = Round(Memory in kiB / 1000 kiB).

The Top-Three libraries with the lowest memory consumption (allocation factor) are: `JsonDataObjects`, `Grijjy.Bson` and `dwsJSON`. It is worth highlighting the superior performance of the combined factors from `JsonDataObjects`.

The Top-Three fastest libraries in terms of loading time are: `JsonDataObjects`, `dwsJSON` and `JsonDoc`.

In general, `JsonDataObjects` might be considered the best library in respect of memory consumption and loading time tradeoff, highlighting its remarkable low memory and allocation factor without pitfalls.

## Conclusions
1. All `Speed Run` tests with `Delphi` version are almost twice as fast as with `C++Builder`.

2. `JsonDataObjects` is the fastest library tested until now, closely followed `Neslib.Json`, `mORMot2` and `Grijjy.Bson` (technical draw), however it experiences a performance drop in the version compiled for `C++Builder` (in `Generate` sub-test).

3. The `Validation` tests can demonstrate that even the most modern libraries can have occasional small violations against the standard. Total clear for `McJSON`, `JsonDataObjects` and `VSoft.YAML`.

4. The `Open File` tests using a file slightly larger than most common JSON uses demonstrate significant variation in terms of loading time and allocation factor.

5. Considering JSON files with a larger amount of data, there are significant differences in terms of memory consumption and loading time. The positive highlight is `JsonDataObjects`.

6. For JSON structures with less than 5000 objects, the choice of libraries can be screened not only based on performance. Standard/Compiler compatibility and ease of use should have priority in terms of choice criterion.

7. For older versions of `Delphi` and `C++Builder`, the `McJSON` library can be a good choice in terms of compatibility, ease of use and good performance.

8. This project demonstrates some of the facilities and obstacles encountered by C++Builder developers in using libraries developed for Delphi. But it must be acknowledged that version 12 of `C++Builder` is the first to be able to compile all libraries.

9. `EasyJson` uses `System.JSON` internally, so it is expected to see similar results.

10. `LkJson` has great performance and the lowest memory consumption among all tested libraries in `Speed` tests. Maybe something related to the `key:value` using small strings. This has a different benchmark in `Open File` tests. Some changes are needed to use it with Delphi and C++Builder 10.2 (and up) in order to save and load UTF-8 encoded files. For some, an obstacle can be that their interfaces are more verbose for C++ usage. For example:
````cpp
JsonP = dynamic_cast<TlkJSONObject*>(TlkJSON::ParseText(TlkJSON::GenerateText(Json)))
````

## Know issues
- `TgoBsonDocument.LoadFromJsonFile()` failed.
- `SuperObject` compiles but it is not working with C++Builder. Any help getting `SuperObject` working with C++Builder is appreciated.
- `JsonTools` had problems saving to file: it was truncated at object `"key25412"`. So, `Speed Run` tests were ran without the `Clear` and `Load from file` steps.
- `JsonTools` gave an error `Root node must be an array or object` trying to load form a UTF-8 file with 50k items file from other sub-tests.
- `chimera.json` seems to completelly break Delphi 10.4's code completion (Code insight manager = LSP).

These libraries were tested:
- [XSuperObject](https://github.com/onryldz/x-superobject) does not compile with `C++Builder` 10.2.
- [dwsJSON](https://github.com/EricGrange/DWScript/blob/master/Source/dwsJSON.pas) does not compile with `Delphi` 10.1 Starter.

## Changes on original source code
There were necessary modifications in order to compile and run some libraries with C++Builder.
- `uLkJSON`:
  - `{$DEFINE USE_D2009}`
  - `TlkJSONstreamed.LoadFromStream();`
  - `TlkJSONstreamed.SaveToStream();`
- `SuperObject`:
  - `defined(VER290) or defined(VER300) or defined(VER310) or defined(VER320) or defined(VER330) or defined(VER340) or defined(VER350) or defined(VER360)`
  - `procedure FromInterface;`
- `QDAC`
  - `*.pas` files converted CharSet from `GB2312(simplified)` to `UTF-8` using Notepad++.

TestJSON

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

TestJSON

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README