近來公司須要構建一套 EMM（Enterprise Mobility Management）的管理平臺，就這種面向企業的應用管理自己須要考慮的需求是十分複雜的，技術層面管理端和服務端構建是架構核心，客戶端自己初期倒不須要那麼複雜，做爲移動端的負責人（其實也就是一個打雜的小組長），這個平臺架構我天然是免不了去參與的，做爲一個前端 jser 來公司這邊老是接到這種不太像前端的工做，要是之前我可能會有些抵觸這種業務層面須要考慮的不少，技術實現自己又不太容易積累技術成長的活。這一年我成長了太多，老是嘗試着去作一些可能本身談不上喜歡但仍是有意義的事情，因此此次接手這個任務仍是想好好把這個事情作好，因此想考慮參與到 EMM 服務端構建。其實話又說回來，任何事只要想去把它作好，怎麼會存在有意義仍是沒意義的區別呢？html
考慮到基於 Node.js 構建的服務目前愈來愈流行，也方便後續放在平臺容器雲上構建微服務，另外做爲一個前端 jser 出身的程序員，使用 Node.js 來構建服務格外熟悉。以前學習過一段時間 Egg.js，此次絕不猶豫的選擇了基於 Egg.js 框架來搭建。前端
去年在 gitchat JavaScript 進階之 Vue.js + Node.js 入門實戰開發 中安利過 Egg.js，那個時候是初接觸 Egg.js，可是仍是被它驚豔到了，Egg 繼承於 Koa，奉行『約定優於配置』，按照一套統一的約定進行應用開發，插件機制也比較完善。雖說 Egg 繼承於 Koa，你們可能以爲徹底能夠本身基於 Koa 去實現一套，不必基於這個框架去搞，可是其實本身去設計一套這樣的框架，最終也是須要去借鑑各家所長，時間成本上短時間是划不來的。Koa 是一個小而精的框架，而 Egg 正如文檔說的爲企業級框架和應用而生，對於咱們快速搭建一個完備的企業級應用仍是很方便的。Egg 功能已經比較完善，另外若是沒有實現的功能，本身根據 Koa 社區提供的插件封裝一下也是不難的。node
在數據庫選擇上本次項目考慮使用 MySQL，而不是 MongoDB，開始使用的是 egg-mysql 插件，寫了一部分後發現 service 裏面寫了太多東西，表字段修改會影響太多代碼，在設計上缺少對 Model 的管理，看到資料說能夠引入 ORM 框架，好比 sequelize，而 Egg 官方剛好提供了 egg-sequelize 插件。mysql
首先了解一下什麼是 ORM ?git
對象關係映射（英語：Object Relational Mapping，簡稱 ORM，或 O/RM，或 O/R mapping），是一種程序設計技術，用於實現面向對象編程語言裏不一樣類型系統的數據之間的轉換。從效果上說，它實際上是建立了一個可在編程語言裏使用的「虛擬對象數據庫」。程序員
相似於 J2EE 中的 DAO 設計模式，將程序中的數據對象自動地轉化爲關係型數據庫中對應的表和列，數據對象間的引用也能夠經過這個工具轉化爲表。這樣就能夠很好的解決我遇到的那個問題，對於表結構修改和數據對象操做是兩個獨立的部分，從而使得代碼更好維護。實際上是否選擇 ORM 框架，和之前前端是選擇模板引擎仍是手動拼字符串同樣，ORM 框架避免了在開發的時候手動拼接 SQL 語句，能夠防止 SQL 注入，另外也將數據庫和數據 CRUD 解耦，更換數據庫也相對更容易。github
sequelize 是 Node.js 社區比較流行的一個 ORM 框架，相關文檔：web
安裝：算法
$ npm install --save sequelize
創建鏈接：sql
const Sequelize = require("sequelize"); // 完整用法 const sequelize = new Sequelize("database", "username", "password", { host: "localhost", dialect: "mysql" | "sqlite" | "postgres" | "mssql", operatorsAliases: false, pool: { max: 5, min: 0, acquire: 30000, idle: 10000 }, // SQLite only storage: "path/to/database.sqlite" }); // 簡單用法 const sequelize = new Sequelize("postgres://user:pass@example.com:5432/dbname");
校驗鏈接是否正確：
sequelize
.authenticate() .then(() => { console.log("Connection has been established successfully."); }) .catch(err => { console.error("Unable to connect to the database:", err); });
定義 Model ：
定義一個 Model 的基本語法：
sequelize.define("name", { attributes }, { options });
例如：
const User = sequelize.define("user", { username: { type: Sequelize.STRING }, password: { type: Sequelize.STRING } });
對於一個 Model 字段類型設計，主要考慮如下幾個方面：
Sequelize 默認會添加 createdAt 和 updatedAt，這樣能夠很方便的知道數據建立和更新的時間。若是不想使用能夠經過設置 attributes 的 timestamps: false；
Sequelize 支持豐富的數據類型，例如：STRING、CHAR、TEXT、INTEGER、FLOAT、DOUBLE、BOOLEAN、DATE、UUID 、JSON 等多種不一樣的數據類型，具體能夠看文檔：DataTypes。
Getters & setters 支持，當咱們須要對字段進行處理的時候十分有用，例如：對字段值大小寫轉換處理。
const Employee = sequelize.define("employee", { name: { type: Sequelize.STRING, allowNull: false, get() { const title = this.getDataValue("title"); return this.getDataValue("name") + " (" + title + ")"; } }, title: { type: Sequelize.STRING, allowNull: false, set(val) { this.setDataValue("title", val.toUpperCase()); } } });
字段校驗有兩種類型：非空校驗及類型校驗，Sequelize 中非空校驗經過字段的 allowNull 屬性斷定，類型校驗是經過 validate 進行斷定，底層是經過 validator.js 實現的。若是模型的特定字段設置爲容許 null（allowNull：true），而且該值已設置爲 null，則 validate 屬性不生效。例如，有一個字符串字段，allowNull 設置爲 true，validate 驗證其長度至少爲 5 個字符，但也容許爲空。
const ValidateMe = sequelize.define("foo", { foo: { type: Sequelize.STRING, validate: { is: ["^[a-z]+$", "i"], // will only allow letters is: /^[a-z]+$/i, // same as the previous example using real RegExp not: ["[a-z]", "i"], // will not allow letters isEmail: true, // checks for email format (foo@bar.com) isUrl: true, // checks for url format (http://foo.com) isIP: true, // checks for IPv4 (129.89.23.1) or IPv6 format isIPv4: true, // checks for IPv4 (129.89.23.1) isIPv6: true, // checks for IPv6 format isAlpha: true, // will only allow letters isAlphanumeric: true, // will only allow alphanumeric characters, so "_abc" will fail isNumeric: true, // will only allow numbers isInt: true, // checks for valid integers isFloat: true, // checks for valid floating point numbers isDecimal: true, // checks for any numbers isLowercase: true, // checks for lowercase isUppercase: true, // checks for uppercase notNull: true, // won't allow null isNull: true, // only allows null notEmpty: true, // don't allow empty strings equals: "specific value", // only allow a specific value contains: "foo", // force specific substrings notIn: [["foo", "bar"]], // check the value is not one of these isIn: [["foo", "bar"]], // check the value is one of these notContains: "bar", // don't allow specific substrings len: [2, 10], // only allow values with length between 2 and 10 isUUID: 4, // only allow uuids isDate: true, // only allow date strings isAfter: "2011-11-05", // only allow date strings after a specific date isBefore: "2011-11-05", // only allow date strings before a specific date max: 23, // only allow values <= 23 min: 23, // only allow values >= 23 isCreditCard: true, // check for valid credit card numbers // custom validations are also possible: isEven(value) { if (parseInt(value) % 2 != 0) { throw new Error("Only even values are allowed!"); // we also are in the model's context here, so this.otherField // would get the value of otherField if it existed } } } } });
最後咱們說明一個最重要的字段主鍵 id 的設計， 須要經過字段 primaryKey: true 指定爲主鍵。MySQL 裏面主鍵設計主要有兩種方式：自動遞增；UUID。
自動遞增設置 autoIncrement: true 便可，對於通常的小型系統這種方式是最方便，查詢效率最高的，可是這種不利於分佈式集羣部署，這種基本用過 MySQL 裏面應用都用過，這裏不作深刻討論。
UUID, 又名全球獨立標識(Globally Unique Identifier)，UUID 是 128 位(長度固定)unsigned integer, 可以保證在空間(Space)與時間(Time)上的惟一性。並且無需註冊機制保證, 能夠按需隨時生成。據 WIKI, 隨機算法生成的 UUID 的重複機率爲 170 億分之一。Sequelize 數據類型中有 UUID，UUID1，UUID4 三種類型，基於node-uuid 遵循 RFC4122。例如：
const User = sequelize.define("user", { id: { type: Sequelize.UUID, primaryKey: true, allowNull: false, defaultValue: Sequelize.UUID1 } });
這樣 id 默認值生成一個 uuid 字符串，例如：'1c572360-faca-11e7-83ee-9d836d45ff41'，不少時候咱們不太想要這個 - 字符，咱們能夠經過設置 defaultValue 實現，例如：
const uuidv1 = require("uuid/v1"); const User = sequelize.define("user", { id: { type: Sequelize.UUID, primaryKey: true, allowNull: false, defaultValue: function() { return uuidv1().replace(/-/g, ""); } } });
使用 Model 對象：
對於 Model 對象操做，Sequelize 提供了一系列的方法：
經過上述提供的一系列方法能夠實現數據的增刪改查（CRUD），例如：
User.create({ username: "fnord", job: "omnomnom" }) .then(() => User.findOrCreate({ where: { username: "fnord" }, defaults: { job: "something else" } }) ) .spread((user, created) => { console.log( user.get({ plain: true }) ); console.log(created); /* In this example, findOrCreate returns an array like this: [ { username: 'fnord', job: 'omnomnom', id: 2, createdAt: Fri Mar 22 2013 21: 28: 34 GMT + 0100(CET), updatedAt: Fri Mar 22 2013 21: 28: 34 GMT + 0100(CET) }, false ] */ });
文檔：egg-sequelize：https://github.com/eggjs/egg-sequelize
這裏咱們暫時先不分析 egg 插件規範，暫時先只看看 egg-sequelize/lib/loader.js 裏面的實現：
"use strict"; const path = require("path"); const Sequelize = require("sequelize"); const MODELS = Symbol("loadedModels"); const chalk = require("chalk"); Sequelize.prototype.log = function() { if (this.options.logging === false) { return; } const args = Array.prototype.slice.call(arguments); const sql = args[0].replace(/Executed \(.+?\):\s{0,1}/, ""); this.options.logging.info("[model]", chalk.magenta(sql), `(${args[1]}ms)`); }; module.exports = app => { const defaultConfig = { logging: app.logger, host: "localhost", port: 3306, username: "root", benchmark: true, define: { freezeTableName: false, underscored: true } }; const config = Object.assign(defaultConfig, app.config.sequelize); app.Sequelize = Sequelize; const sequelize = new Sequelize( config.database, config.username, config.password, config ); // app.sequelize Object.defineProperty(app, "model", { value: sequelize, writable: false, configurable: false }); loadModel(app); app.beforeStart(function*() { yield app.model.authenticate(); }); }; function loadModel(app) { const modelDir = path.join(app.baseDir, "app/model"); app.loader.loadToApp(modelDir, MODELS, { inject: app, caseStyle: "upper", ignore: "index.js" }); for (const name of Object.keys(app[MODELS