![]() | ![]() | ![]() | ||||||||||||
![]() | ||||||||||||||
documentation examples changes amber (jpa) ejb database ioc jmx jsf messaging quercus remoting servlet security hello world java modules json pdo gettext | quercus json
JSON (JavaScript Object Notation) is a popular text data
exchange format with built-in support from Quercus since Resin 3.0.20.
One of the common uses of JSON in a PHP environment is for the server
to send JSON data to the user's browser. Because the JSON language is
a subset of JavaScript, JSON-encoded text can be readily parsed on the
user's browser using JavaScript's
Quercus has built-in JSON support and JSON functionality is enabled the moment Quercus is started: no additional downloads are required. Quercus sports two PHP functions for working with JSON: json_encode and json_decode. json_encode(mixed php_object) encodes any PHP array or object into JSON. json_decode(string json_string [, bool is_assoc]) decodes JSON into a PHP array or object. json_decode may return either a PHP array or object depending on the circumstances:
json_encodeTo encode an array into JSON: <?php $array = array("a"=>"Caucho", "b"=>"Resin", "c"=>"Quercus"); $json = json_encode($array); ?> The value of $json would be: '{"a":"Caucho", "b":"Resin", "c":"Quercus"}'. The JSON text may then be sent and used on the user's browser or to any client that can decode JSON. json_decodeTo decode JSON data into a standard PHP object in Quercus (using the above JSON text $json as an example): <?php $object = json_decode($json); ?> $object would be a standard PHP object with three fields "a", "b", and "c" with values "Caucho", "Resin", and "Quercus" respectively. Simple Web ExampleBelow is a simple example using JSON on the web. <script type="text/javascript"> <?php $array = array("a"=>"Caucho", "b"=>"Resin", "c"=>"Quercus"); $json = json_encode($array); echo "var data = $json;"; ?> var decoded = eval("(" + data + ")"); //Should output: "Quercus at work." document.write(decoded.c + " at work."); </script> AJAX Example JSON data is more commonly sent to
the browser via AJAX requests. Suppose there are two files defined
below. The PHP script in json.php encodes an array into JSON.
When the user's browser is directed to json.html, an AJAX
request receives JSON data from json.php. Then the browser
calls json.php:<?php $array = array("a"=>"Caucho", "b"=>"Resin", "c"=>"Quercus"); $json = json_encode($array); echo $json; ?> json.html:<html> <head> <script type="text/javascript"> var url = "data.php"; function request() { if (window.XMLHttpRequest) http_request = new XMLHttpRequest(); else http_request = new ActiveXObject("Microsoft.XMLHTTP"); http_request.onreadystatechange = function() { handle_json(http_request) }; http_request.open("GET", url, true); http_request.send(null); } function handle_json(http_request) { if (http_request.readyState == 4) { document.firstForm.json.value = http_request.responseText; var decoded = eval("(" + http_request.responseText + ")"); document.firstForm.decoded.value = decoded.a + "'s " + decoded.b + " with " + decoded.c + " at work."; } } function clearForm() { document.firstForm.json.value = ""; document.firstForm.decoded.value = ""; } </script> </head> <body> <form name="firstForm"> <p>JSON:<br><textarea name="json" cols="50"></textarea></p> <p>Decoded:<br><textarea name="decoded" cols="50"></textarea></p> <input type="button" onclick="request()" value="AJAX Request"> <input type="button" onclick="clearForm()" value="Clear"> </form> </body> </html>
|