JSON
Javascript对象表示模型(JSON)是一个轻量级的数据交换格式. 简单地讲, 它就是用于传送对象信息的Javascript数组, 如表11-26中的例子所示. 但是JSON对Ajax交互来说有两个主要的好处, 一个是用Javascript易于读取, 二是它可以减小web响应的数据量.
表11-26 Javascript中的JSON对象.
var myJsonData = {"menu": {
"id": "file",
"value": "File",
"popup": {
"menuitem": [
{"value": "New", "onclick": "CreateNewDoc()"},
{"value": "Open", "onclick": "OpenDoc()"},
{"value": "Close", "onclick": "CloseDoc()"}
]
}
}}
如果一个Ajax动作需要返回结构化的数据给调用页面, 以便javascript进一步处理的话, JSON是一个适合作为响应的格式. 比如说, 如果一个Ajax调用想更新调用者页面的多个元素是, 这非常有用.
例如, 设想有一个象表11-27那样的调用页面, 其中含有两个需要更新的元素. 一个远程辅助函数只能更新页面中的一个元素(要么是title, 要么是name), 而不能同时更新两个.
表11-27 用于多个Ajax更新的模板示例
[php]
<h1 id="title">Basic letter</h1>
<p>Dear <span id="name">name_here</span>,</p>
<p>Your e-mail was received and will be answered shortly.</p>
<p>Sincerely,</p>
要更新两者, 把Ajax响应想象成一个包括以下数组的JSON头:
[["title", "My basic letter"], ["name", "Mr Brown"]]
远程调用就能轻易地解析这个响应并且稍稍利用Javascript就可以更新一行中的几个域. 为达到这个效果,将表11-28中的代码加进表11-27的模板即可.
表11-28 从一个远程响应更新多个元素
[php]
<?php echo link_to_remote('Refresh the letter', array(
'url' => 'publishing/refresh',
'complete' => 'updateJSON(request, json)'
)) ?>
<?php echo javascript_tag("
function updateJSON(request, json)
{
var nbElementsInResponse = json.length;
for (var i = 0; i < nbElementsInResponse; i++)
{
Element.update(json[i][0], json[i][1]);
}
}
") ?>
complete 回调函数可以访问响应的json 头并把它传递给第三方函数. 这个updateJSON()函数对JSON头进行迭代, 对数组的每个成员, 用第二个参数更新名字为第一个参数的元素.表11-29 显示了publishing/refresh动作如何返回一个JSON响应.
表11-29 返回JSON头的动作示例
[php]
class publishingActions extends sfActions
{
public function executeRefresh()
{
$output = '[["title", "My basic letter"], ["name", "Mr Brown"]]';
$this->getResponse()->setHttpHeader("X-JSON", '('.$output.')');
return sfView::HEADER_ONLY;
}
HTTP协议允许在响应头中存放JSON.因为响应不包含任何内容,动作只是立即将它作为一个头发送出去.这样它就完全跳过了视图层, 不仅和->renderText()一样快,仅而且更小.
CAUTION There is a severe limitation to the approach shown in Listing 11-29: the maximum size of HTTP headers.There is no official limitation, but large headers may not be well transferred or interpreted by a browser. This means that if your JSON array is large, the remote action should return a normal response, with the JSON as a JavaScript array.注意, 表11-29中的方法有一个服务器的限制, 也即HTTP头的最大容量. 虽然没有正式的规定, 但浏览器不能很好地转换和解释大的HTTP头. 也就是说, 如果你的JSON数组比较大, 那么远程动作会以一个javascript 数组作为JSON来返回一个规范的响应.
JSON已经成为web应用的一个标准. Web服务经常建议用JSON而不是XML去响应, 以便将服务集成到客户端(mashup)而不是服务器端. 所以如果你考虑用哪种格式在服务器和javascript函数间通信, JSON也许是最好的选择.
TIP Since version 5.2, PHP offers two functions, json_encode() and json_decode(), that allow you to convert an array between the PHP syntax and the JSON syntax, and vice versa (http://www.php.net/manual/en/ref.json.php). These facilitate the integration of JSON arrays and Ajax in general.从php5.2开始, php提供了json_encode()和json_decode()两个函数, 以便你在PHP语法和JSON语法之间进行数组转换. 这有助于JSON数组和Ajax的集成.可以参考(http://www.php.net/manual/en/ref.json.php).
