首页
指南
API
开发
贡献
首页
指南
API
开发
贡献

Collection

Collection 数据表类，其被 CollectionManager 管理。

1. 类型

interface CollectionOptions {
  name: string;
  title?: string;
  fields?: FieldOptions[];
  // ....
}

class Collection {
  app: Application;
  collectionManager: CollectionManager;

  constructor(options: CollectionOptions) {}

  name: string;
  primaryKey: string;
  titleField: string;

  getOptions(): CollectionOptions;
  setOptions(options: CollectionOptions): void;
  getOption<K extends keyof CollectionOptions>(key: K): CollectionOptions[K];

  getFields(predicate?: CollectionFieldOptions | ((collection: CollectionFieldOptions) => boolean) | keyof CollectionFieldOptions): any[]
  getField(name: SchemaKey): CollectionFieldOptions
  hasField(name: SchemaKey): boolean;
}
const usersCollection = new Collection({
  name: 'users',
  title: 'Users',
  fields: [
    {
      type: 'string',
      name: 'username',
    },
    {
      type: 'integer',
      name: 'age',
    },
  ],
});

2. CollectionOptions

export interface CollectionOptions {
  name: string;
  title?: string;
  dataSource?: string;
  duplicator?:
    | dumpable
    | {
        dumpable: dumpable;
        with?: string[] | string;
        delayRestore?: any;
      };

  tableName?: string;
  inherits?: string[] | string;
  inherit?: string;
  key?: string;
  viewName?: string;
  writableView?: boolean;

  filterTargetKey?: string;
  fields?: CollectionFieldOptions[];
  model?: any;
  repository?: any;
  sortable?: CollectionSortable;
  /**
   * @default true
   */
  autoGenId?: boolean;
  /**
   * @default 'options'
   */
  magicAttribute?: string;

  tree?: string;

  template?: string;

  isThrough?: boolean;
  autoCreate?: boolean;
  resource?: string;
  collectionName?: string;
  sourceKey?: string;
  uiSchema?: any;
  [key: string]: any;
}

  • name: Collection 的标识，必须唯一。

  • title: Collection 的标题，用于显示。

  • fields: 字段列表，详细说明请查看 CollectionField

  • template: 模板标识，用于标识该 Collection 是由哪个模板创建的，详细说明请查看 CollectionTemplate

  • dataSource: 数据源标识，用于标识该 Collection 是由哪个数据源创建的，详细说明请查看 DataSource

  • duplicator

  • tableName

  • inherits

  • viewName

  • writableView

  • filterTargetKey

  • model

  • repository

3. 实例属性

collection.collectionManager

CollectionManager 的实例。

collection.titleFieldName

标题字段的 name 属性。

其他属性

其他属性同 CollectionOptions。

4. 实例方法

collection.getOptions()

获取 collection 的所有配置项。

  • 类型
class Collection {
  getOptions(): CollectionOptions;
}
  • 示例
const usersCollection = new Collection({
  name: 'users',
  title: 'Users',
  fields: [
    // ...
  ],
});

console.log(usersCollection.getOptions()); // { name: 'users', title: 'Users', fields: [ ] }

collection.setOptions(options)

设置 collection 的配置项，最终会和默认配置项进行合并。

  • 类型
class Collection {
  setOptions(options: CollectionOptions): void;
}
  • 示例
collection.setOptions({
  name: 'users',
  title: 'Users',
  fields: [
    // ...
  ],
});

collection.getOption(key)

获取 collection 的单个配置项。

  • 类型
class Collection {
  getOption<K extends keyof CollectionOptions>(key: K): CollectionOptions[K];
}
  • 示例
collection.getOption('name'); // 'users'
collection.getOption('title'); // 'Users'

collection.getFields(predicate?)

获取 collection 的字段列表。

  • 类型
class Collection {
  getFields(predicate?: CollectionFieldOptions | ((collection: CollectionFieldOptions) => boolean) | keyof CollectionFieldOptions): any[]
}
  • 详解
    • predicate
      • 类型
        • CollectionFieldOptions
        • (collection: CollectionFieldOptions) => boolean
        • keyof CollectionFieldOptions
      • 说明
        • 如果传递了 predicate，则返回符合条件的字段列表
        • 如果没有传递 predicate，则返回所有字段列表

predicate 的使用可看参考 lodash.filter。

  • 示例
collection.getFields(); // [{ name: 'username', type: 'string', primaryKey: true }, { name: 'age', type: 'integer' }]

collection.getFields({ name: 'age' }); // [{ name: 'age', type: 'integer' }]

collection.getFields('primaryKey'); // [{ name: 'username', type: 'string', primaryKey: true }]

collection.getFields(field => field.type === 'string'); // [{ name: 'name', type: 'string' }]

collection.getField(name)

获取 collection 的单个字段。

  • 类型
class Collection {
  getField(name: SchemaKey): CollectionFieldOptions
}
  • 示例
collection.getField('username'); // { name: 'username', type: 'string', primaryKey: true }

collection.hasField(name)

判断 collection 是否存在某个字段。

  • 类型
class Collection {
  hasField(name: SchemaKey): boolean;
}
  • 示例
collection.hasField('username'); // true
collection.hasField('name'); // false