掌握 Ext JS:通过代理发送 AJAX 请求与实现自定义数据读取器

掌握 Ext JS:通过代理发送 AJAX 请求与实现自定义数据读取器

本文深入探讨 Ext JS 框架中通过 AJAX 代理发送数据请求、实现自定义数据读取器以及管理表单数据加载的核心技术。我们将详细解析 Ext.form.Panel 与 Ext.data.Store 之间的交互差异,并通过示例代码演示如何手动加载数据、配置 AJAX 代理,并利用自定义读取器处理服务器响应,确保数据能够被正确解析和利用。

在 ext js 应用开发中,数据管理是核心环节之一。ext.data.store 结合 ext.data.proxy.ajax 和自定义数据读取器是实现与后端服务高效交互的强大组合。然而,初学者常会在组件与数据存储的绑定、请求的触发以及响应的处理上遇到困惑。本教程将围绕这些关键点展开,提供一套清晰的实践指南。

理解 Ext JS 中的数据流:Store、Proxy 与 Reader

在 Ext JS 中,数据通常通过以下组件链进行管理和传输:

Store (数据存储): 负责在客户端管理数据集合。它不直接与服务器通信,而是通过代理来完成。Proxy (代理): 定义了 Store 如何与远程数据源进行通信,例如通过 AJAX 请求。它封装了请求的 URL、方法、参数等细节。Reader (读取器): 负责解析从服务器接收到的原始数据,并将其转换为 Ext JS Store 可以理解和使用的模型实例。

Ext.form.Panel 与 Ext.data.Store 的区别

一个常见的误区是将 Ext.form.Panel 与 Ext.grid.Panel 等同看待,认为它们都能通过 store 配置直接绑定一个数据存储。实际上,Ext.form.Panel 并没有名为 store 的配置项。Ext.form.Panel 通常用于显示和编辑单个数据记录,而不是一个数据集合。因此,如果您希望为表单加载数据,需要手动创建并加载 Ext.data.Store,然后将加载到的数据记录填充到表单字段中。

例如,以下代码片段在 Ext.form.Panel 中配置 store 是无效的:

