Update to 4.33.4

Update to 4.33.4

Author: demopark

CHANGELOG.md

@@ -1,5 +1,9 @@
 # 更新记录
 
+## 2018-2-23
+* 修复部分内部链接
+* 同步官方最新文档版本 4.33.4
+
 ## 2018-1-22
 * 同步官方最新文档版本 4.31.2
 

getting-started.md

@@ -9,7 +9,7 @@ Sequelize 可通过 NPM 和 Yarn 获得。
 $ npm install --save sequelize
 
 # 还有以下之一:
-$ npm install --save pg@6 pg-hstore #pg@7 当前不支持
+$ npm install --save pg pg-hstore
 $ npm install --save mysql2
 $ npm install --save sqlite3
 $ npm install --save tedious // MSSQL

migrations.md

@@ -35,26 +35,26 @@ $ node_modules/.bin/sequelize init
 
 ```json
 {
-  development: {
-    username: 'root',
-    password: null,
-    database: 'database_development',
-    host: '127.0.0.1',
-    dialect: 'mysql'
+  "development": {
+    "username": "root",
+    "password": null,
+    "database": "database_development",
+    "host": "127.0.0.1",
+    "dialect": "mysql"
   },
-  test: {
-    username: 'root',
-    password: null,
-    database: 'database_test',
-    host: '127.0.0.1',
-    dialect: 'mysql'
+  "test": {
+    "username": "root",
+    "password": null,
+    "database": "database_test",
+    "host": "127.0.0.1",
+    "dialect": "mysql"
   },
-  production: {
-    username: process.env.PROD_DB_USERNAME,
-    password: process.env.PROD_DB_PASSWORD,
-    database: process.env.PROD_DB_NAME,
-    host: process.env.PROD_DB_HOSTNAME,
-    dialect: 'mysql'
+  "production": {
+    "username": "root",
+    "password": null,
+    "database": "database_test",
+    "host": "127.0.0.1",
+    "dialect": "mysql"
   }
 }
 ```

raw-queries.md

@@ -73,9 +73,7 @@ sequelize.query('SELECT * FROM users WHERE name LIKE :search_name ',
 
 ## 绑定参数
 
-绑定参数就像替换。 除非替换被转义并在查询发送到数据库之前通过后续插入到查询中，而将绑定参数发送到SQL查询文本之外的数据库。 查询可以具有绑定参数或替换。
-
-只有SQLite和PostgreSQL支持绑定参数。 其他方言会将它们插入到SQL查询中，就像替换一样。 绑定参数由 `$1, $2, ... (numeric)` 或 `$key (alpha-numeric)` 引用。这是独立于方言。
+绑定参数就像替换。 除非替换被转义并在查询发送到数据库之前通过后续插入到查询中，而将绑定参数发送到SQL查询文本之外的数据库。 查询可以具有绑定参数或替换。绑定参数由 `$1, $2, ... (numeric)` 或 `$key (alpha-numeric)` 引用。这是独立于方言的。
 
 * 如果传递一个数组, `$1` 被绑定到数组中的第一个元素 (`bind[0]`)。
 * 如果传递一个对象, `$key` 绑定到 `object['key']`。 每个键必须以非数字字符开始。 `$1` 不是一个有效的键，即使 `object['1']` 存在。

upgrade-to-v4.md

@@ -124,59 +124,75 @@ Sequelize V4 是一个重要版本，它引入了新的功能和突破性的变
 - 原始参数 where, order 和 group 比如 `where: { $raw: '..', order: [{ raw: '..' }], group: [{ raw: '..' }] }` 删除以防止SQL注入攻击。
 - `Sequelize.Utils` 不再是公共API的一部分，使用它自己承担风险。
 - `Hooks` 现在应返回 promise。 不支持回调。
-- `include` 总是一个数组
+- `required` 内部的 include 不会传播 include 链。
 
-  之前:
+要获得 v3 兼容的效果，您需要在包含的 include 上设置 `required`。
+
+  以前:
+  
   ```js
-  User.findAll({
+  user.findOne({
     include: {
-      model: Comment,
-      as: 'comments'
+      model: project,
+      include: {
+        model: task,
+        required: true
+      }
     }
-  })
+  });
   ```
-  
+
   现在:
+  
   ```js
-  User.findAll({
-    include: [{
-      model: Comment,
-      as: 'comments'
-    }]
-  })
-  ```
-
-- `where` 在 `include` 中不会使这个 `include` 及其所有父节点都被 `required`。你可以使用下面的 `beforeFind` 全局 Hook 来保持以前的行为：
+  User.findOne({
+    include: {
+      model: Project,
+      required: true,
+      include: {
+        model: Task,
+        required: true
+      }
+    }
+  });
 
-  ```js
-  function whereRequiredLikeInV3(modelDescriptor) {
-    if (!modelDescriptor.include) {
-      return false;
+  User.findOne({
+    include: {
+      model: Project,
+      required: true,
+      include: {
+        model: Task,
+        where: {type: 'important'} //其中 required 默认为 true
+      }
     }
+  });
+  ```
 
-    return modelDescriptor.include.some(relatedModelDescriptor => {
-      const childDescriptorRequired = whereRequiredLikeInV3(
-        relatedModelDescriptor,
-      );
+或者，您可以添加 `beforeFind` hook 来获得兼容 v3 的行为 -
 
-      if (
-        (relatedModelDescriptor.where || childDescriptorRequired) &&
-        typeof relatedModelDescriptor.required === 'undefined'
-      ) {
-        relatedModelDescriptor.required = true;
+  ```js
+  function propagateRequired(modelDescriptor) {
+    let include = modelDescriptor.include;
+    
+    if (!include) return false;
+    if (!Array.isArray(include)) include = [include];
+
+    return include.reduce((isRequired, descriptor) => {
+      const hasRequiredChild = propogateRequired(descriptor);
+      if ((descriptor.where || hasRequiredChild) && descriptor.required === undefined) {
+        descriptor.required = true;
       }
-
-      return relatedModelDescriptor.required;
-    });
+      return descriptor.required || isRequired;
+    }, false);
   }
   
   const sequelize = new Sequelize(..., {
     ...,
     define: {
       hooks: {
-        beforeFind: whereRequiredLikeInV3,
-      },
-    },
+        beforeFind: propagateRequired
+      }
+    }
   });
   ```
 

usage.md

@@ -14,7 +14,7 @@ const sequelize = new Sequelize('database', 'username', 'password', {
 
 ```js
 const sequelize = new Sequelize('database', 'username', 'password', {
-  dialect: 'mysql'
+  dialect: 'mysql',
   host: "my.server.tld",
   port: 9821,
 })
@@ -198,8 +198,6 @@ const sequelize = new Sequelize('database', 'username', 'password', {
 })
 ```
 
-**注意:** `pg@^7.0.0` 当前不被支持.
-
 ### MSSQL
 
 MSSQL 的库是 `tedious@^1.7.0` 你只需要定义方言: