Meteor-Collection2 使用教程

1. 项目介绍

Meteor-Collection2 是一个 Meteor 包，它扩展了 Mongo 集合，允许你为集合附加一个模式（schema）。通过这个模式，Meteor-Collection2 能够在插入和更新数据时自动验证数据，确保数据符合预定义的结构。这个包依赖于 simpl-schema NPM 包，后者定义了模式语法并提供了验证逻辑。

2. 项目快速启动

安装

在你的 Meteor 应用目录中，输入以下命令来安装 meteor-collection2：

meteor add aldeed:collection2
meteor npm install --save simpl-schema@1.12.3

导入

你可以选择静态导入或动态导入 meteor-collection2：

静态导入

import 'meteor/aldeed:collection2/static';

动态导入

import 'meteor/aldeed:collection2/dynamic';
Collection2.load();

定义和附加模式

假设我们有一个名为 Books 的集合，我们可以为其定义一个模式并附加到集合上：

const Books = new Mongo.Collection('books');

const Schemas = {};
Schemas.Book = new SimpleSchema({
  title: {
    type: String,
    label: 'Title',
    max: 200
  },
  author: {
    type: String,
    label: 'Author'
  },
  copies: {
    type: SimpleSchema.Integer,
    label: 'Number of copies',
    min: 0
  },
  lastCheckedOut: {
    type: Date,
    label: 'Last date this book was checked out',
    optional: true
  },
  summary: {
    type: String,
    label: 'Brief summary',
    optional: true,
    max: 1000
  }
});

Books.attachSchema(Schemas.Book);

插入和更新数据

现在，我们可以进行验证插入和更新操作：

Books.insert({
  title: 'Ulysses',
  author: 'James Joyce'
}, (error, result) => {
  if (error) {
    console.log(error.invalidKeys);
  }
});

Books.update(book._id, {
  $unset: { copies: 1 }
}, (error, result) => {
  if (error) {
    console.log(error.invalidKeys);
  }
});

3. 应用案例和最佳实践

应用案例

Meteor-Collection2 适用于需要严格数据验证的场景，例如：

• 电子商务平台：确保产品信息符合预定义的结构，避免无效数据。
• 社交网络：验证用户提交的个人信息，确保数据完整性和一致性。
• 内容管理系统：确保文章和评论数据符合预定义的格式。

最佳实践

• 使用模式验证：在插入和更新数据时，始终使用模式验证，确保数据的完整性和一致性。
• 动态模式：根据不同的文档类型，使用不同的模式进行验证。
• 错误处理：在插入和更新操作中，处理验证错误，并向用户提供友好的错误提示。

4. 典型生态项目

aldeed:autoform

aldeed:autoform 是一个 Meteor 包，它可以根据集合的模式自动生成 HTML5 表单。AutoForm 提供了自动数据库操作、方法调用、验证和用户界面响应性，减少了手动编写表单和事件处理的复杂性。

simpl-schema

simpl-schema 是一个 NPM 包，它定义了模式语法并提供了验证逻辑。Meteor-Collection2 依赖于 simpl-schema 来实现数据验证。

meteor-roles

meteor-roles 是一个 Meteor 包，用于管理用户角色和权限。结合 Meteor-Collection2，可以确保只有具有特定角色的用户才能插入或更新某些数据。

通过这些生态项目，Meteor-Collection2 可以与其他 Meteor 包无缝集成，提供更强大的功能和更好的开发体验。