Ext.define("ModernApp.view.form.FormView", {  extend: "Ext.form.Panel",  xtype: "formview",  // ... 其他配置  store: { type: "formviewstore" }, // 此配置对 Ext.form.Panel 无效  // ...});

正确的做法是手动创建并加载 Store,然后将数据绑定到表单。

通过代理发送 AJAX 请求并手动加载数据

要通过代理发送 AJAX 请求,首先需要定义一个 Ext.data.Store,并为其配置一个 Ext.data.proxy.Ajax。

1. 定义数据存储 (Store)

创建一个 FormViewStore,指定其代理类型为 ajax,并设置请求的 URL。同时,这里也指定了一个自定义的读取器 myreader。

// ModernApp/view/form/FormViewStore.jsExt.define("ModerdApp.view.form.FormViewStore", {  extend: "Ext.data.Store",  alias: "store.formviewstore", // 使用 store. 前缀作为 alias  proxy: {    type: "ajax",    url: "https://jsonplaceholder.typicode.com/posts", // 示例 API    reader: {      type: "myreader", // 指定自定义读取器    },  },  // 可以选择定义模型,如果数据结构已知  // model: 'ModernApp.model.MyDataModel'});

2. 手动创建和加载 Store

由于 Ext.form.Panel 不会自动加载 Store,您需要在适当的时机(例如,在组件渲染后或按钮点击时)手动创建 Store 并调用其 load() 方法。

以下示例演示了在一个按钮的 handler 中如何创建并加载 FormViewStore:

// ModernApp/view/form/FormView.jsExt.define("ModernApp.view.form.FormView", {  extend: "Ext.form.Panel",  xtype: "formview",  title: "Custom Form",  controller: "formviewcontroller",  // ... 其他配置  buttons: [    {      text: "发送请求并加载数据",      handler: function () {        // 创建 Store 实例        const store = Ext.create("store.formviewstore"); // 使用 alias 创建        // 加载 Store,这将触发 AJAX 请求        store.load({          callback: function (records, operation, success) {            if (success) {              console.log("数据加载成功:", records);              // 如果是表单,通常只加载一条记录              if (records.length > 0) {                this.up("formview").setValues(records[0].getData()); // 将第一条记录的数据填充到表单              }            } else {              console.error("数据加载失败:", operation.getError());            }          },          scope: this, // 确保回调函数中的 this 指向当前组件        });      },    },    {      text: "取消",      handler: "onCancel",    },  ],  // ... 其他 items 和 listeners});

当上述按钮被点击时,store.load() 会触发一个 AJAX 请求到 https://jsonplaceholder.typicode.com/posts,并通过 myreader 来处理响应。

实现自定义数据读取器 (Custom Reader)

自定义数据读取器允许您灵活地处理服务器返回的任何格式的数据。通过扩展 Ext.data.reader.Json 或其他读取器,您可以重写 getResponseData 方法来解析原始响应。

1. 定义自定义读取器

创建一个名为 Json 的自定义读取器,并为其指定别名 myreader。

// ModernApp/view/form/reader/Json.jsExt.define("ModernApp.view.form.reader.Json", {  extend: "Ext.data.reader.Json",  alias: "reader.myreader", // 使用 reader. 前缀作为 alias  /**   * 重写 getResponseData 方法来处理服务器响应。   * 这个方法接收原始的响应对象,并需要返回一个包含 'success' 状态和 'data' (或 'results') 的对象。   * @param {Object} response 原始的服务器响应对象   * @returns {Object} 格式化后的数据对象   */  getResponseData: function (response) {    console.log("原始响应对象:", response);    let decodedJson;    try {      // 尝试解析响应文本      // 注意:response.request.result.responseText 可能不存在,      // 更可靠的是直接使用 response.responseText 或 response.responseJson      decodedJson = Ext.JSON.decode(        response.responseText || response.request.result.responseText,        true      ); // true 表示如果解析失败返回 null    } catch (e) {      console.error("解析 JSON 响应失败:", e);      return {        success: false,        message: "JSON 解析错误",        errors: e.message,      };    }    // 根据 HTTP 状态码判断请求是否成功    if (response.status >= 200 && response.status < 300) {      // 假设服务器返回的数据直接是数组或符合 Ext JS Store 的格式      // 如果服务器返回的是一个数组,可以直接作为 results 返回      // 如果服务器返回的是 { data: [...] },则需要提取 data 字段      return {        success: true,        data: decodedJson, // 将解析后的数据作为 'data' 字段返回      };    } else {      // 请求失败,返回错误信息      return {        success: false,        message: "服务器请求失败",        errors: decodedJson || response.statusText,      };    }  },});

2. getResponseData 方法详解

getResponseData 方法是自定义读取器的核心。它接收一个 response 对象作为参数,该对象包含了 AJAX 请求的详细信息,例如:

response.responseText: 服务器返回的原始文本数据。response.responseJson: 如果服务器返回的是 JSON 且 Ext JS 已自动解析,则为解析后的 JSON 对象。response.status: HTTP 状态码(如 200, 404, 500)。response.statusText: HTTP 状态文本。response.request: 原始的请求对象。

您的任务是在这个方法中:

从 response 对象中提取原始数据。解析数据(例如,使用 Ext.JSON.decode 解析 JSON 字符串)。将解析后的数据封装成一个对象,该对象必须包含 success 属性(布尔值)和 data 或 results 属性(包含实际数据记录)。如果请求失败,可以包含 errors 属性。

示例代码中的 getResponseData 逻辑说明:

它首先尝试使用 Ext.JSON.decode 解析 response.responseText。然后,根据 response.status 判断请求是否成功。如果成功,它返回一个 { success: true, data: decodedJson } 的结构。如果失败,它返回一个 { success: false, message: “…”, errors: … } 的结构。

这种结构是 Ext JS Store 读取器所期望的,它允许 Store 正确地处理数据和错误。

数据在组件间共享的考量

原始问题中提到了如何在 FormViewStore 中获取数据后,在 NavView 组件中使用。这通常涉及到两种情况:

直接访问 Store 实例: 如果 NavView 和 FormView 都属于同一个父组件,或者 FormViewStore 是一个全局 Store,NavView 可以通过 Ext.getStore(‘myGlobalStoreId’) 或 this.up(‘parentComponent’).getViewModel().getStore(‘myStore’) 来获取 Store 实例,然后访问其数据。通过 ViewModel 共享数据: Ext JS 的 ViewModel 是在组件层级之间共享数据的推荐方式。您可以在父组件的 ViewModel 中定义一个 Store,然后子组件可以通过 bind 配置来访问和使用这个 Store。

对于 Ext.form.Panel,通常是加载一条记录到表单中,而不是整个 Store。如果您需要在 NavView 中显示这条记录的某个字段,可以在 FormView 加载数据后,将该记录的特定数据传递给 NavView,或者将该记录本身设置为 NavView 的 ViewModel 的一部分。

总结与最佳实践

Ext.form.Panel 不直接支持 store 配置。 需要手动创建和加载 Ext.data.Store。手动加载 Store: 使用 Ext.create(‘store.yourStoreAlias’).load() 来触发 AJAX 请求。自定义读取器 (getResponseData): 是处理服务器原始响应的关键。确保返回一个包含 success 和 data (或 results) 属性的对象。错误处理: 在 getResponseData 中加入 try-catch 块来处理 JSON 解析错误,并在 store.load() 的 callback 中处理请求失败的情况。调试: 利用浏览器的开发者工具(网络标签页)检查 AJAX 请求和响应,使用 console.log 在 getResponseData 中输出原始响应对象,有助于理解数据结构和调试问题。

通过掌握这些技术,您将能够更有效地在 Ext JS 应用中管理数据流,实现与后端服务的无缝集成。

以上就是掌握 Ext JS:通过代理发送 AJAX 请求与实现自定义数据读取器的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1526825.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月20日 18:52:43
下一篇 2025年12月20日 18:52:57

相关推荐

发表回复

登录后才能评论
关注微信