123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201 |
- <!DOCTYPE html>
- <html>
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
- <title>The source code</title>
- <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
- <script type="text/javascript" src="../resources/prettify/prettify.js"></script>
- <style type="text/css">
- .highlight { display: block; background-color: #ddd; }
- </style>
- <script type="text/javascript">
- function highlight() {
- document.getElementById(location.hash.replace(/#/, "")).className = "highlight";
- }
- </script>
- </head>
- <body onload="prettyPrint(); highlight();">
- <pre class="prettyprint lang-js"><span id='Ext-data-proxy-Direct'>/**
- </span> * This class is used to send requests to the server using {@link Ext.direct.Manager Ext.Direct}. When a
- * request is made, the transport mechanism is handed off to the appropriate
- * {@link Ext.direct.RemotingProvider Provider} to complete the call.
- *
- * # Specifying the function
- *
- * This proxy expects a Direct remoting method to be passed in order to be able to complete requests.
- * This can be done by specifying the {@link #directFn} configuration. This will use the same direct
- * method for all requests. Alternatively, you can provide an {@link #api} configuration. This
- * allows you to specify a different remoting method for each CRUD action.
- *
- * # Parameters
- *
- * This proxy provides options to help configure which parameters will be sent to the server.
- * By specifying the {@link #paramsAsHash} option, it will send an object literal containing each
- * of the passed parameters. The {@link #paramOrder} option can be used to specify the order in which
- * the remoting method parameters are passed.
- *
- * # Example Usage
- *
- * Ext.define('User', {
- * extend: 'Ext.data.Model',
- * fields: ['firstName', 'lastName'],
- * proxy: {
- * type: 'direct',
- * directFn: MyApp.getUsers,
- * paramOrder: 'id' // Tells the proxy to pass the id as the first parameter to the remoting method.
- * }
- * });
- * User.load(1);
- */
- Ext.define('Ext.data.proxy.Direct', {
- /* Begin Definitions */
- extend: 'Ext.data.proxy.Server',
- alternateClassName: 'Ext.data.DirectProxy',
- alias: 'proxy.direct',
- requires: ['Ext.direct.Manager'],
- /* End Definitions */
- <span id='Ext-data-proxy-Direct-cfg-paramOrder'> /**
- </span> * @cfg {String/String[]} paramOrder
- * Defaults to undefined. A list of params to be executed server side. Specify the params in the order in
- * which they must be executed on the server-side as either (1) an Array of String values, or (2) a String
- * of params delimited by either whitespace, comma, or pipe. For example, any of the following would be
- * acceptable:
- *
- * paramOrder: ['param1','param2','param3']
- * paramOrder: 'param1 param2 param3'
- * paramOrder: 'param1,param2,param3'
- * paramOrder: 'param1|param2|param'
- */
- paramOrder: undefined,
- <span id='Ext-data-proxy-Direct-cfg-paramsAsHash'> /**
- </span> * @cfg {Boolean} paramsAsHash
- * Send parameters as a collection of named arguments.
- * Providing a {@link #paramOrder} nullifies this configuration.
- */
- paramsAsHash: true,
- <span id='Ext-data-proxy-Direct-cfg-directFn'> /**
- </span> * @cfg {Function/String} directFn
- * Function to call when executing a request. directFn is a simple alternative to defining the api configuration-parameter
- * for Store's which will not implement a full CRUD api. The directFn may also be a string reference to the fully qualified
- * name of the function, for example: 'MyApp.company.GetProfile'. This can be useful when using dynamic loading. The string
- * will be looked up when the proxy is created.
- */
- directFn : undefined,
- <span id='Ext-data-proxy-Direct-cfg-api'> /**
- </span> * @cfg {Object} api
- * The same as {@link Ext.data.proxy.Server#api}, however instead of providing urls, you should provide a direct
- * function call. See {@link #directFn}.
- */
- <span id='Ext-data-proxy-Direct-cfg-extraParams'> /**
- </span> * @cfg {Object} extraParams
- * Extra parameters that will be included on every read request. Individual requests with params
- * of the same name will override these params when they are in conflict.
- */
- // private
- paramOrderRe: /[\s,|]/,
- constructor: function(config){
- var me = this,
- paramOrder,
- fn,
- api;
-
- me.callParent(arguments);
-
- paramOrder = me.paramOrder;
- if (Ext.isString(paramOrder)) {
- me.paramOrder = paramOrder.split(me.paramOrderRe);
- }
-
- fn = me.directFn;
- if (fn) {
- me.directFn = Ext.direct.Manager.parseMethod(fn);
- }
-
- api = me.api;
- for (fn in api) {
- if (api.hasOwnProperty(fn)) {
- api[fn] = Ext.direct.Manager.parseMethod(api[fn]);
- }
- }
- },
- doRequest: function(operation, callback, scope) {
- var me = this,
- writer = me.getWriter(),
- request = me.buildRequest(operation, callback, scope),
- fn = me.api[request.action] || me.directFn,
- params = request.params,
- args = [],
- method;
- //<debug>
- if (!fn) {
- Ext.Error.raise('No direct function specified for this proxy');
- }
- //</debug>
- if (operation.allowWrite()) {
- request = writer.write(request);
- }
- if (operation.action == 'read') {
- // We need to pass params
- method = fn.directCfg.method;
- args = method.getArgs(params, me.paramOrder, me.paramsAsHash);
- } else {
- args.push(request.jsonData);
- }
- Ext.apply(request, {
- args: args,
- directFn: fn
- });
- args.push(me.createRequestCallback(request, operation, callback, scope), me);
- fn.apply(window, args);
- },
- /*
- * Inherit docs. We don't apply any encoding here because
- * all of the direct requests go out as jsonData
- */
- applyEncoding: function(value){
- return value;
- },
- createRequestCallback: function(request, operation, callback, scope){
- var me = this;
- return function(data, event){
- me.processResponse(event.status, operation, request, event, callback, scope);
- };
- },
- // inherit docs
- extractResponseData: function(response){
- return Ext.isDefined(response.result) ? response.result : response.data;
- },
- // inherit docs
- setException: function(operation, response) {
- operation.setException(response.message);
- },
- // inherit docs
- buildUrl: function(){
- return '';
- }
- });
- </pre>
- </body>
- </html>
|