Mongoose學(xué)習(xí)全面理解(推薦)
一、創(chuàng)建schemas
創(chuàng)建schemas的方式:
var userSchema = new mongoose.Schema({
name: String,
email: String,
createdOn: Date
});
schemas中的數(shù)據(jù)類型有以下幾種:
- String
- Number
- Date
- Boolean
- Buffer
- ObjectId
- Mixed
- Array
特別需要說(shuō)明一下ObjectId類型和Mixed類型以及Array類型,在schemas中聲明這幾種類型的方式如下:
//ObjectId就類似于唯一鍵值
projectSchema.add({
owner: mongoose.Schema.Types.ObjectId
});
//混合類型,顧名思義,就是說(shuō)里面可以放置任意類型的數(shù)據(jù),有兩種方式創(chuàng)建該類型數(shù)據(jù)
//方式一:直接賦予一個(gè)空的字面量對(duì)象
vardjSchema= new mongoose.Schema({
mixedUp: {}
});
//方式二:根據(jù)Schemas.Types中值來(lái)賦予
vardjSchema= new mongoose.Schema({
mixedUp: Schema.Types.Mixed
});
//Array類型數(shù)據(jù)有兩種創(chuàng)建方式,一種是簡(jiǎn)單數(shù)組創(chuàng)建:
var userSchema = new mongoose.Schema({
name: String,
emailAddresses: [String]
});
//第二種方式就是復(fù)雜類型數(shù)據(jù)數(shù)組,例如我們可以再數(shù)組中添加不同類型的schemas:
var emailSchema = new mongoose.Schema({
email: String,
verified: Boolean
});
var userSchema = new mongoose.Schema({
name: String,
emailAddresses: [emailSchema]
});
//注意:如果定義一個(gè)空的數(shù)據(jù)的話,則會(huì)創(chuàng)建為一個(gè)混合類型數(shù)據(jù)的數(shù)組:
var emailSchema = new mongoose.Schema({
email: String,
verified: Boolean
});
var userSchema = new mongoose.Schema({
name: String,
emailAddresses: [emailSchema]
});
我們可以給schema創(chuàng)建靜態(tài)方法,這個(gè)靜態(tài)方法將來(lái)會(huì)用在Model中,創(chuàng)建該靜態(tài)方法需要在創(chuàng)建完成schema之后,在Model編譯之前:
projectSchema.statics.findByUserID = function (userid, callback) {
this.find({ createdBy: userid }, '_id projectName', {sort: 'modifiedOn'}, callback);
};
在其對(duì)應(yīng)的模型創(chuàng)建完成并編譯后,我們就可以像下面這樣來(lái)調(diào)用該靜態(tài)方法了:
Model.findByUserID(userid,callback);
該靜態(tài)方法會(huì)返回一個(gè)JSON格式的數(shù)據(jù),這在我們使用AJAX技術(shù)來(lái)加載網(wǎng)頁(yè)數(shù)據(jù)的時(shí)候會(huì)比較方便,就像下面這樣:
//路由規(guī)則:app.get('/project/byuser/:userid', project.byUser);
exports.byUser = function (req, res) {
console.log("Getting user projects");
if (req.params.userid){
Project.findByUserID(req.params.userid,function (err, projects) {
if(!err){
console.log(projects);
res.json(projects);
}else{
console.log(err);
res.json({"status":"error", "error":"Error finding projects"});
}
});
}else{
console.log("No user id supplied");
res.json({"status":"error", "error":"No user id supplied"});
}
};
二、創(chuàng)建Model
創(chuàng)建Model很簡(jiǎn)單:
Mongoose.Model('User', userSchema);
參數(shù)一為Model的名字,參數(shù)二為生成Model所需要的schema,Model就像是schema所編譯而成的一樣。
mongoose連接數(shù)據(jù)庫(kù)是有兩種方式的:
//方式一:
var dbURI = 'mongodb://localhost/mydatabase';
mongoose.connect(dbURI);
//方式二:
var dbURI = 'mongodb://localhost/myadmindatabase';
var adminConnection = mongoose.createConnection(dbURI);
//如果需要聲明端口號(hào):
var dbURI = 'mongodb://localhost:27018/mydatabase';
//如果需要定義用戶名和密碼:
var dbURI = 'mongodb://username:password@localhost/mydatabase';
//也可以像下面這樣傳一個(gè)對(duì)象類型的參數(shù):
var dbURI = 'mongodb://localhost/mydatabase';
var dbOptions = {'user':'db_username','pass':'db_password'};
mongoose.connect(dbURI, dbOptions);
根據(jù)連接數(shù)據(jù)庫(kù)的方式,我們可以得到第二種創(chuàng)建Model的方式,就是使用數(shù)據(jù)庫(kù)連接的引用名來(lái)創(chuàng)建:
adminConnection.model( 'User', userSchema );
默認(rèn)情況下mongoose會(huì)根據(jù)我們傳入的Model名字來(lái)生成collection名字,在上面的代碼中就會(huì)生成名為users(全為小寫(xiě)字母)的collection(集合);
有兩種方法能讓我們自定義collection的名字。
//方式一,在創(chuàng)建schema的時(shí)候定義collection的名字:
var userSchema = new mongoose.Schema({
name: String,
email: {type: String, unique:true}
},
{
collection: 'myuserlist'
});
//方式二,在創(chuàng)建Model的時(shí)候定義collection的名字:
mongoose.model( 'User', userSchema, 'myuserlist' );
創(chuàng)建Model實(shí)例:
var user = new User({ name: 'Simon' });
user就是模型User的一個(gè)實(shí)例,它具有mongoose中模型所具有的一些方法,例如保存實(shí)例:
user.save(function (err) {
if (err) return handleError(err);
});
模型也具有一些常用的增刪查改的方法:
User.findOne({'name' : 'Sally', function(err,user) {
if(!err){
console.log(user);
}
});
User.find({}, function(err, users) {
if(!err){
console.log(users);
}
});
可以使用鏈?zhǔn)椒绞绞褂眠@些方法,例如:
var newUser = new User({
name: 'Simon Holmes',
email: 'simon@theholmesoffice.com',
lastLogin : Date.now()
}).save( function( err ){
if(!err){
console.log('User saved!');
}
});
上面的代碼創(chuàng)建了一個(gè)模型實(shí)例,然后進(jìn)行保存。我們有一個(gè)更為簡(jiǎn)介的方式來(lái)完成這項(xiàng)工作,就是使用Model.create()方法:
User.create({
name: 'Simon Holmes',
email: 'simon@theholmesoffice.com',
lastLogin : Date.now()
}, function( err, user ){
if(!err){
console.log('User saved!');
console.log('Saved user name: ' + user.name);
console.log('_id of saved user: ' + user._id);
}
});
三、查找數(shù)據(jù)和讀取數(shù)據(jù)的方法
1.使用QueryBuilder接口來(lái)查找數(shù)據(jù)
先看看下面的代碼:
var myQuery = User.find({'name' : 'Simon Holmes'});
myQuery.where('age').gt(18);
myQuery.sort('-lastLogin');
myQuery.select('_id name email');
myQuery.exec(function (err, users){
if (!err){
console.log(users); // output array of users found
}
});
代碼中,我們查找名字為"Simon Holmes",并且年齡大于18歲,查找結(jié)果根據(jù)lastLogin降序排列,只獲取其中的_id, name, email三個(gè)字段的值,上面的代碼只有在調(diào)用exec方法后才真正執(zhí)行數(shù)據(jù)庫(kù)的查詢。
當(dāng)然我們可以使用鏈?zhǔn)降姆绞絹?lái)改寫(xiě)上面的代碼,代碼會(huì)更加簡(jiǎn)潔:
User.find({'name' : 'Simon Holmes'})
.where('age').gt(18)
.sort('-lastLogin')
.select('_id name email')
.exec(function (err, users){
if (!err){
console.log(users); // output array of users found
}
});
上面代碼中的第一行創(chuàng)建了一個(gè)queryBuilder.通過(guò)使用這個(gè)queryBuilder,我們就可以執(zhí)行一些比較復(fù)雜的查找工作,在創(chuàng)建完成這個(gè)queryBuilder之后,查詢操作并沒(méi)有馬上執(zhí)行,而是待到執(zhí)行exec方法時(shí)才會(huì)去執(zhí)行數(shù)據(jù)庫(kù)的查找。
當(dāng)然也有另外一種方式能夠直接查找數(shù)據(jù)庫(kù)的,就是直接在查找方法中添加回調(diào)函數(shù),使用方式為:
Model.find(conditions, [fields], [options], [callback])
下面舉一個(gè)簡(jiǎn)單例子:
User.find({'name', 'simon holmes'}, function(err, user) {});
另一個(gè)稍微復(fù)雜的例子:
User.find({'name', 'simon holmes'}, 'name email',function(err, user) {
//console.log('some thing');
});
另一個(gè)更加復(fù)雜的例子,包含查詢結(jié)果的排序:
User.find({'name' : 'Simon Holmes'},
null, // 如果使用null,則會(huì)返回所有的字段值
{sort : {lastLogin : -1}}, // 降序排序
function (err, users){
if (!err){console.log(users);}
});
列舉幾個(gè)比較實(shí)用的查找方法:
Model.find(query); Model.findOne(query);//返回查找到的所有實(shí)例的第一個(gè) Model.findById(ObjectID);//根據(jù)ObjectId查找到唯一實(shí)例
例如:
User.findOne({'email' : req.body.Email},
'_id name email',
function(err, user) {
//todo
});
2.更新數(shù)據(jù)
有三種方式來(lái)更新數(shù)據(jù):
(1)update(conditions,update,options,callback);
該方法會(huì)匹配到所查找的內(nèi)容進(jìn)行更新,不會(huì)返回?cái)?shù)據(jù);
(2)findOneAndUpdate(conditions,update,options,callback);
該方法會(huì)根據(jù)查找去更新數(shù)據(jù)庫(kù),另外也會(huì)返回查找到的并未改變的數(shù)據(jù);
(3)findByIdAndUpdate(conditions,update,options,callback);
該方法跟上面的findOneAndUpdate方法功能一樣,不過(guò)他是根據(jù)ID來(lái)查找文檔并更新的。
三個(gè)方法都包含四個(gè)參數(shù),一下稍微說(shuō)明一下幾個(gè)參數(shù)的意思:
- conditions:查詢條件
- update:更新的數(shù)據(jù)對(duì)象,是一個(gè)包含鍵值對(duì)的對(duì)象
- options:是一個(gè)聲明操作類型的選項(xiàng),這個(gè)參數(shù)在下面再詳細(xì)介紹
- callback:回調(diào)函數(shù)
對(duì)于options參數(shù),在update方法中和findOneAndUpdate、findByIdAndUpdate兩個(gè)方法中的可選設(shè)置是不同的;
//在update方法中,options的可選設(shè)置為:
{
safe:true|false, //聲明是否返回錯(cuò)誤信息,默認(rèn)true
upsert:false|true, //聲明如果查詢不到需要更新的數(shù)據(jù)項(xiàng),是否需要新插入一條記錄,默認(rèn)false
multi:false|true, //聲明是否可以同時(shí)更新多條記錄,默認(rèn)false
strict:true|false //聲明更新的數(shù)據(jù)中是否可以包含在schema定義之外的字段數(shù)據(jù),默認(rèn)true
}
//對(duì)于findOneAndUpdate、findByIdAndUpdate這兩個(gè)方法,他們的options可選設(shè)置項(xiàng)為:
{
new:true|false, //聲明返回的數(shù)據(jù)時(shí)更新后的該是更新前的,如果為true則返回更新后的,默認(rèn)true
upsert:false|trure,
sort:javascriptObject, //如果查詢返回多個(gè)文檔記錄,則可以進(jìn)行排序,在這里是根據(jù)傳入的javascript object對(duì)象進(jìn)行排序
select:String //這里聲明要返回的字段,值是一個(gè)字符串
}
下面舉個(gè)例子:
User.update({_id:user._id},{$set: {lastLogin: Date.now()}},function(){});
3.數(shù)據(jù)刪除
跟更新數(shù)據(jù)一樣,也有三種方法給我們刪除數(shù)據(jù):
remove(); findOneAndRemove(); findByIdAndRemove();
remove方法有兩種使用方式,一種是用在模型上,另一種是用在模型實(shí)例上,例如:
User.remove({ name : /Simon/ } , function (err){
if (!err){
// 刪除名字中包含simon的所有用戶
}
});
User.findOne({ email : 'simon@theholmesoffice.com'},function (err,user){
if (!err){
user.remove( function(err){
// 刪除匹配到該郵箱的第一個(gè)用戶
});
}
});
接下來(lái)看一下findOneAndRemove方法:
User.findOneAndRemove({name : /Simon/},{sort : 'lastLogin', select : 'name email'},function (err, user){
if (!err) {
console.log(user.name + " removed");
// Simon Holmes removed
};
});
另外一個(gè)findByIdAndRemove方法則是如出一轍的。
User.findByIdAndRemove(req.body._id,function (err, user) {
if(err){
console.log(err);
return;
}
console.log("User deleted:", user);
});
四、數(shù)據(jù)驗(yàn)證
1.mongoose內(nèi)置數(shù)據(jù)驗(yàn)證
在mongoose中,數(shù)據(jù)驗(yàn)證這一層是放在schema中的,mongoose已經(jīng)幫我們做了很多內(nèi)置的數(shù)據(jù)驗(yàn)證,有一些驗(yàn)證是針對(duì)某些數(shù)據(jù)類型的,也有一些是針對(duì)所有數(shù)據(jù)類型的。
能夠作用在所有數(shù)據(jù)類型上的驗(yàn)證有require,意思就是該字段是否是必須的,例如:
email: { type: String, unique: true, required: true }
上面的代碼就定義了一個(gè)email是必須的schema.
下面再分別介紹一下mongoose內(nèi)置的一些數(shù)據(jù)驗(yàn)證類型。
數(shù)字類型schemasType,對(duì)于Number類型的數(shù)據(jù),具有min,max提供用來(lái)界定最大最小值:
var teenSchema = new Schema({
age : {type: Number, min: 13, max:19}
});
字符串類型SchemasType,對(duì)于該類型數(shù)據(jù),mongoose提供了兩種驗(yàn)證器:
- match:可使用正則表達(dá)式來(lái)匹配字符串是否符合該正則表達(dá)式的規(guī)則
- enum:枚舉出字符串可使用的一些值
分別舉例如下:
var weekdaySchema = new Schema({
day : {type: String, match: /^(mon|tues|wednes|thurs|fri)day$/i}
});
var weekdays = ['monday', 'tuesday', 'wednesday', 'thursday','friday'];
var weekdaySchema = new Schema({
day : {type: String, enum: weekdays}
});
在我們進(jìn)行一些數(shù)據(jù)庫(kù)的時(shí)候,如果有錯(cuò)誤,可能會(huì)返回一些錯(cuò)誤信息,這些信息封裝在一個(gè)對(duì)象中,該對(duì)象的數(shù)據(jù)格式大致如下:
{
message: 'Validation failed',
name: 'ValidationError',
errors:{
email:{
message: 'Validator "required" failed for path email',
name: 'ValidatorError',
path: 'email',
type: 'required'
},
name:{
message: 'Validator "required" failed for path name',
name: 'ValidatorError',
path: 'name',
type: 'required'
}
}
}
知道該錯(cuò)誤信息的具體格式之后,我們可以從中得出我們想要的信息并反饋到控制臺(tái)。
if(err){
Object.keys(err.errors).forEach(function(key) {
var message = err.errors[key].message;
console.log('Validation error for "%s": %s', key, message);
});
}
2.自定義數(shù)據(jù)驗(yàn)證
最簡(jiǎn)單的自定義數(shù)據(jù)驗(yàn)證方式就是定義一個(gè)數(shù)據(jù)驗(yàn)證的函數(shù),并將它傳遞給schema;
var lengthValidator = function(val) {
if (val && val.length >= 5){
return true;
}
return false;
};
//usage:
name: {type: String, required: true, validate: lengthValidator }
可以看到,我們只需要在schema中添加validate鍵值對(duì)即可,validate對(duì)應(yīng)的值便是我們自定義的驗(yàn)證方法;
但是該形式的數(shù)據(jù)驗(yàn)證無(wú)法給我們提供完整的錯(cuò)誤信息,比如errors信息中返回的type值就會(huì)成為undefined;
在此基礎(chǔ)上如果希望錯(cuò)誤信息中能返回一個(gè)錯(cuò)誤描述,那我們可以稍微進(jìn)行一點(diǎn)修改:
//code 1
validate: { validator: lengthValidator, msg: 'Too short' }
//code 2
var weekdaySchema = new Schema({
day : {type: String, validate: {validator:/^(mon|tues|wednes|thurs|fri)day$/i, msg: 'Not a day' }
});
將validate的值修改為一個(gè)對(duì)象,并且該對(duì)象包含驗(yàn)證器和錯(cuò)誤描述。
我們也可以使用另一種方式在寫(xiě)這些驗(yàn)證器,就是將驗(yàn)證器卸載schema外部,例如:
var validateLength = [lengthValidator, 'Too short' ];
var validateDay = [/^(mon|tues|wednes|thurs|fri)day$/i, 'Not a day' ];
//usage:
name: {type: String, required: true, validate: validateLength }
day : {type: String, validate: validateDay }
眼睛放大,一看再看,確實(shí)沒(méi)錯(cuò),在validate中我們傳入的是一個(gè)數(shù)組了,而不是原來(lái)的對(duì)象了。
其實(shí)就validateLength這個(gè)東東來(lái)說(shuō),他就是一個(gè)簡(jiǎn)寫(xiě)來(lái)的,你也可以改成下面這樣:
var validateLength = [
{validator: lengthValidator, msg: 'Too short'}
];
恩,到這里,應(yīng)該能明白了,將對(duì)象改為數(shù)組之后,我們便可以傳遞多個(gè)驗(yàn)證器給我們的schema了,的確如此。
var validateUsername = [
{validator: lengthValidator, msg: 'Too short'} ,
{validator: /^[a-z]+$/i, msg: 'Letters only'}
];
我們還有另外一種方法給我們的schema提供驗(yàn)證器:
userSchema.path('name').validate(lengthValidator, 'Too short');
userSchema.path('name').validate(/^[a-z]+$/i, 'Letters only');
以上就是本文的全部?jī)?nèi)容,希望對(duì)大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
- Node.js中使用mongoose操作mongodb數(shù)據(jù)庫(kù)的方法
- 詳解Nodejs基于mongoose模塊的增刪改查的操作
- 利用Mongoose讓JSON數(shù)據(jù)直接插入或更新到MongoDB
- Mongodb 數(shù)據(jù)類型及Mongoose常用CURD
- MongoDB用Mongoose得到的對(duì)象不能增加屬性完美解決方法(兩種)
- Node.js的MongoDB驅(qū)動(dòng)Mongoose基本使用教程
- Mongoose實(shí)現(xiàn)虛擬字段查詢的方法詳解
- 詳解Nodejs mongoose
- Vue+Node實(shí)現(xiàn)商品列表的分頁(yè)、排序、篩選,添加購(gòu)物車(chē)功能詳解
- 用vue和node寫(xiě)的簡(jiǎn)易購(gòu)物車(chē)實(shí)現(xiàn)
- node.js使用mongoose操作數(shù)據(jù)庫(kù)實(shí)現(xiàn)購(gòu)物車(chē)的增、刪、改、查功能示例
相關(guān)文章
nodejs服務(wù)內(nèi)存泄露排查過(guò)程和優(yōu)化方法
在開(kāi)發(fā)和部署Node.js應(yīng)用程序時(shí),內(nèi)存泄露是一個(gè)常見(jiàn)的挑戰(zhàn),本文將探討如何對(duì)于一個(gè)陌生項(xiàng)目進(jìn)行內(nèi)存排查和優(yōu)化的方法,文章通過(guò)圖文介紹的非常詳細(xì),需要的朋友可以參考下2023-11-11
node.js事件循環(huán)機(jī)制及與js區(qū)別詳解
這篇文章主要為大家介紹了node.js事件循環(huán)機(jī)制及與js區(qū)別詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-09-09
NodeJS服務(wù)器實(shí)現(xiàn)gzip壓縮的示例代碼
這篇文章主要介紹了NodeJS服務(wù)器實(shí)現(xiàn)gzip壓縮的示例代碼,小編覺(jué)得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2018-10-10
淺談Node.js 子進(jìn)程與應(yīng)用場(chǎng)景
這篇文章主要介紹了淺談Node.js 子進(jìn)程與應(yīng)用場(chǎng)景,小編覺(jué)得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2018-01-01
Node.js API詳解之 querystring用法實(shí)例分析
這篇文章主要介紹了Node.js API詳解之 querystring用法,結(jié)合實(shí)例形式分析了Node.js API中querystring的基本功能、用法及相關(guān)操作注意事項(xiàng),需要的朋友可以參考下2020-04-04
node中npm ERR! network ‘proxy‘ 配置問(wèn)題解決
在進(jìn)行npm依賴管理時(shí),可能會(huì)遇到因網(wǎng)絡(luò)配置不當(dāng)導(dǎo)致的錯(cuò)誤,如npm ERR! network proxy config is set properly,下面就來(lái)介紹一下,感興趣的可以了解一下2024-09-09

