1.1 实验内容
Sequelize 是一个 Node.js 平台基于 Promise 的ORM。用于操作管理 MySQL、Postgres、SQLite 等关系型数据库。本课程主要学习使用 Sequelize 操作 MySQL 数据库。Sequelize 官方文档:http://docs.sequelizejs.com/en/latest/
1.2 实验知识点
- Sequelize 的使用
1.3 实验环境
- Node.js 6.x
1.4 适合人群
本课程难度为一般,属于初级级别课程,适合具有 Node.js 基础的用户学习 Node.js 连接 MySQL 数据库的相关开发。
二、开发准备
2.1 初始化项目
首先,创建一个 Node.js 项目:
-
$ mkdir myblog
-
$ cd myblog
-
myblog/ $ npm init
npm init
命令会提示输入一系列项目信息,直接一路回车即可。
然后安装 Sequelize 和 MySQL 包:
-
myblog/ $ npm install sequelize --save
-
myblog/ $ npm install mysql --save
OK,安装完毕!
三、实验步骤
3.1 连接数据库
首先,需要启动 MySQL 数据库:
$ sudo service mysql start
因为 Sequelize 不能创建数据库,所以需要手动创建一个数据库:
-
$ mysql -uroot
-
> create database blog;
-
>
-
按 Ctrl+c
键退出MySQL命令行界面。
创建了数据库之后,就可以通过 Sequelize 连接到数据库了,在 myblog
文件夹中新建 db.js
文件:
-
// db.js
-
-
var Sequelize = require('sequelize');
-
-
/*
-
// new Sequelize(database, [username=null], [password=null], [options={}])
-
// class Sequelize 接收4个参数,后三个参数是可选的
-
-
// 没有密码和options
-
var sequelize = new Sequelize('database', 'username')
-
-
// 没有options
-
var sequelize = new Sequelize('database', 'username', 'password')
-
-
// 没有密码有options
-
var sequelize = new Sequelize('database', 'username', null, {})
-
-
// 都有
-
var sequelize = new Sequelize('my_database', 'john', 'doe', {})
-
-
// new Sequelize(uri, [options={}])
-
// 通过uri连接数据库
-
var sequelize = new Sequelize('mysql://localhost:3306/database', {})
-
*/
-
-
module.exports = new Sequelize('blog', 'root', null, {
-
host: 'localhost', // 数据库地址
-
dialect: 'mysql', // 指定连接的数据库类型
-
pool: {
-
max: 5, // 连接池中最大连接数量
-
min: 0, // 连接池中最小连接数量
-
idle: 10000 // 如果一个线程 10 秒钟内没有被使用过的话,那么就释放线程
-
}
-
});
连接数据库初始化时,Sequelize 会设置一个连接池,所以每个数据库创建一个实例即可。
连接池是创建和管理一个连接的缓冲池的技术,这些连接准备好被任何需要它们的线程使用。
3.2 创建用户表
下面来创建一张表模型(model),在myblog
文件夹中新建user.js
文件:
-
// user.js
-
-
var Sequelize = require('sequelize');
-
var sequelize = require('./db');
-
-
// 创建 model
-
var User = sequelize.define('user', {
-
userName: {
-
type: Sequelize.STRING, // 指定值的类型
-
field: 'user_name' // 指定存储在表中的键名称
-
},
-
// 没有指定 field,表中键名称则与对象键名相同,为 email
-
email: {
-
type: Sequelize.STRING
-
}
-
}, {
-
// 如果为 true 则表的名称和 model 相同,即 user
-
// 为 false MySQL创建的表名称会是复数 users
-
// 如果指定的表名称本就是复数形式则不变
-
freezeTableName: false
-
});
-
-
// 创建表
-
// User.sync() 会创建表并且返回一个Promise对象
-
// 如果 force = true 则会把存在的表(如果users表已存在)先销毁再创建表
-
// 默认情况下 forse = false
-
var user = User.sync({ force: false });
-
-
// 添加新用户
-
exports.addUser = function(userName, email) {
-
// 向 user 表中插入数据
-
return User.create({
-
user_name: userName,
-
email: email
-
});
-
};
-
-
// 通过用户名查找用户
-
exports.findByName = function(userName) {
-
return User.findOne({ where: { user_name: userName } });
-
};
3.3 测试用户表
在myblog
文件夹中创建testUser.js
文件,测试user.js:
-
// testUser.js
-
-
var user = require('./user');
-
-
// 添加用户
-
user.addUser('jack', 'jack@163.com').then(function() {
-
// 查询新添加的用户
-
return user.findByName('jack');
-
}).then(function(user) {
-
console.log('****************************');
-
console.log('user name: ', user.user_name);
-
console.log('user email: ', user.email);
-
});
运行testUser.js
文件:
myblog/ $ node testUser.js
可以看到终端的最后打印出了用户名和用户邮箱,说明创建表和插入数据成功了。也可以登录到MySQL,手动查询是否成功创建了用户表和插入了数据。
3.4 创建文章表
在myblog
文件夹中创建post.js
文件:
-
// post.js
-
-
var Sequelize = require('sequelize');
-
var sequelize = require('./db');
-
-
var Post = sequelize.define('post', {
-
// 文章标题
-
title: {
-
type: Sequelize.STRING
-
},
-
// 文章内容
-
content: {
-
type: Sequelize.STRING
-
},
-
// 文章发表时间
-
create_at: {
-
type: Sequelize.DATE
-
}
-
}, {
-
freezeTableName: false
-
});
-
-
var post = Post.sync();
-
-
// 发表新文章
-
exports.newPost = function(title, content) {
-
return post.then(function() {
-
Post.create({
-
title: title,
-
content: content,
-
create_at: Date.now()
-
});
-
});
-
};
-
-
// 查找所以文章
-
exports.findAllPosts = function() {
-
return Post.findAll();
-
};
-
-
// 通过 ID 查找文章
-
exports.findById = function(id) {
-
return Post.findById(id);
-
};
3.5 测试文章表
新建testPost.js
文件:
-
var post = require('./post');
-
-
// 插入一篇文章
-
post.newPost('post title', 'post content').then(function() {
-
// 通过ID查找文章
-
return post.findById(1);
-
}).then(function(p) {
-
console.log('********************************');
-
console.log('post title: ', p.title);
-
console.log('post content: ', p.content);
-
});
运行testPost.js
文件:
myblog/ $ node testPost.js
可以看到终端的最后打印出了文章标题文章内容,说明创建表和插入数据成功了。也可以登录到 MySQL,手动查询是否成功创建了文章表和插入了数据。
通过 Sequelize 操作 MySQL 数据库很简单吧!
更多功能可以看看Sequelize文档:http://docs.sequelizejs.com/en/latest/
四、总结
Sequelize 是一个 Node.js 平台基于 Promise 的ORM。用于操作管理 MySQL、Postgres、SQLite 等关系型数据库。本课程主要学习使用 Sequelize 操作 MySQL 数据库。Sequelize 官方文档:http://docs.sequelizejs.com/en/latest/