Node.js的MySQL基础1——Express与MySQL联调

0.目标

实现通过Node.js对MySQL进行数据CURD操作，这里将使用Node.js的Express框架。

---

1.前置条件

1.1 已经安装了MySQL数据库。

建议再安装一个可视化操作工具MySQL Front

1.2 安装Express和MySQL

npm install express --save
npm install mysql --save

---

2.重点

2.0 文件夹结构预览

文件夹结构

整个应用的流程如下：

启动app.js后，用户在浏览器发出请求，调用routes对应的方法，从models中找到处理方法，从config获取配置后对数据库进行操作。

2.1 定义数据库配置参数

这里先在config文件夹里创建一个db.js文件，导出一个名为onelib的数据库链接配置。

module.exports = {
 onelib: {
 host: '127.0.0.1',   // MySQL所在服务器IP
 user: 'root',        // 用户名
 password: '',        // 密码
 database:'onelib',   // 数据库名称
 port: 3306,          // 端口号
 dateStrings: true,   // 时间以字符串形式显示，否则会有类似这样的显示：Thu Apr 14 2016 00:00:00 GMT+0800 (中国标准时间) 17:20:12
 }
};

注意，如果有多个数据库，可以增加一个配置参数，和onelib并列。如：

module.exports = {
 onelib: {
 ……
 },
 newdb: {    // 新的数据库配置
 ……
 }
};

2.2 设置数据库连接

仍然在config文件夹中创建一个文件，名为mysql.js。该文件用于建立与MySQL的连接。

var mysql = require('mysql'); // 引用mysql模块。注意要先安装mysql： npm install mysql
var config = require('./db');

var onelib_pool = mysql.createPool(config.onelib);
exports.onelib_pool = onelib_pool;

注意，如果有多个数据库，只需要使用对应的配置(在db.js中定义的)信息即可设置多个数据库连接，如：

var mysql = require('mysql'); // 引用mysql模块。注意要先安装mysql： npm install mysql
var config = require('./db');

// 数据库连接
var onelib_pool = mysql.createPool(config.onelib);
exports.onelib_pool = onelib_pool;

// 新的数据库连接
var newdb_pool = mysql.createPool(config. newdb);
exports. newdb_pool = newdb_pool;

2.3 操作数据库的模型

在数据库配置完毕并建立连接后，即可对数据库进行CURD操作。
我们在models文件夹中，创建一个名为tasks.js的文件，用来存储对task模块的操作：

var mysql = require('../config/mysql');// 获取数据库连接配置

var Task = function() {}; // 预定义一个空的类，接下来只需要往里增加方法即可

Task.prototype.find = function(id, callback) {  // 增加一个方法，名为find，传入参数为id和回调函数callback

 // sql查询语句，注意这里的“?”号，它会在query的时候被处理
 var sql = "SELECT * FROM tasks WHERE id =?";
 
 // 获取mysql的onelib_pool连接池，以回调的方式处理（即获取成功后，执行下一步）
 mysql.onelib_pool.getConnection(function(err, connection) {
 if (err) {
 callback(true);
 return;
 }
 // 获取成功后，执行query
 // 注意到这里有三个参数，第一个是sql语句，第二个是一个数组，第三个是回调函数
 // 需要着重说明的是第二个参数，它将依次替换sql里的“?”号
 // sql语句被替换后，会是这样的："SELECT * FROM tasks WHERE id = " + id
 connection.query(sql, [id], function(err, results) {
 if (err) {
 callback(true);
 return;
 }
 callback(false, results);
 });
 });
};

Hint1：如果我们要对newdb进行操作，则可以这样写：

Task.prototype.find = function(id, callback){
 ……
 mysql.newdb_pool.getConnection(function(err, connection) {
 ……
 });
};

Hint2：关于sql语句的填写：

如果有多个参数要传入，可以这么写：

var sql = "SELECT * FROM tasks WHERE releaser=? OR relative=?";
var sql_value_arr = [name, name]; // 对应sql语句里的问号
……
connection.query(sql, sql_value_arr, function(err, results) {
 ……    
}

如果没有参数要传入，可以这么写：

var sql = "SELECT * FROM tasks";
var sql_value_arr = [];
……
connection.query(sql, sql_value_arr, function(err, results) {
 ……    
}

2.4 处理路由请求

在routes文件夹中创建一个文件：tasks.js。这个文件用来处理用户的路由请求

// 引用tasks模型
var Task = require('../models/tasks');

// 根据taskid获取任务数据
exports.getTask = function(req, res) {
 var taskid = req.params.taskid;
 var task = new Task();
 task.find(taskid,function(err,result){
 if(err){
 res.send('没有找到taskid为'+taskid+'的任务');
 }
 else if(undefined!=result){ // 增加这个判断，否则在没有查询到的情况下（sql查询出错的情况下），Node.js会挂掉。当然，你也可以安装supervisor，这样即使挂掉了也会自动重启。安装指令为“npm install -g supervisor”，安装完毕后，使用“supervisor app”来代替“node app”来启动应用
 res.send(result.length === 1 ? result[0]:result);
 }
 else{
 res.end("Error");
 }
 });
}

Hint1：关于查询结果的结构
查询结果如果只有一个，会以对象的形式返回。查询结果如果有多个，会以数组的形式把对象组合起来

Hint2：关于undefined的检查
如果查询结果result为undefined，而我们又对result取result[0]，将导致出错，Node.js会直接挂掉！

Hint3：对结果集进行解析
当前的代码会将查询结果直接以对象的形式输出到页面中，如果不是ajax的请求，这样的输出会unreadable；所以，我们有必要在输出之前先对其进行“装饰”。虽然这个是前端工程师的工作，但我们的目标是全栈工程师嘛。

2.5 映射路由到应用中

注意到，我们之前写的方法全部是export的，即可以被外部调用的。我们把路由请求的处理也export了，目的是让app.js文件更简洁，路由的实现全部在routes文件夹里，而不会掺杂在app.js文件中。

下面给出app.js代码

var express = require('express')
  , path = require('path')
  , task = require('./routes/tasks');
var app = express();

/* 主页 */
app.get('/', function(req, res){
  res.sendfile('views/index.html');
});

/* 处理路由请求 */
// Onelib
app.get('/gettask/:taskid',task.getTask);
// newdb
app.get('/gettask/:taskid',task.getTask);

/* 设置静态文件路径 */
app.use(express.static(path.join(__dirname, 'public')));

/* 启动服务器 */
var server = app.listen(3000, function(){
 
 var host = server.address().address;
 var port = server.address().port;
 
 console.log("*** OneLib智库已启动，访问地址为 http://%s:%s", host, port)
});

打开浏览器，输入

http://127.0.0.1:3000/gettask/1

taskid为1的数据将显示在网页中（当然，你的数据库里首先要有这个数据 ^ _ ^）

---

原创文章，未经许可，请勿转载
作者：Mike的读书季
日期：2016.08.08
QQ：1139904786
Blog：http://blog.csdn.net/kkdestiny