Mongoose学习参考文档——基础篇

一、快速通道

---

1.1 名词解释

• Schema ： 一种以文件形式存储的数据库模型骨架，不具备数据库的操作能力

• Model ： 由Schema发布生成的模型，具有抽象属性和行为的数据库操作对

• Entity ： 由Model创建的实体，他的操作也会影响数据库

注意：

1.本学习文档采用严格命名方式来区别不同对象，例如：

    var PersonSchema;   //Person的文本属性

    var PersonModel;    //Person的数据库模型

    var PersonEntity;   //Person实体

2.Schema、Model、Entity的关系请牢记，Schema生成Model，Model创造Entity，Model和Entity都可对数据库操作造成影响，但Model比Entity更具操作性。

1.2 准备工作

---

1.首先你必须安装MongoDB和NodeJS

2.在项目只能够创建一个数据库连接，如下:

    var mongoose = require('mongoose');    //引用mongoose模块

    var db = mongoose.createConnection('localhost','test'); //创建一个数据库连接

3.打开本机localhost的test数据库时，我们可以监测是否有异常

    db.on('error',console.error.bind(console,'连接错误:'));

    db.once('open',function(){

      //一次打开记录

    });

注意：

成功开启数据库后，就可以执行数据库相应操作，假设以下代码都在回调中处理

4.定义一个Schema

    var PersonSchema = new mongoose.Schema({

      name:String   //定义一个属性name，类型为String

    });

5.将该Schema发布为Model

    var PersonModel = db.model('Person',PersonSchema);

    //如果该Model已经发布，则可以直接通过名字索引到，如下：

    //var PersonModel = db.model('Person');

    //如果没有发布，上一段代码将会异常

6.用Model创建Entity

    var personEntity = new PersonModel({name:'Krouky'});

    //打印这个实体的名字看看

    console.log(personEntity.name); //Krouky

7.我们甚至可以为此Schema创建方法

    //为Schema模型追加speak方法

    PersonSchema.methos.speak = function(){

      console.log('我的名字叫'+this.name);

    }

    var PersonModel = db.model('Person',PersonSchema);

    var personEntity = new PersonModel({name:'Krouky'});

    personEntity.speak();//我的名字叫Krouky

8.Entity是具有具体的数据库操作CRUD的

    personEntity.save();  //执行完成后，数据库就有该数据了

9.如果要执行查询，需要依赖Model，当然Entity也是可以做到的

    PersonModel.find(function(err,persons){

      //查询到的所有person

    });

注意：

1. 具体的如何配置Schema、Model以及Model和Entity的相关操作，我们会在后面进行

2. Model和Entity都有能影响数据库的操作，但仍有区别，后面我们也会做解释

二、新手指引

---

如果您还不清楚Mongoose是如何工作的，请参看第一章快速通道快速浏览他的用法吧

1. Schema——纯洁的数据库原型

1.1 什么是Schema

• 我理解Schema仅仅只是一断代码，他书写完成后程序依然无法使用，更无法通往数据库端

• 他仅仅只是数据库模型在程序片段中的一种表现，或者是数据属性模型

1.2 如何定义Schema

    var BlogSchema = new Schema({

      title:String,

      author:String

      //new Schema()中传入一个JSON对象，该对象形如 xxx:yyyy ,

      /xxx是一个字符串，定义了属性，yyy是一个Schema.Type，定义了属性类型

    });

1.3 什么是Schema.Type

Schema.Type是由Mongoose内定的一些数据类型，基本数据类型都在其中，他也内置了一些Mongoose特有的Schema.Type。当然，你也可以自定义Schema.Type，只有满足Schema.Type的类型才能定义在Schema内。

1.4 Schema.Types

NodeJS中的基本数据类型都属于Schema.Type，另外Mongoose还定义了自己的类型

    //举例：

    var ExampleSchema = new Schema({

      name:String,

      binary:Buffer,

      living:Boolean,

      updated:Date,

      age:Number,

      mixed:Schema.Types.Mixed, //该混合类型等同于nested

      _id:Schema.Types.ObjectId,  //主键

      _fk:Schema.Types.ObjectId,  //外键

      array:[],

      arrOfString:[String],

      arrOfNumber:[Number],

      arrOfDate:[Date],

      arrOfBuffer:[Buffer],

      arrOfBoolean:[Boolean],

      arrOfMixed:[Schema.Types.Mixed],

      arrOfObjectId:[Schema.Types.ObjectId]

      nested:{

        stuff:String,

      }

    });

