Francais | English | Espanõl

JSON

From Wikipedia, the free encyclopedia

Jump to: navigation, search

JSON is a lightweight computer data interchange format. It is a text-based, human-readable format for representing objects and other data structures and is mainly used to transmit such structured data over a network connection (in a process called serialization).

JSON finds its main application in Ajax web application programming, as a simple alternative to using XML for asynchronously transmitting structured information between client and server.

JSON is a subset of the object literal notation of JavaScript and is commonly used with that language. However the basic types and data structures of most other programming languages can also be represented in JSON, and the format can therefore be used to exchange structured data between programs written in different languages. Code for parsing and generating JSON (the latter is also known as "stringifying") is available for the following languages: ActionScript, C, C#, ColdFusion, Common Lisp, E, Erlang, Java, JavaScript, Lua, ML, Objective CAML, Perl, PHP, Python, Rebol, Ruby, and Tcl.

In December 2005, Yahoo! began offering some of its Web Services optionally in JSON.<ref name="yahoo">Yahoo!. Using JSON with Yahoo! Web services.</ref>

Contents

[edit] Name and specifications

JSON stands for "JavaScript Object Notation" and is pronounced like the English given name Jason, IPA /dʒeɪsən/).

JSON is based on a subset of the JavaScript Programming Language, Standard ECMA-262 3rd Edition - December 1999 <ref>Introducing JSON. json.org.</ref>. The format is specified in RFC 4627. The official MIME Media Type for JSON is application/json.

[edit] Supported data types, syntax and example

JSON's basic types are

The following example shows the JSON representation of an object that describes a person. The object has string fields for first name and last name, contains an object representing the person's address, and contains a list of phone numbers (an array). 

{
    "firstName": "John",
    "lastName": "Smith",
    "address": {
        "city": "New York, NY",
        "zipCode": 10021,
        "streetAddress": "21 2nd Street"
    },
    "phoneNumbers": [
        "212 732-1234",
        "646 123-4567"
    ]
}

Suppose the above text is contained in the JavaScript string variable JSON_text. Since JSON is a subset of JavaScript's object literal notation, one can then recreate the object describing John Smith with a simple eval(): 

 var p=eval("(" + JSON_text + ")");

and the fields p.firstName, p.address.city, p.phoneNumbers[0] etc. are then accessible.

A similar technique works in Python, since JSON also happens to be a subset of that language. In general, eval() should only be used to parse JSON if the source of the JSON-formatted text is completely trusted; the execution of untrusted code with eval() is obviously dangerous. JSON parsers are available to process JSON input from less trusted sources.

[edit] Using JSON in Ajax

The following shows how the client can use an XMLHttpRequest to request an object in JSON format from the server. (The server-side programming is omitted; it has to be set up to respond to requests at url with a JSON-formatted string.) 

var the_object;
var http_request = new XMLHttpRequest();
http_request.open("GET", url, true);
http_request.onreadystatechange = function () {
    if (http_request.readyState == 4) {
        if (http_request.status == 200) {
            the_object = eval("(" + http_request.responseText + ")");
        } else {
            alert("There was a problem with the URL.");
        }
        http_request = null;
    }
};
http_request.send(null);

Note that the use of XMLHttpRequest in this example is not cross-browser; syntactic variations are available on Internet Explorer, Opera, Safari, and Mozilla-based browsers. The usefulness of XMLHttpRequest is limited by the same origin policy: the URL replying to the request must reside on the same host that served the current page.

Browsers can also use <iframe> elements to asynchronously request JSON data in a cross-browser fashion, or use simple <form action="url_to_cgi_script" target="name_of_hidden_iframe"> submissions. These approaches were prevalent prior to the advent of widespread support for XMLHTTPRequest.

Dynamic <script> tags can also be used to transport JSON data. With this technique it is possible to get around the overly restrictive Same Origin Policy but it is insecure. JSONRequest has been proposed as a safer alternative.

[edit] Comparison with other formats

[edit] XML

XML is often used to describe structured data and to serialize objects. XML is however a markup language and is thus significantly more complex than JSON, which is specifically designed as a data interchange format, not a markup language. Both lack a rich mechanism for representing large binary data types such as image data.

[edit] YAML

Some of the limitations of JSON are addressed by the data interchange format YAML. Although YAML is significantly more complex<ref name="whtoyaml">http://bob.pythonmac.org/archives/2005/07/19/what-happened-to-yaml/ What happened to YAML?</ref> than JSON, it is still significantly simpler than XML.

It has been observed that JSON is a nearly functional subset of YAML<ref name="yisj">http://redhanded.hobix.com/inspect/yamlIsJson.html</ref>. YAML parsers can be used to handle most of JSON. This occurred by coincidence and not by design; YAML and JSON were conceived mostly in isolation of each other.

[edit] Other simplified markup languages

[edit] References

<references/>

[edit] External links

  • www.json.org: the specification, documentation, and implementation of JSON readers and writers for numerous programming languages.
  • RFC 4627, formal specification

[edit] Tutorials

[edit] Other

es:JSON fr:JSON ko:JSON it:JSON nl:JSON ja:JavaScript Object Notation pl:JSON pt:JSON ru:JSON

Retrieved from "http://en.wikivisual.com/index.php/JSON"
Personal tools