NPM模块中的connect方法是否阻塞？

Question

Node.js (这里)的官方mysql包文档为连接数据库和执行基本查询提出了以下建议：

var mysql      = require('mysql');
var connection = mysql.createConnection({
  host     : 'localhost',
  user     : 'me',
  password : 'secret',
  database : 'my_db'
});

connection.connect();

connection.query('SELECT 1 + 1 AS solution', function (error, results, fields) {
  if (error) throw error;
  console.log('The solution is: ', results[0].solution);
});

connection.end();

connect方法还接受一个可选的回调函数，文档提供了以下这种用法的示例(忽略下面示例中的注释；此示例实际上试图演示其他内容)：

var connection = require('mysql').createConnection({
  port: 84943, // WRONG PORT 
});

connection.connect(function(err) {
  console.log(err.code); // 'ECONNREFUSED' 
  console.log(err.fatal); // true 
});

connection.query('SELECT 1', function (error, results, fields) {
  console.log(error.code); // 'ECONNREFUSED' 
  console.log(error.fatal); // true 
});

在这两种情况下，查询方法都是在connect方法之后调用的，而不是像预期的那样在connect方法的回调中调用。这似乎意味着connect方法正在阻塞(即/同步)。

所以我有一个简单的问题，然后是一些更细微的问题：

是NPM模块中的方法阻塞？。

如果是这样的话，这不违背节点约定吗？不是要在传递给connect方法的回调中执行查询吗？

最后，如果连接方法是阻塞的，并且违背了节点约定，为什么mysql模块的设计者决定让connect 阻塞？这种方法的优点是什么？作为最流行的mysql Node.js包，我相信采取这种方法是有原因的。

Answer 1

问得好！

从文档中，我推断您所执行的所有查询都在内部排队。

当您调用connection.connect()时，它将(异步地)开始设置到服务器的连接，它还将初始化一个查询队列，您想要运行的所有查询(通过调用connection.query())都将排队。

一旦建立了实际的连接，它将执行排队查询.

connection.end()也会发生类似的情况:它将“确保在向connection.end()服务器发送COM_QUIT数据包之前仍然执行所有以前排队的查询”(来源)。

因此，看起来这两种方法都是阻塞的(同步的)，但实际上它们不是。