sync
[roojs1] / docs / symbols / Roo.data.HttpProxy.json
1 {
2   "name" : "Roo.data.HttpProxy",
3   "augments" : [
4     "Roo.data.DataProxy"
5   ],
6   "desc" : "An implementation of {@link Roo.data.DataProxy} that reads a data object from an {@link Roo.data.Connection} object\nconfigured to reference a certain URL.<br><br>\n<p>\n<em>Note that this class cannot be used to retrieve data from a domain other than the domain\nfrom which the running page was served.<br><br>\n<p>\nFor cross-domain access to remote data, use an {@link Roo.data.ScriptTagProxy}.</em><br><br>\n<p>\nBe aware that to enable the browser to parse an XML document, the server must set\nthe Content-Type header in the HTTP response to \"text/xml\".",
7   "isSingleton" : false,
8   "isStatic" : false,
9   "isBuiltin" : false,
10   "memberOf" : "HttpProxy",
11   "example" : "",
12   "deprecated" : "",
13   "since" : "",
14   "see" : "",
15   "params" : [
16     {
17       "name" : "conn",
18       "type" : "Object",
19       "desc" : "Connection config options to add to each request (e.g. {url: 'foo.php'} or\nan {@link Roo.data.Connection} object.  If a Connection config is passed, the singleton {@link Roo.Ajax} object\nwill be used to make the request.",
20       "isOptional" : false
21     }
22   ],
23   "returns" : [],
24   "throws" : "",
25   "requires" : "",
26   "config" : [
27     {
28       "name" : "method",
29       "type" : "String",
30       "desc" : "(Optional) The default HTTP method to be used for requests. (defaults to undefined; if not set but parms are present will use POST, otherwise GET)",
31       "memberOf" : ""
32     },
33     {
34       "name" : "timeout",
35       "type" : "Number",
36       "desc" : "(Optional) The timeout in milliseconds to be used for requests. (defaults to 30000)",
37       "memberOf" : ""
38     },
39     {
40       "name" : "autoAbort",
41       "type" : "Boolean",
42       "desc" : "(Optional) Whether this request should abort any pending requests. (defaults to false)",
43       "memberOf" : ""
44     },
45     {
46       "name" : "url",
47       "type" : "String",
48       "desc" : "(Optional) The default URL to be used for requests to the server. (defaults to undefined)",
49       "memberOf" : ""
50     },
51     {
52       "name" : "extraParams",
53       "type" : "Object",
54       "desc" : "(Optional) An object containing properties which are used as\nextra parameters to each request made by this object. (defaults to undefined)",
55       "memberOf" : ""
56     },
57     {
58       "name" : "disableCaching",
59       "type" : "Boolean",
60       "desc" : "(Optional) True to add a unique cache-buster param to GET requests. (defaults to true)",
61       "memberOf" : ""
62     },
63     {
64       "name" : "defaultHeaders",
65       "type" : "Object",
66       "desc" : "(Optional) An object containing request headers which are added\n to each request made by this object. (defaults to undefined)",
67       "memberOf" : ""
68     }
69   ],
70   "methods" : [
71     {
72       "name" : "getConnection",
73       "type" : "function",
74       "desc" : "Return the {@link Roo.data.Connection} object being used by this Proxy.",
75       "sig" : "()\n{\n\n}",
76       "static" : false,
77       "memberOf" : "",
78       "isStatic" : false,
79       "isConstructor" : false,
80       "isPrivate" : false,
81       "example" : "",
82       "deprecated" : "",
83       "since" : "",
84       "see" : "",
85       "exceptions" : "",
86       "requires" : "",
87       "params" : [],
88       "returns" : [
89         {
90           "name" : "",
91           "type" : "Connection",
92           "desc" : "The Connection object. This object may be used to subscribe to events on\na finer-grained basis than the DataProxy events."
93         }
94       ]
95     },
96     {
97       "name" : "load",
98       "type" : "function",
99       "desc" : "Load data from the configured {@link Roo.data.Connection}, read the data object into\na block of Roo.data.Records using the passed {@link Roo.data.DataReader} implementation, and\nprocess that block using the passed callback.",
100       "sig" : "(params, reader, callback, scope, arg)",
101       "static" : false,
102       "memberOf" : "",
103       "isStatic" : false,
104       "isConstructor" : false,
105       "isPrivate" : false,
106       "example" : "",
107       "deprecated" : "",
108       "since" : "",
109       "see" : "",
110       "exceptions" : "",
111       "requires" : "",
112       "params" : [
113         {
114           "name" : "params",
115           "type" : "Object",
116           "desc" : "An object containing properties which are to be used as HTTP parameters\nfor the request to the remote server.",
117           "isOptional" : false
118         },
119         {
120           "name" : "reader",
121           "type" : "Roo.data.DataReader",
122           "desc" : "The Reader object which converts the data\nobject into a block of Roo.data.Records.",
123           "isOptional" : false
124         },
125         {
126           "name" : "callback",
127           "type" : "Function",
128           "desc" : "The function into which to pass the block of Roo.data.Records.\nThe function must be passed <ul>\n<li>The Record block object</li>\n<li>The \"arg\" argument from the load function</li>\n<li>A boolean success indicator</li>\n</ul>",
129           "isOptional" : false
130         },
131         {
132           "name" : "scope",
133           "type" : "Object",
134           "desc" : "The scope in which to call the callback",
135           "isOptional" : false
136         },
137         {
138           "name" : "arg",
139           "type" : "Object",
140           "desc" : "An optional argument which is passed to the callback as its second parameter.",
141           "isOptional" : false
142         }
143       ],
144       "returns" : []
145     }
146   ],
147   "events" : [
148     {
149       "name" : "load",
150       "type" : "function",
151       "desc" : "Fires before the load method's callback is called.",
152       "sig" : "function (This, o, arg)\n{\n\n}",
153       "memberOf" : "Roo.data.DataProxy",
154       "example" : "",
155       "deprecated" : "",
156       "since" : "",
157       "see" : "",
158       "params" : [
159         {
160           "name" : "This",
161           "type" : "Object",
162           "desc" : "DataProxy object.",
163           "isOptional" : false
164         },
165         {
166           "name" : "o",
167           "type" : "Object",
168           "desc" : "The data object.",
169           "isOptional" : false
170         },
171         {
172           "name" : "arg",
173           "type" : "Object",
174           "desc" : "The callback argument object passed to the load function.",
175           "isOptional" : false
176         }
177       ],
178       "returns" : []
179     },
180     {
181       "name" : "beforeload",
182       "type" : "function",
183       "desc" : "Fires before a network request is made to retrieve a data object.",
184       "sig" : "function (This, params)\n{\n\n}",
185       "memberOf" : "Roo.data.DataProxy",
186       "example" : "",
187       "deprecated" : "",
188       "since" : "",
189       "see" : "",
190       "params" : [
191         {
192           "name" : "This",
193           "type" : "Object",
194           "desc" : "DataProxy object.",
195           "isOptional" : false
196         },
197         {
198           "name" : "params",
199           "type" : "Object",
200           "desc" : "The params parameter to the load function.",
201           "isOptional" : false
202         }
203       ],
204       "returns" : []
205     },
206     {
207       "name" : "loadexception",
208       "type" : "function",
209       "desc" : "Fires if an Exception occurs during data retrieval.",
210       "sig" : "function (This, o, arg, e)\n{\n\n}",
211       "memberOf" : "Roo.data.DataProxy",
212       "example" : "",
213       "deprecated" : "",
214       "since" : "",
215       "see" : "",
216       "params" : [
217         {
218           "name" : "This",
219           "type" : "Object",
220           "desc" : "DataProxy object.",
221           "isOptional" : false
222         },
223         {
224           "name" : "o",
225           "type" : "Object",
226           "desc" : "The data object.",
227           "isOptional" : false
228         },
229         {
230           "name" : "arg",
231           "type" : "Object",
232           "desc" : "The callback argument object passed to the load function.",
233           "isOptional" : false
234         },
235         {
236           "name" : "e",
237           "type" : "Object",
238           "desc" : "The Exception.",
239           "isOptional" : false
240         }
241       ],
242       "returns" : []
243     }
244   ]
245 }