咳咳,终于迈出这一步了...这篇文章将是边学边写的真正笔记...用于mark下学习过程中的点滴~
开篇先把我学习参考的文章来源给出,以表示对前人的尊敬:
https://github.com/nswbmw/N-blog/wiki/_pages
Step01
首先,先安装一堆东西,当然我默认的已经把 node 给装好了,接下来要安装的,是项目开发过程中用到的东东~
至于下面装的是什么东东,不知道的自己百度去,这种概念性问题不在笔记之列。
全局安装 express
install -g express-generator
全局安装 supervisor
npm install -g supervisor
下载并安装 mongoDB
官网地址:https://www.mongodb.org/downloads
mongoDB 也有可视化工具,名为 Robomongo,官网地址:http://www.robomongo.org/
Step02
上面几个玩意都安装好后,环境已备,可以开始码字了。
先创建一个 express 项目吧,在你想创建项目的目录下执行下面命令(projectName 是你要创建的项目名称):
express -e projectName
项目创建后,进入刚建好的项目根目录,执行
npm install
安装项目依赖的 node 模块
等模块安装好之后,你就可以执行下面的命令,运行项目程序了
supervisor ./bin/www
执行上面命令后,打开浏览器,在地址栏中输入 http://127.0.0.1:3000/ 然后看到浏览器里显示 Express 的欢迎界面,说明项目创建运行成功。
Step03
接下来,我们要链接数据库,并尝试数据写入和数据读取
首先,我们先在项目根目录找到 package.json 文件
然后打开文件,找到 dependencies 在加上下面几个项目依赖模块
"bson": "~0.4.19",
"connect-flash": "~0.1.1",
"connect-mongo": "~0.4.1",
"express-session": "~1.9.1",
"mongodb": "~1.4.15"
然后再执行
npm install
安装上面添加的几个依赖模块
打开 app.js 将它修改成如下:
var express = require('express');
var path = require('path');
var favicon = require('serve-favicon');
var logger = require('morgan');
var cookieParser = require('cookie-parser');
var bodyParser = require('body-parser'); var routes = require('./routes/index');
var session = require('express-session');
var MongoStore = require('connect-mongo')(session);
var flash = require('connect-flash'); var app = express(); //设置模版引擎
app.set('views', path.join(__dirname, 'views'));
app.set('view engine', 'ejs'); app.set(flash()); //设置标题栏小图标
//app.use(favicon(path.join(__dirname, 'favicon.ico'))); app.use(logger('dev'));
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({extended: false}));
app.use(cookieParser());
app.use(express.static(path.join(__dirname, 'public'))); routes(app); //404异常处理
app.use(function (req, res, next) {
var err = new Error('Not Found');
err.status = 404;
next(err);
}); //打印错误信息
app.use(function (err, req, res, next) {
res.status(err.status || 500);
res.render('error', {
message: err.message,
error: {}
});
}); module.exports = app;
然后打开 routes/index.js 将它修改成如下:
var User = require('../modules/user'); module.exports = function(app) {
app.get('/', function (req, res, next) {
res.render('index', { title: 'Express' });
}); app.get('/saveUser', function (req, res, next) {
User.save({
name: 'Mike',
password: '123456',
email: 'qwe@163.com'
}, function (err, user) {
res.send('保存用户数据成功!');
});
}); app.get('/getUser', function (req, res, next) {
User.get('Mike', function (err, user) {
res.send({
email: user.email
});
});
});
};
routes/users.js 已经无用,可以删掉。
接下来,在根目录下创建一个 modules 目录,然后在 modules 目录下再创建一个 dataService 目录,所有和数据操作相关的 js 模块都将放在 modules/dataService 目录下
接下来,在 modules/dataService 下创建两个文件 conn.js 和 user.js
conn.js 的代码如下:
var settings = {
cookieSecret: 'myProject',
db: 'dataBaseName',
host: 'localhost',
port: 27017
},
mongodb = require('mongodb'),
Db = mongodb.Db,
Server = mongodb.Server; module.exports = new Db(settings.db, new Server(settings.host, settings.port), {
safe: true
});
user.js 的代码如下:
var mongodb = require('./conn'); var User = {}; //存储用户信息
User.save = function (opts, callback) {
//要存入数据库的用户文档
var user = {
name: opts.name,
password: opts.password,
email: opts.email
};
//打开数据库
mongodb.open(function (err, db) {
if (err) {
return callback(err);//错误,返回 err 信息
}
//读取 users 集合
db.collection('users', function (err, collection) {
if (err) {
mongodb.close();
return callback(err);//错误,返回 err 信息
}
//将用户数据插入 users 集合
collection.insert(user, {
safe: true
}, function (err, user) {
mongodb.close();
if (err) {
return callback(err);//错误,返回 err 信息
}
callback(null, user[0]);//成功!err 为 null,并返回存储后的用户文档
});
});
});
}; //读取用户信息
User.get = function (name, callback) {
//打开数据库
mongodb.open(function (err, db) {
if (err) {
return callback(err);//错误,返回 err 信息
}
//读取 users 集合
db.collection('users', function (err, collection) {
if (err) {
mongodb.close();
return callback(err);//错误,返回 err 信息
}
//查找用户名(name键)值为 name 一个文档
collection.findOne({
name: name
}, function (err, user) {
mongodb.close();
if (err) {
return callback(err);//失败!返回 err 信息
}
callback(null, user);//成功!返回查询的用户信息
});
});
});
}; module.exports = User;
嗯嗯嗯...思考了好一会,代码部分应该已经完成了。但别急着运行,还有一些准备工作需要做。
打开 mongoDB 的安装根目录(拿我自己举例,我安装的是32位版本,安装根目录为:C:\Program Files (x86)\MongoDB 2.6 Standard)
在该目录下创建一个文件夹,名称就是你的数据库名
然后启动命令行工具,进入 mongoDB 的安装根目录下的 lib 目录,然后执行下面命令:
mongod --dbpath ../dataBaseName/
dataBaseName 指是你的数据库名
以上命令的意思是:设置 dataBaseName 文件夹作为我们工程的存储目录并启动数据库
注意:一定要先创建目录(或者已经存在目录),再执行上面的命令,才能成功启动数据库,否则会报错
数据库成功启动之后,我们再重新启动一下我们的 node 服务端程序,就用上文提到过的命令:
supervisor ./bin/www
然后打开浏览器,访问 http://127.0.0.1:3000/saveUser ,就能看到界面上显示 “保存用户数据成功!”
再访问 http://127.0.0.1:3000/getUser ,就能看到 {"email":"qwe@163.com"}
再使用 Robomongo 看看数据库是否真的成功写入了信息,如果成功找到和代码中一样的数据,说明写入成功了~~
OK~至此,我们就实现了一个最基础的服务端读写数据库应用雏形了。
补刀几句,这篇笔记通篇没有多少任何关于概念以及工具的说明。
因为它就是一篇执行记录笔记,记录搭建一个 最基础的服务端读写数据库应用雏形 的各个步骤。
如果要了解上面提到的工具以及代码的含义,请自己另行百度,或者去细看我开篇时给出的文章(里面各种概念说明非常详细)