数据模型的 ES6 类

Posted

技术标签:

【中文标题】数据模型的 ES6 类【英文标题】:ES6 Classes for Data Models 【发布时间】:2016-05-08 17:19:43 【问题描述】:

我正在尝试使用 ES6 类在我正在构建的 API 中构建数据模型(来自 mysql 数据库)。我不喜欢使用 ORM/ODM 库,因为这将是一个非常基本、简单的 API。但是,我很难弄清楚如何定义这些模型。

我的数据实体是(这些只是一些简化的示例):

客户

数据模型

id
name
groupId
status (enum of: active, suspended, closed)

私有方法

_getState(status) 
    var state = (status  == 'active' ? 'good' : 'bad');
    return state;

请求

我希望能够做到:

findById:提供单个customer.id,返回该特定客户的数据,即SELECT * FROM customers WHERE id = ?

findByGroupId:提供 group.id,返回属于该组的所有客户(在对象数组中)的数据,即SELECT * FROM customers WHERE groupId = ?

响应负载

对于每个客户对象,我想像这样返回 JSON:

findById(1);:

[
    "id" : 1,
    "name" : "John Doe",
    "groupId" : 2,
    "status" : "active",
    "state" : "good"
]

findByGroupId(2);:

[
    "id" : 1,
    "name" : "John Doe",
    "groupId" : 2,
    "status" : "active",
    "state" : "good"
,

    "id" : 4,
    "name" : "Pete Smith",
    "groupId" : 2,
    "status" : "suspended",
    "state" : "bad"
]

数据模型

id
title

请求

我希望能够做到:

findById:提供单个 group.id,返回该特定组的数据,即SELECT * FROM groups WHERE id = ?

响应负载

对于每个组对象,我想像这样返回 JSON:

findById(2);:


    "id" : 2,
    "title" : "This is Group 2",
    "customers" : [
        "id" : 1,
        "name" : "John Doe",
        "groupId" : 2,
        "status" : "active",
        "state" : "good"
    ,
    
        "id" : 4,
        "name" : "Pete Smith",
        "groupId" : 2,
        "status" : "suspended",
        "state" : "bad"
    ]


要求:

必须使用 ES6 类 要导出的每个模型都在其自己的文件中(例如 customer.js


问题:

我的主要问题是:

    我应该在哪里定义数据结构,包括需要数据转换的字段,使用私有方法(例如_getState()) 应该在类的范围内定义findByIdfindByGroupId等吗?或者,是否应该通过单独的方法(与类在同一个文件中)来实例化对象? 我应该如何处理一个对象是另一个对象的孩子的情况,例如将属于 Group 对象的 Customer 对象作为 GroupfindById? 中的对象数组返回 应该在哪里定义将连接到数据库的 SQL 查询?在getByIdgetByGroupId 等?

更新!!

这就是我想出的——(如果有人可以评论和评论,那就太棒了):

客户模型

'use strict';

class Cust 
  constructor (custData) 
    this.id = custData.id;
    this.name = custData.name;
    this.groupId = custData.groupId;
    this.status = custData.status;
    this.state = this._getState(custData.status);
  

  _getState(status) 
    let state = (status  == 'active' ? 'good' : 'bad');
    return state;
  


exports.findById = ((id) => 
  return new Promise ((resolve, reject) => 
    let custData = `do the MySQL query here`;
    let cust = new Cust (custData);
    let Group = require(appDir + process.env.PATH_API + process.env.PATH_MODELS + 'group');
    Group.findById(cust.groupId).then(
      (group) => 
        cust.group = group;
        resolve (cust)
      ,
      (err) => 
        resolve (cust);
      
    );
  );
);

集团模型

'use strict';

class Group 
  constructor (groupData) 
    this.id = groupData.id;
    this.title = groupData.title;
  


exports.findById = ((id) => 
  return new Promise ((resolve, reject) => 
    let groupData = `do the MySQL query here`;
    if (id != 2)
      reject('group - no go');
    ;
    let group = new Group (groupData);
    resolve (group);
  );
);

CUSTOMER 控制器(客户模型被实例化的地方)

'use strict';

var Cust = require(appDir + process.env.PATH_API + process.env.PATH_MODELS + 'cust');

class CustController 
  constructor () 
  

  getCust (req, res) 
    Cust.findById(req.params.id).then(
      (cust) => 
        res(cust);
      ,
      (err) => 
        res(err);
      
    )
  


module.exports = CustController;

这似乎运作良好,我已经能够使用 ClassPromiselet 使其更加 ES6 友好。

所以,我想就我的方法获得一些意见。另外,我在这种情况下是否正确使用了exportrequired 功能?

【问题讨论】:

你在用什么?节点.js?什么是架构?客户端服务器?它是远程运行还是在浏览器中运行,还是只是一个从 bash 运行的脚本(如果它甚至在 linux 上)? 这是一个hapi.js API 服务器。这个想法是拥有许多数据实体,每个实体都有自己的路由、模型和控制器。它将主要用于GET 请求。而且,由于它将是一组相当小的实体和端点,我不希望使用完整的 ORM。 看起来不错!我看到一些不太关心的领域。不过,您应该发布您的问题Code Review。这是此类问题的适当论坛。在这里,您可能会被标记 【参考方案1】:

这是另一种方法,

我将在哪里定义数据结构,包括需要数据转换的字段,使用私有方法(例如 _getState())

您应该在扩展***模型的模型类中定义这些字段和关系。示例:

class Group extends Model 
    attributes() 
        return 
            id: 
                type: 'integer',
                primary: true
            ,
            title: 
                type: 'string'
            
        ;
    

    relationships() 
        return 
            'Customer': 
                type: 'hasMany',
                foreignKey: 'groupId'
            
        ;
    

findById、findByGroupId等是否应该在类的范围内定义?或者,是否应该通过单独的方法(与类在同一个文件中)来实例化对象?

在模型示例中使用findByAttribute(attr) 代替许多函数:

static findByAttribute(attr) 
    return new Promise((resolve, reject) => 
        var query = this._convertObjectToQueriesArray(attr);
        query = query.join(" and ");
        let records = `SELECT * from $this.getResourceName() where $query`;
        var result = this.run(records);
        // Note: Only support 'equals' and 'and' operator
        if (!result) 
            reject('Could not found records');
         else 
            var data = [];
            result.forEach(function(record) 
                data.push(new this(record));
            );
            resolve(data);
        
    );


/**
 * Convert Object of key value to sql filters
 * 
 * @param  Object Ex: id:1, name: "John"
 * @return Array of String ['id=1', 'name=John']
 */
static _convertObjectToQueriesArray(attrs) 
    var queryArray = [];
    for (var key in attrs) 
        queryArray.push(key + " = " + attrs[key]);
    
    return queryArray;


/**
 * Returns table name or resource name.
 * 
 * @return String
 */
static getResourceName() 
    if (this.resourceName) return this.resourceName();
    if (this.constructor.name == "Model") 
        throw new Error("Model is not initialized");
    
    return this.constructor.name.toLowerCase();

我应该如何处理一个对象是另一个对象的孩子的情况,例如将属于 Group 对象的 Customer 对象作为 Group 的 findById 中的对象数组返回?

如果是关系,你应该有 findRelations、getRelatedRecords 之类的方法。

var customer1 = new Customer( id: 1, groupId: 3);
customer1.getRelatedRecords('Group');

class Model 
 ...

  getRelatedRecords(reln) 
    var targetRelationship = this.relationships()[reln];
    if (!targetRelationship) 
        throw new Error("No relationship found.");
    
    var primaryKey = this._getPrimaryKey();

    var relatedObject = eval(reln);
    var attr = ;
    if (targetRelationship.type == "hasOne") 
        console.log(this.values);
        attr[relatedObject.prototype._getPrimaryKey()] = this.values[targetRelationship.foreignKey];
     else if (targetRelationship.type == "hasMany") 
        attr[targetRelationship.foreignKey] = this.values[this._getPrimaryKey()];
    

    relatedObject.findByAttribute(attr).then(function(records) 
        // this.values[reln] = records;
    );
   
 ...

应该在哪里定义将连接到数据库的 SQL 查询?在getById、getByGroupId等?

这很棘手,但由于您希望解决方案简单,请将查询放在您的 find 方法中。理想的情况是拥有自己的 QueryBuilder 类。

检查以下完整代码,解决方案功能不全,但您明白了。我还在模型中添加了引擎变量,您可以使用它来增强获取机制。所有其他设计想法都取决于您的想象:)

完整代码:

var config = 
  engine: 'db' // Ex: rest, db
;
class Model 

  constructor(values) 
    this.values = values;
    this.engine = config.engine;
  

  toObj() 
    var data = ;
    for (var key in this.values) 
      if (this.values[key] instanceof Model) 
        data[key] = this.values[key].toObj();
       else if (this.values[key] instanceof Array) 
        data[key] = this.values[key].map(x => x.toObj());
       else 
        data[key] = this.values[key];
      
    
    return data;
  

  static findByAttribute(attr) 
    return new Promise((resolve, reject) => 
      var query = this._convertObjectToQueriesArray(attr);
      query = query.join(" and ");
      let records = `SELECT * from $this.getResourceName() where $query`;
      var result = this.run(records);
      // Note: Only support 'equals' and 'and' operator
      if (!result) 
        reject('Could not found records');
       else 
        var data = [];
        result.forEach(function(record) 
          data.push(new this(record));
        );
        resolve(data);
      
    );
  

  getRelatedRecords(reln) 
    var targetRelationship = this.relationships()[reln];
    if (!targetRelationship) 
      throw new Error("No relationship found.");
    
    var primaryKey = this._getPrimaryKey();

    var relatedObject = eval(reln);
    var attr = ;
    if (targetRelationship.type == "hasOne") 
      console.log(this.values);
      attr[relatedObject.prototype._getPrimaryKey()] = this.values[targetRelationship.foreignKey];
     else if (targetRelationship.type == "hasMany") 
      attr[targetRelationship.foreignKey] = this.values[this._getPrimaryKey()];
    

    relatedObject.findByAttribute(attr).then(function(records) 
      // this.values[reln] = records;
    );
  

  /**
   * Test function to show what queries are being ran.
   */
  static run(query) 
    console.log(query);
    return [];
  

  _getPrimaryKey() 
    for (var key in this.attributes()) 
      if (this.attributes()[key].primary) 
        return key;
      
    
  

  /**
   * Convert Object of key value to sql filters
   * 
   * @param  Object Ex: id:1, name: "John"
   * @return Array of String ['id=1', 'name=John']
   */
  static _convertObjectToQueriesArray(attrs) 
    var queryArray = [];
    for (var key in attrs) 
      queryArray.push(key + " = " + attrs[key]);
    
    return queryArray;
  

  /**
   * Returns table name or resource name.
   * 
   * @return String
   */
  static getResourceName() 
    if (this.resourceName) return this.resourceName();
    if (this.constructor.name == "Model") 
      throw new Error("Model is not initialized");
    
    return this.constructor.name.toLowerCase();
  


class Customer extends Model 
  attributes() 
    return 
      id: 
        type: 'integer',
        primary: true
      ,
      name: 
        type: 'string'
      ,
      groupId: 
        type: 'integer'
      ,
      status: 
        type: 'string'
      ,
      state: 
        type: 'string'
      
    ;
  

  relationships() 
    return 
      'Group': 
        type: 'hasOne',
        foreignKey: 'groupId'
      
    ;
  


class Group extends Model 
  attributes() 
    return 
      id: 
        type: 'integer',
        primary: true
      ,
      title: 
        type: 'string'
      
    ;
  

  relationships() 
    return 
      'Customer': 
        type: 'hasMany',
        foreignKey: 'groupId'
      
    ;
  


var cust = new Customer(
  id: 1,
  groupId: 3
);
cust.getRelatedRecords('Group');

var group = new Group(
  id: 3,
  title: "Awesome Group"
);
group.getRelatedRecords('Customer');

var groupData = new Group(
  "id": 2,
  "title": "This is Group 2",
  "customers": [new Customer(
      "id": 1,
      "name": "John Doe",
      "groupId": 2,
      "status": "active",
      "state": "good"
    ),
    new Customer(
      "id": 4,
      "name": "Pete Smith",
      "groupId": 2,
      "status": "suspended",
      "state": "bad"
    )
  ]
);

console.log(groupData.toObj());

【讨论】:

以上是关于数据模型的 ES6 类的主要内容,如果未能解决你的问题,请参考以下文章

将带有符号的 ES6 类转换为 JSON

Vue.set (修改数组单一下标的值)

Django的模型层

跟大佬学django-编写博客的数据模型类

django模型详解

使用核心数据生成的类作为模型对象......?