add extjs 6.0.1 sources

[extjs.git] / extjs / packages / core / src / direct / JsonProvider.js

/**\r
 * A base provider for communicating using JSON. This is an abstract class\r
 * and should not be instanced directly.\r
 *\r
 * @abstract\r
 */\r
\r
Ext.define('Ext.direct.JsonProvider', {\r
    extend: 'Ext.direct.Provider',\r
    alias:  'direct.jsonprovider',\r
\r
    uses: [\r
        'Ext.direct.ExceptionEvent',\r
        'Ext.direct.Manager'\r
    ],\r
\r
    /**\r
    * Parse the JSON response\r
    * @private\r
    *\r
    * @param {Object} response The XHR response object\r
    *\r
    * @return {Object} The data in the response.\r
    */\r
    parseResponse: function(response) {\r
        var text = response && response.responseText;\r
        \r
        if (text) {\r
            if (Ext.isObject(text) || Ext.isArray(text)) {\r
                return text;\r
            }\r
\r
            return Ext.decode(text);\r
        }\r
\r
        return null;\r
    },\r
\r
    /**\r
     * Creates a set of events based on the XHR response\r
     *\r
     * @param {Object} response The XHR response\r
     *\r
     * @return {Ext.direct.Event[]} An array of Ext.direct.Event\r
     */\r
    createEvents: function(response) {\r
        var me = this,\r
            data = null,\r
            events = [],\r
            event, i, len;\r
\r
        try {\r
            data = me.parseResponse(response);\r
        }\r
        catch (e) {\r
            event = new Ext.direct.ExceptionEvent({\r
                data: e,\r
                xhr: response,\r
                code: Ext.direct.Manager.exceptions.PARSE,\r
                message: 'Error parsing json response: \n\n ' + e\r
            });\r
\r
            return [event];\r
        }\r
\r
        if (Ext.isArray(data)) {\r
            for (i = 0, len = data.length; i < len; ++i) {\r
                events.push(me.createEvent(data[i]));\r
            }\r
        }\r
        else if (Ext.isObject(data)) {\r
            events.push(me.createEvent(data));\r
        }\r
\r
        return events;\r
    },\r
\r
    /**\r
     * Create an event from a response object\r
     *\r
     * @param {Object} response Response object\r
     *\r
     * @return {Ext.direct.Event} The event\r
     */\r
    createEvent: function(response) {\r
        if (typeof response !== 'object'|| !('type' in response)) {\r
            return new Ext.direct.ExceptionEvent({\r
                data: response,\r
                code: Ext.direct.Manager.exceptions.DATA,\r
                message: 'Invalid data: event type is not specified'\r
            });\r
        }\r
    \r
        return Ext.create('direct.' + response.type, response);\r
    }\r
});