1.5 关于Buffer

Buffer和ArrayBuffer是Nodejs两种隐藏的对象，相关内容请查看NodeJS-API

1.6 关于Mixed

Schema.Types.Mixed是Mongoose定义个混合类型，该混合类型如果未定义具体形式。因此,如果定义具体内容，就直接使用{}来定义，以下两句等价

    var AnySchema = new Schema({any:{}});

    var AnySchema = new Schema({any:Schema.Types.Mixed});

混合类型因为没有特定约束，因此可以任意修改，一旦修改了原型，则必须调用markModified()

    person.anything = {x:[3,4,{y:'change'}]}

    person.markModified('anything');//传入anything，表示该属性类型发生变化

    person.save();

1.7 关于ObjectId

主键，一种特殊而且非常重要的类型，每个Schema都会默认配置这个属性，属性名为_id，除非自己定义，方可覆盖

    var mongoose = require('mongoose');

    var ObjectId = mongoose.Schema.Types.ObjectId;

    var StudentSchema = new Schema({}); //默认会有_id:ObjectId

    var TeacherSchema = new Schema({id:ObjectId});//只有id:ObjectId

该类型的值由系统自己生成，从某种意义上几乎不会重复，生成过程比较复杂，有兴趣的朋友可以查看源码。

1.8 关于Array

Array在JavaScript编程语言中并不是数组，而是集合，因此里面可以存入不同的值，以下代码等价：

    var ExampleSchema1 = new Schema({array:[]});

    var ExampleSchema2 = new Schema({array:Array});

    var ExampleSchema3 = new Schema({array:[Schema.Types.Mixed]});

    var ExampleSchema4 = new Schema({array:[{}]});

1.9 附言

Schema不仅定义了文档结构和使用性能，还可以有扩展插件、实例方法、静态方法、复合索引、文档生命周期钩子

Schema可以定义插件，并且插件具有良好的可拔插性，请有兴趣的读者继续往后阅读或者查阅官方资料。

2. Schema的扩展

2.1 实例方法

有的时候，我们创造的Schema不仅要为后面的Model和Entity提供公共的属性，还要提供公共的方法。

下面例子比快速通道的例子更加高级，可以进行高级扩展：

    var PersonSchema = new Schema({name:String,type:String});

    //查询类似数据

    PersonSchema.methods.findSimilarTypes = function(cb){

      return this.model('Person').find({type:this.type},cb);

    }

使用如下：

    var PersonModel = mongoose.model('Person',PersonSchema);

    var krouky = new PersonModel({name:'krouky',type:'前端工程师'});

    krouky.findSimilarTypes(function(err,persons){

      //persons中就能查询到其他前端工程师

    });

2.2 静态方法

静态方法在Model层就能使用，如下：

  PersonSchema.statics.findByName = function(name,cb){

    this.find({name:new RegExp(name,'i'),cb});

  }

  var PersonModel = mongoose.model('Person',PersonSchema);

  PersonModel.findByName('krouky',function(err,persons){

    //找到所有名字叫krouky的人

  });

2.3 索引

索引或者复合索引能让搜索更加高效，默认索引就是主键索引ObjectId，属性名为_id， 索引会作为一个专题来讲解

2.4 虚拟属性

Schema中如果定义了虚拟属性，那么该属性将不写入数据库，例如：

    var PersonSchema = new Schema({

      name:{

        first:String,

        last:String

      }

    });

    var PersonModel = mongoose.model('Person',PersonSchema);

    var krouky = new PersonModel({

      name:{first:'krouky',last:'han'}

    });

如果每次想使用全名就得这样

    console.log(krouky.name.first + ' ' + krouky.name.last);

显然这是很麻烦的，我们可以定义虚拟属性：

    PersonSchema.virtual('name.full').get(function(){

      return this.name.first + ' ' + this.name.last;

    });

那么就能用krouky.name.full来调用全名了，反之如果知道full，也可以反解first和last属性

    PersonSchema.virtual('name.full').set(function(name){

      var split = name.split(' ');

      this.name.first = split[0];

      this.name.last = split[1];

    });

    var PersonModel = mongoose.model('Person',PersonSchema);

    var krouky = new PersonModel({});

    krouky.name.full = 'krouky han';//会被自动分解

    console.log(krouky.name.first);//krouky

