X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/6746dc89c47ed01b165cc1152533605f97eb8e8d..f562e4c6e5fac7bcb445985b99acbea4d706e6f0:/src/data/proxy/JsonP.js diff --git a/src/data/proxy/JsonP.js b/src/data/proxy/JsonP.js index 7447d17d..2c68f7be 100644 --- a/src/data/proxy/JsonP.js +++ b/src/data/proxy/JsonP.js @@ -14,154 +14,130 @@ If you are unsure which license is appropriate for your use, please contact the */ /** * @author Ed Spencer - * @class Ext.data.proxy.JsonP - * @extends Ext.data.proxy.Server * - *
JsonPProxy is useful when you need to load data from a domain other than the one your application is running - * on. If your application is running on http://domainA.com it cannot use {@link Ext.data.proxy.Ajax Ajax} to load its - * data from http://domainB.com because cross-domain ajax requests are prohibited by the browser.
+ * The JsonP proxy is useful when you need to load data from a domain other than the one your application is running on. If + * your application is running on http://domainA.com it cannot use {@link Ext.data.proxy.Ajax Ajax} to load its data + * from http://domainB.com because cross-domain ajax requests are prohibited by the browser. * - *We can get around this using a JsonPProxy. JsonPProxy injects a <script> tag into the DOM whenever - * an AJAX request would usually be made. Let's say we want to load data from http://domainB.com/users - the script tag - * that would be injected might look like this:
+ * We can get around this using a JsonP proxy. JsonP proxy injects a ` * - *When we inject the tag above, the browser makes a request to that url and includes the response as if it was any - * other type of JavaScript include. By passing a callback in the url above, we're telling domainB's server that we - * want to be notified when the result comes in and that it should call our callback function with the data it sends - * back. So long as the server formats the response to look like this, everything will work:
+ * When we inject the tag above, the browser makes a request to that url and includes the response as if it was any + * other type of JavaScript include. By passing a callback in the url above, we're telling domainB's server that we want + * to be notified when the result comes in and that it should call our callback function with the data it sends back. So + * long as the server formats the response to look like this, everything will work: * -
-someCallback({
- users: [
- {
- id: 1,
- name: "Ed Spencer",
- email: "ed@sencha.com"
- }
- ]
-});
-
+ * someCallback({
+ * users: [
+ * {
+ * id: 1,
+ * name: "Ed Spencer",
+ * email: "ed@sencha.com"
+ * }
+ * ]
+ * });
*
- * As soon as the script finishes loading, the 'someCallback' function that we passed in the url is called with the - * JSON object that the server returned.
+ * As soon as the script finishes loading, the 'someCallback' function that we passed in the url is called with the JSON + * object that the server returned. * - *JsonPProxy takes care of all of this automatically. It formats the url you pass, adding the callback - * parameter automatically. It even creates a temporary callback function, waits for it to be called and then puts - * the data into the Proxy making it look just like you loaded it through a normal {@link Ext.data.proxy.Ajax AjaxProxy}. - * Here's how we might set that up:
+ * JsonP proxy takes care of all of this automatically. It formats the url you pass, adding the callback parameter + * automatically. It even creates a temporary callback function, waits for it to be called and then puts the data into + * the Proxy making it look just like you loaded it through a normal {@link Ext.data.proxy.Ajax AjaxProxy}. Here's how + * we might set that up: * -
-Ext.define('User', {
- extend: 'Ext.data.Model',
- fields: ['id', 'name', 'email']
-});
-
-var store = new Ext.data.Store({
- model: 'User',
- proxy: {
- type: 'jsonp',
- url : 'http://domainB.com/users'
- }
-});
-
-store.load();
-
+ * Ext.define('User', {
+ * extend: 'Ext.data.Model',
+ * fields: ['id', 'name', 'email']
+ * });
*
- * That's all we need to do - JsonPProxy takes care of the rest. In this case the Proxy will have injected a - * script tag like this: + * var store = Ext.create('Ext.data.Store', { + * model: 'User', + * proxy: { + * type: 'jsonp', + * url : 'http://domainB.com/users' + * } + * }); * -
-<script src="http://domainB.com/users?callback=stcCallback001" id="stcScript001"></script>
-
+ * store.load();
*
- * Customization
+ * That's all we need to do - JsonP proxy takes care of the rest. In this case the Proxy will have injected a script tag + * like this: * - *Most parts of this script tag can be customized using the {@link #callbackParam}, {@link #callbackPrefix} and - * {@link #scriptIdPrefix} configurations. For example: + * * -
-var store = new Ext.data.Store({
- model: 'User',
- proxy: {
- type: 'jsonp',
- url : 'http://domainB.com/users',
- callbackParam: 'theCallbackFunction',
- callbackPrefix: 'ABC',
- scriptIdPrefix: 'injectedScript'
- }
-});
-
-store.load();
-
+ * # Customization
+ *
+ * This script tag can be customized using the {@link #callbackKey} configuration. For example:
+ *
+ * var store = Ext.create('Ext.data.Store', {
+ * model: 'User',
+ * proxy: {
+ * type: 'jsonp',
+ * url : 'http://domainB.com/users',
+ * callbackKey: 'theCallbackFunction'
+ * }
+ * });
+ *
+ * store.load();
+ *
+ * Would inject a script tag like this:
*
- * Would inject a script tag like this:
+ * * -
-<script src="http://domainB.com/users?theCallbackFunction=ABC001" id="injectedScript001"></script>
-
+ * # Implementing on the server side
*
- * Implementing on the server side
+ * The remote server side needs to be configured to return data in this format. Here are suggestions for how you might + * achieve this using Java, PHP and ASP.net: * - *The remote server side needs to be configured to return data in this format. Here are suggestions for how you - * might achieve this using Java, PHP and ASP.net:
+ * Java: * - *Java:
+ * boolean jsonP = false; + * String cb = request.getParameter("callback"); + * if (cb != null) { + * jsonP = true; + * response.setContentType("text/javascript"); + * } else { + * response.setContentType("application/x-json"); + * } + * Writer out = response.getWriter(); + * if (jsonP) { + * out.write(cb + "("); + * } + * out.print(dataBlock.toJsonString()); + * if (jsonP) { + * out.write(");"); + * } * -
-boolean jsonP = false;
-String cb = request.getParameter("callback");
-if (cb != null) {
- jsonP = true;
- response.setContentType("text/javascript");
-} else {
- response.setContentType("application/x-json");
-}
-Writer out = response.getWriter();
-if (jsonP) {
- out.write(cb + "(");
-}
-out.print(dataBlock.toJsonString());
-if (jsonP) {
- out.write(");");
-}
-
+ * PHP:
*
- * PHP:
+ * $callback = $_REQUEST['callback']; * -
-$callback = $_REQUEST['callback'];
-
-// Create the output object.
-$output = array('a' => 'Apple', 'b' => 'Banana');
-
-//start output
-if ($callback) {
- header('Content-Type: text/javascript');
- echo $callback . '(' . json_encode($output) . ');';
-} else {
- header('Content-Type: application/x-json');
- echo json_encode($output);
-}
-
+ * // Create the output object.
+ * $output = array('a' => 'Apple', 'b' => 'Banana');
*
- * ASP.net:
+ * //start output + * if ($callback) { + * header('Content-Type: text/javascript'); + * echo $callback . '(' . json_encode($output) . ');'; + * } else { + * header('Content-Type: application/x-json'); + * echo json_encode($output); + * } * -
-String jsonString = "{success: true}";
-String cb = Request.Params.Get("callback");
-String responseString = "";
-if (!String.IsNullOrEmpty(cb)) {
- responseString = cb + "(" + jsonString + ")";
-} else {
- responseString = jsonString;
-}
-Response.Write(responseString);
-
+ * ASP.net:
*
+ * String jsonString = "{success: true}";
+ * String cb = Request.Params.Get("callback");
+ * String responseString = "";
+ * if (!String.IsNullOrEmpty(cb)) {
+ * responseString = cb + "(" + jsonString + ")";
+ * } else {
+ * responseString = jsonString;
+ * }
+ * Response.Write(responseString);
*/
Ext.define('Ext.data.proxy.JsonP', {
extend: 'Ext.data.proxy.Server',
@@ -172,26 +148,28 @@ Ext.define('Ext.data.proxy.JsonP', {
defaultWriterType: 'base',
/**
- * @cfg {String} callbackKey (Optional) See {@link Ext.data.JsonP#callbackKey}.
+ * @cfg {String} callbackKey
+ * See {@link Ext.data.JsonP#callbackKey}.
*/
callbackKey : 'callback',
/**
* @cfg {String} recordParam
- * The param name to use when passing records to the server (e.g. 'records=someEncodedRecordString').
- * Defaults to 'records'
+ * The param name to use when passing records to the server (e.g. 'records=someEncodedRecordString'). Defaults to
+ * 'records'
*/
recordParam: 'records',
/**
- * @cfg {Boolean} autoAppendParams True to automatically append the request's params to the generated url. Defaults to true
+ * @cfg {Boolean} autoAppendParams
+ * True to automatically append the request's params to the generated url. Defaults to true
*/
autoAppendParams: true,
constructor: function(){
this.addEvents(
/**
- * @event exception
+ * @event
* Fires when the server returns an exception
* @param {Ext.data.proxy.Proxy} this
* @param {Ext.data.Request} request The request that was sent
@@ -204,7 +182,7 @@ Ext.define('Ext.data.proxy.JsonP', {
/**
* @private
- * Performs the read request to the remote domain. JsonPProxy does not actually create an Ajax request,
+ * Performs the read request to the remote domain. JsonP proxy does not actually create an Ajax request,
* instead we write out a