AJAX

Большинство современных веб-приложений активно использует механизм AJAX. В системном классе фреймворка waRequest есть метод isXMLHttpRequest(), определяющий, получен ли запрос от AJAX-приложения:

waRequest::isXMLHttpRequest()  //возвращает true для AJAX-запросов, в противном случае — false

Иногда формирование содержимого страницы в браузере выполняется только средствами JavaScript. В этом случае с сервера снимается задача генерации HTML-кода с использованием шаблона, а реализация слоя «вид» в терминологии MVC перемещается на клиента. При этом вместо формирования HTML-кода перед сервером встаёт другая задача — передача данных клиенту. Во фреймворке в качестве удобного формата передачи данных для обработки JavaScript-кодом используется JSON.

Для упрощения передачи данных в браузер в виде структур JSON во фреймворке реализованы базовые классы waJsonActions, и waJsonController. Когда необходимо передать в браузер данные в формате JSON вместо HTML-кода, необходимо создать класс экшена или контроллера, унаследованный от одного из этих базовых классов. Названия методов, реализующих логику обработки запроса, должны подчиняться тем же правилам, что и названия методов для экшенов и контроллеров, наследуемых от классов waViewActions и waViewController.

PHP-массив данных, помещенный в поле контроллера response, автоматически конвертируется в JSON-структуру и передаётся в браузер, например:

<?php

class someAppAjaxActions extends waJsonActions
{

    ...
    function testAction()
    {
        ...
        $this->response = array(
            'valA' => 'value first',
            'valB' => 'velue second',
        );
    }

}

Результатом выполнения вышеприведенного экшена будет JSON-массив:

{
    "status":"ok",
    "data":{
        "valA":"value first",
        "valB":"velue second"
    }
}

Простой пример вызова такого экшена из JavaScript:

$.getJSON('?module=ajax&action=test', function (json) {
    alert(json.data.valA);
});