2.5 配置项

在使用new Schema(config)时，我们可以追加一个参数options来配置Schema的配置，形如：

    var ExampleSchema = new Schema(config,options);

或者使用

    var ExampleSchema = new Schema(config);

    ExampleSchema.set(option,value);

可供配置项有：safe、strict、capped、versionKey、autoIndex

2.5.1 safe——安全属性（默认安全）

一般可做如下配置：

    new Schema({...},{safe:true});

当然我们也可以这样

    new Schema({...},{safe:{j:1,w:2,wtimeout:10000}});

j表示做1份日志，w表示做2个副本（尚不明确），超时时间10秒

2.5.2 strict——严格配置（默认启用）

确保Entity的值存入数据库前会被自动验证，如果你没有充足的理由，请不要停用，例子：

    var ThingSchema = new Schema({a:String});

    var ThingModel = db.model('Thing',SchemaSchema);

    var thing = new Thing({iAmNotInTheThingSchema:true});

    thing.save();//iAmNotInTheThingSchema这个属性将无法被存储

如果取消严格选项，iAmNotInTheThingSchema将会被存入数据库

该选项也可以在构造实例时使用，例如：

    var ThingModel = db.model('Thing');

    var thing1 = new ThingModel(doc,true);  //启用严格

    var thing2 = new ThingModel(doc,false); //禁用严格

注意：

strict也可以设置为throw，表示出现问题将会抛出错误

2.5.3 shardKey

需要mongodb做分布式，才会使用该属性

2.5.4 capped——上限设置

如果有数据库的批量操作，该属性能限制一次操作的量，例如：

    new Schema({...},{capped:1024});  //一次操作上线1024条数据

当然该参数也可是JSON对象，包含size、max、autiIndexId属性

    new Schema({...},{capped:{size:1024,max:100,autoIndexId:true}});

2.5.5 versionKey——版本锁

版本锁是Mongoose默认配置（__v属性）的，如果你想自己定制，如下：

    new Schema({...},{versionKey:'__someElse'});

此时存入数据库的版本锁就不是__v属性，而是__someElse，相当于是给版本锁取名字。

具体怎么存入都是由Mongoose和MongoDB自己决定，当然，这个属性你也可以去除

  new Schema({...},{versionKey:false});

除非你知道你在做什么，并且你知道这样做的后果

2.5.6 autoIndex——自动索引

该内容将在索引章节单独讲解

3. Documents

Document是与MongoDB文档一一对应的模型，Document可等同于Entity，具有属性和操作性

注意：

Document的`CRUD都必须经过严格验证的，参看2.5.2 Schema的strict严格配置

3.1 查询

查询内容过多，专题讲解

3.2 更新

有许多方式来更新文件，以下是常用的传统方式：

    PersonModel.findById(id,function(err,person){

      person.name = 'MDragon';

      person.save(function(err){});

    });

这里，利用Model模型查询到了person对象，该对象属于Entity，可以有save操作，如果使用Model`操作，需注意：

    PersonModel.findById(id,function(err,person){

      person.name = 'MDragon';

      var _id = person._id; //需要取出主键_id

      delete person._id;    //再将其删除

      PersonModel.update({_id:_id},person,function(err){});

      //此时才能用Model操作，否则报错

    });

update第一个参数是查询条件，第二个参数是更新的对象，但不能更新主键，这就是为什么要删除主键的原因。

当然这样的更新很麻烦，可以使用$set属性来配置，这样也不用先查询，如果更新的数据比较少，可用性还是很好的：

    PersonModel.update({_id:_id},{$set:{name:'MDragon'}},function(err){});

需要注意，Document的CRUD操作都是异步执行，callback第一个参数必须是err，而第二个参数各个方法不一样，update的callback第二个参数是更新的数量，如果要返回更新后的对象，则要使用如下方法

    Person.findByIdAndUpdate(_id,{$set:{name:'MDragon'}},function(err,person){

      console.log(person.name); //MDragon

    });

类似的方法还有findByIdAndRemove，如同名字，只能根据id查询并作update/remove操作，操作的数据仅一条

3.3 新增

如果是Entity，使用save方法，如果是Model，使用create方法

    //使用Entity来增加一条数据

    var krouky = new PersonModel({name:'krouky'});

    krouky.save(callback);

    //使用Model来增加一条数据

    var MDragon = {name:'MDragon'};

    PersonModel.create(MDragon,callback);

