json-cycle

WebJar for json-cycle

License	MIT
Categories	JSON Data
GroupId	org.webjars.npm
ArtifactId	json-cycle
Last Version	1.3.0
Release Date	Feb 13, 2020
Type	jar
Description	json-cycle WebJar for json-cycle
Project URL	https://www.webjars.org
Source Code Management	https://github.com/valery-barysok/json-cycle

Download json-cycle

Filename	Size
json-cycle-1.3.0.pom
json-cycle-1.3.0.jar	6 KB
json-cycle-1.3.0-sources.jar	22 bytes
json-cycle-1.3.0-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/json-cycle/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>json-cycle</artifactId>
    <version>1.3.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/json-cycle/
implementation 'org.webjars.npm:json-cycle:1.3.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/json-cycle/
implementation ("org.webjars.npm:json-cycle:1.3.0")

Apache Buildr

'org.webjars.npm:json-cycle:jar:1.3.0'

Apache Ivy

<dependency org="org.webjars.npm" name="json-cycle" rev="1.3.0">
  <artifact name="json-cycle" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='json-cycle', version='1.3.0')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "json-cycle" % "1.3.0"

Leiningen

[org.webjars.npm/json-cycle "1.3.0"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

json-cycle

Utilities provide ability to encode/decode circular structures for converting to and from JSON.

Based on JSON-js

Install

In your project:

npm install json-cycle --save

Details

This package contains four functions, decycle, retrocycle, stringify and parse, which make it possible to encode cyclical structures and convert them to JSON, and then recover them. This is a capability that is not provided by ES5. JSONPath is used to represent the links. [http://GOESSNER.net/articles/JsonPath/]

Note: If you stringify javascript structure and then parse it back in some cases you can get not the same javascript structure. For instance, if it contains Date object you get String form of it.

Methods

• decycle
• retrocycle
• stringify
• parse

decycle(object)

Note: decycle function makes a deep copy of any provided structure while original decycle function from JSON-js does not make copy for Boolean, Date, Number, RegExp and String objects.

Makes a deep copy of an provided structure with resolving all circular references. The duplicate references which part of an cycle are replaced with an object of the form

{$ref: PATH}

where the PATH is a JSONPath string that locates the first occurrence.

Example:

    jc = require('json-cycle');
    var a = {};
    a.self = a;
    console.log(JSON.stringify(jc.decycle(a)));

Output:

    {{"$ref":"$"}}

retrocycle(object)

returns provided object

Restores an object that was reduced by decycle function. Members whose values are objects of the form

{$ref: PATH}

are replaced with references to the value found by the PATH. This will restore cycles. The object will be mutated.

Note: The eval function is used to locate the values described by a PATH. The root object is kept in a $ variable. A regular expression is used to assure that the PATH is extremely well formed. The regexp contains nested

• quantifiers. That has been known to have extremely bad performance problems on some browsers for very long strings. A PATH is expected to be reasonably short. A PATH is allowed to belong to a very restricted subset of Goessner's JSONPath.

Example:

    jc = require('json-cycle');
    var s = '{{"$ref":"$"}}';
    jc.retrocycle(JSON.parse(s));

Output:

    produced object equals to 
    var a = {};
    a.self = a;

stringify(object)

It equals to JSON.stringify(decycle(object))

parse(object)

It equals to retrocycle(JSON.parse(object))

License

MIT © 2015-... Valery Barysok, Douglas Crockford

Versions

Version
1.3.0 Feb 13, 2020