Ember Data Model Fragments 使用手册

Ember Data Model Fragments 使用手册

ember-data-model-fragments Ember Data addon to support nested JSON documents 项目地址: https://gitcode.com/gh_mirrors/em/ember-data-model-fragments

欢迎来到 Ember Data Model Fragments 的快速入门指南。这个开源项目是一个 Ember Data 的插件，它支持处理嵌套JSON文档中的子模型，类似于belongsTo和hasMany关系，但其持久化完全通过父对象管理。

1. 项目目录结构及介绍

ember-data-model-fragments/
├── addon/                # 插件的主要代码库，包含自定义逻辑
│   ├── ...
├── app/                 # 示例或默认的App相关代码，可能包括示例模型或组件
│   ├── ...
├── blueprints/          # CLI生成器模板，用于`ember generate`命令
│   └── fragment.js
├── config/              # 配置文件夹，可能包含构建或测试环境设置
│   └── ...
├── tests/               # 单元测试和集成测试存放处
│   ├── ...
├── package.json         # 项目依赖和npm脚本定义
├── README.md            # 项目说明文档
└── LICENSE.md           # 许可证文件

• addon: 包含所有自定义的属性转换和模型片段逻辑。
• app: 提供了基础的应用结构示范，虽然在实际安装到应用时不会直接使用此部分。
• blueprints: 定义如何通过CLI命令生成新的碎片模型。
• config: 包含构建配置等，可能对调整项目行为重要。
• tests: 确保插件功能正确的测试集合。
• package.json: 管理项目的依赖项和脚本命令。
• README.md: 关键信息，如安装方法，快速使用教程等。
• LICENSE.md: 描述软件使用的许可证。

2. 项目的启动文件介绍

对于开发者来说，无需直接操作启动文件，因为这是一个 Ember 添加-on（Addon）。它的“启动”更多是指通过 Ember CLI 工具集成到你的项目中。不过，如果你想要深入了解插件工作原理或者扩展它，可以查看 addon/index.js 文件，这是插件主要入口点，指示哪些部分应被引入到应用环境中。

安装并集成到你的 Ember 应用中的第一步是在终端运行：

$ ember install ember-data-model-fragments

之后，无需单独“启动”，Ember CLI会自动处理加载和集成过程。

3. 项目的配置文件介绍

配置主要是通过 Ember 应用自己的 environment.js 文件进行。在引入 Ember Data Model Fragments 后，如果需要调整插件的行为，通常做法是利用 Ember 应用的配置选项或环境变量。然而，这个特定插件没有公开大量的配置选项。大多数情况下，遵循标准的 Ember 数据模型约定即可。

例如，若要根据不同的环境调整某些行为，你可能会在 config/environment.js 中这样做（尽管针对该插件的具体配置实例较少）:

if (environment === 'development') {
  // 特定于开发环境的插件配置
}

对于更细致的控制，比如定制序列化规则，你将在模型或对应的序列化器中完成，而非直接修改此插件的配置文件。

综上所述，Ember Data Model Fragments 强调的是通过模型片段的定义来简化复杂JSON数据结构的管理和序列化，而不是复杂的配置步骤。理解其工作模式和模型定义方式是使用的关键所在。

ember-data-model-fragments Ember Data addon to support nested JSON documents 项目地址: https://gitcode.com/gh_mirrors/em/ember-data-model-fragments