两种新增方法区别在于，如果使用Model新增时，传入的对象只能是纯净的JSON对象，不能是由Model创建的实体，原因是：由Model创建的实体krouky虽然打印是只有{name:'krouky'}，但是krouky属于Entity，包含有Schema属性和Model数据库行为模型。如果是使用Model创建的对象，传入时一定会将隐藏属性也存入数据库，虽然3.x追加了默认严格属性，但也不必要增加操作的报错

3.4 删除

和新增一样，删除也有2种方式，但Entity和Model都使用remove方法

4.Sub Docs

如同SQL数据库中2张表有主外关系，Mongoose将2个Document的嵌套叫做Sub-Docs（子文档）

简单的说就是一个Document嵌套另外一个Document或者Documents:

    var ChildSchema1 = new Schema({name:String});

    var ChildSchema2 = new Schema({name:String});

    var ParentSchema = new Schema({

      children1:ChildSchema1,   //嵌套Document

      children2:[ChildSchema2]  //嵌套Documents

    });

Sub-Docs享受和Documents一样的操作，但是Sub-Docs的操作都由父类去执行

    var ParentModel = db.model('Parent',parentSchema);

    var parent = new ParentModel({

      children2:[{name:'c1'},{name:'c2'}]

    });

    parent.children2[0].name = 'd';

    parent.save(callback);

parent在执行保存时，由于包含children2，他是一个数据库模型对象，因此会先保存chilren2[0]和chilren2[1]。

如果子文档在更新时出现错误，将直接报在父类文档中，可以这样处理：

    ChildrenSchema.pre('save',function(next){

      if('x' === this.name) return next(new Error('#err:not-x'));

      next();

    });

    var parent = new ParentModel({children1:{name:'not-x'}});

    parent.save(function(err){

      console.log(err.message); //#err:not-x

    });

4.1 查询子文档

如果children是parent的子文档，可以通过如下方法查询到children

    var child = parent.children.id(id);

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数Android工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Android移动开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且后续会持续更新

如果你觉得这些内容对你有帮助，可以添加V获取：vip204888 （备注Android）

文末

不管怎么样，不论是什么样的大小面试，要想不被面试官虐的不要不要的，只有刷爆面试题题做好全面的准备，当然除了这个还需要在平时把自己的基础打扎实，这样不论面试官怎么样一个知识点里往死里凿，你也能应付如流啊

小编将自己6年以来的面试经验和学习笔记都整理成了一个**937页的PDF，**以及我学习进阶过程中看过的一些优质视频教程。

其实看到身边很多朋友抱怨自己的工资很低，包括笔者也是一样的，其原因是在面试过程中没有给面试官一个很好的答案。所以笔者会持续更新面试过程中遇到的问题，也希望大家和笔者一起进步，一起学习。

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

不知道该从何学起的朋友，同时减轻大家的负担。**
[外链图片转存中…(img-reUdIeHh-1712860768737)]
[外链图片转存中…(img-VZCZ9kEd-1712860768738)]
[外链图片转存中…(img-xZw0dMjK-1712860768738)]
[外链图片转存中…(img-hw2Xx9Am-1712860768738)]
[外链图片转存中…(img-zSh9ynAq-1712860768739)]
[外链图片转存中…(img-pMGM30I8-1712860768739)]

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且后续会持续更新

如果你觉得这些内容对你有帮助，可以添加V获取：vip204888 （备注Android）
[外链图片转存中…(img-nbFbf3Io-1712860768739)]

文末

不管怎么样，不论是什么样的大小面试，要想不被面试官虐的不要不要的，只有刷爆面试题题做好全面的准备，当然除了这个还需要在平时把自己的基础打扎实，这样不论面试官怎么样一个知识点里往死里凿，你也能应付如流啊

小编将自己6年以来的面试经验和学习笔记都整理成了一个**937页的PDF，**以及我学习进阶过程中看过的一些优质视频教程。

[外链图片转存中…(img-pSWMfLt5-1712860768739)]

其实看到身边很多朋友抱怨自己的工资很低，包括笔者也是一样的，其原因是在面试过程中没有给面试官一个很好的答案。所以笔者会持续更新面试过程中遇到的问题，也希望大家和笔者一起进步，一起学习。

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！
[外链图片转存中…(img-7pnFv8GD-1712860768740)]