Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

JSON-Serialize.js provides conventions and helpers to manage serialization and deserialization of instances to/from JSON

branch: master

Rebuild

latest commit ae838888d2
Kevin Malakoff authored November 25, 2013
Octocat-spinner-32 docs Added AMD loader September 17, 2012
Octocat-spinner-32 packages Rebuild November 25, 2013
Octocat-spinner-32 src Added AMD loader September 17, 2012
Octocat-spinner-32 test Updated AMD tests March 30, 2013
Octocat-spinner-32 vendor Updated AMD tests March 30, 2013
Octocat-spinner-32 .gitignore Ignore Bower March 30, 2013
Octocat-spinner-32 .travis.yml Update CI September 12, 2012
Octocat-spinner-32 Bakefile.coffee Added AMD loader September 17, 2012
Octocat-spinner-32 LICENSE Upgraded to easy-bake, added packaging tests, and re-wrote in CoffeeS… June 09, 2012
Octocat-spinner-32 README.md Update to 1.1.2 September 18, 2012
Octocat-spinner-32 RELEASE_NOTES.md Update to 1.1.2 September 18, 2012
Octocat-spinner-32 component.json Bower publish March 30, 2013
Octocat-spinner-32 json-serialize.js Rebuild November 25, 2013
Octocat-spinner-32 json-serialize.min.js Rebuild March 26, 2013
Octocat-spinner-32 package.json Rebuild November 25, 2013
README.md

JSON-Serialize.js provides conventions and helpers to manage serialization and deserialization of instances to/from JSON.

Download Latest (1.1.2):

Please see the release notes for upgrade pointers.

Module Loading

JSON-Serialize.js is compatible with RequireJS, CommonJS, Brunch and AMD module loading. Module names:

  • 'json-serialize' - json-serialize.js.

Examples

1) JSON-Serialize natively supports nested Date serialization so this "just works":

var embedded_date_objects = [
  new Date(),
  {to: new Date, from: new Date},
  [1, new Date]
];

var json = JSON.serialize(embedded_date_objects);
var deserialized_embedded_date_objects = JSON.deserialize(json);

equal(_.isEqual(embedded_date_objects, deserialized_embedded_date_objects), true, 'the nested dates were deserialized automatically')

Pretty cool, eh?

2) Creating custom serialization for one of your classes.

class SomeClass
  constructor: (int_value, string_value, date_value) ->
    this.int_value = int_value;
    this.string_value = string_value;
    this.date_value = date_value;

  toJSON: ->
    return {
      _type:'SomeClass',
      int_value:this.int_value,
      string_value:this.string_value,
      date_value:JSON.serialize(this.date_value)
    }

  @fromJSON: (json) ->    # note: this is a class method
    if (json._type!='SomeClass') return null;
    return new SomeClass(json.int_value, json.string_value, JSON.deserialize(json.date_value));

Now you can automatically serialize and deserialize it:

instance = new SomeClass(1, 'two', new Date());
json = JSON.serialize(instance)   # this calls the toJSON function on the instance

instance2 = JSON.deserialize(json)   # this calls the fromJSON function on the class (you need to make sure the constructor can be found)

Conventions

Uses the following configurable conventions:

  1. use a '_type" field in the json that you serialize
  2. for serializing, implement a toJSON function as an instance method.
  3. for deserializing, implement a fromJSON deserialization factory function as an class method. This doesn't need to be a class function but can be any function as long as it can be found (see JSON.deserialize.NAMESPACE_ROOTS).

Options

  • JSON.deserialize.TYPE_FIELD

You can globally choose the type field used when deserializing an instance from JSON.

For example, if you use couchdb, you could use a 'type' field convention:

JSON.deserialize.TYPE_FIELD = 'type'
  • JSON.deserialize.NAMESPACE_ROOTS

If you don't want to pollute the global namespace with your deserialization factory functions, you can put them in any sort of nested namespaces. Just register your namespace roots like:

JSON.deserialize.NAMESPACE_ROOTS.push(window.my_classes)

Building, Running and Testing the library

Installing:

  1. install node.js: http://nodejs.org
  2. install node packages: 'npm install'

Commands:

Look at: https://github.com/kmalakoff/easy-bake

Something went wrong with that request. Please try again.