mongose学习--Schema、model

·　　前言

　　Mongoose是MongoDB的一个对象模型工具，基于node-mongodb-native开发。

　　初学node.js，之前看了一些博客，决定还是自己从官方文档入手学习Mongoose，所以本文内容一部分是官方文档的翻译内容。留作笔记之用，有所侧重，不会大而全。而且随着理解加深会不断充实本文内容。

 

　　环境说明

　　本文实践是在win10下的mongoDB+Node.js+webstorm的环境上进行的。

 

　　connect

　　数据库连接大同小异，以下是官网示例

mongoose.connect('mongodb://user:pass@localhost:port/database');

// replica sets
var uri = 'mongodb://user:pass@localhost:port,anotherhost:port,yetanother:port/mydatabase';
mongoose.connect(uri);

// with options
mongoose.connect(uri, options);

// connecting to multiple mongos
var uri = 'mongodb://hostA:27501,hostB:27501';
var opts = { mongos: true };
mongoose.connect(uri, opts);

// optional callback that gets fired when initial connection completed
var uri = 'mongodb://nonexistent.domain:27000';
mongoose.connect(uri, function(error) {
  // if error is truthy, the initial connection failed.
})

 

　　以下代码是本文连接数据库的方法：

var mongoose = require('mongoose');
var Schema = mongoose.Schema;

mongoose.connect('mongodb://localhost/test');
var db = mongoose.connection;
db.on('error', console.error.bind(console, 'connection error:'));
db.once('open', function() {
    console.log('connected');
});

 

　　Schema

　　在Mongoose里一切都是从Schema开始的，每一个Schema都会映射到MongoDB的一个collection上。Schema定义了collection里documents的模板（或者说是框架）。

　　如下代码定义了一个博客的Schema：

var blogSchema = new Schema({ // Schema头字母大写，因为Schema是构造函数
  title:  String,
  author: String,
  body:   String,
  comments: [{ body: String, date: Date }], // 对象数组
  date: { type: Date, default: Date.now }, // 通过default设置默认值
  hidden: Boolean,
  meta: { // 嵌套对象
    votes: Number,
    favs:  Number
  }
});

　　如果想对已经定义好的blogSchema添加键，可以用如下方法：

blogSchema.add({reprints : Number});

　　Schema支持的键值类型有String，Number，Date，Buffer，Boolean，Array，Objectld，Mixed。Schema不仅定义document的模板，而且可以定义document的实例方法。

　　_id

　　在MongoDB中同一个collection里的文档都必有且唯一的“id”键用于唯一标识document，键值可为任意类型默认是ObjectId对象。ObjectId的设计初衷是为了分布式，所以不像传统方法默认增加主键。这是一种轻量型设计，不同的机器可以用全局唯一的方法生成。ObjectId存储空间是12字节，前四个字节是标准纪元时间戳（单位为秒），隐含该document的创建时间（由于大致是按时间顺序存储，故使用id作为索引的效率会很高）。后三个字节是主机唯一标志符，通常是主机名的散列值。接着后两个字节是进程标识，最后三个字节是自动增加的计数器，确保同一秒内同一主机同一进程的ObjectId是唯一的。以上的生成document的id过程都是客户端完成的，用以减轻服务器的开销。

　　index

　　我们在定义Schema的时候可以定义其索引，一般是多重索引。

　　以下代码是添加索引：

blogSchema.index({blogTitle : 1, reprints : -1});

　　这样就建立了以blogTitel为正序，reprints为逆序的多重索引。

 

　　 model

　　为了使用定义好的Schema，我们需要把blogSchema转换成我们可以使用的model(其实是把Schema编译成model，所以对于Schema的一切定义都要在compile之前完成)。也就是说model才是我们可以进行操作的handle。

　　以下代码是编译model的方法：

var Blog = mongoose.model('Blog', blogSchema);

　　这样我们就获得了一个名为Blog的model了。生成model的同时MongoDB中对应的collection也被建立了，model的名字是Blog，而collection的名字被默认是model名字的复数也就是blogs（细心的小伙伴会发现不止变复数了，而且字母全部变小写了，亲测是这样的）。

　　官网中有关model()函数的用法如下：

Connection#model(name, [schema], [collection])
Defines or retrieves a model.

Parameters:
name <String> the model name
[schema] <Schema> a schema. necessary when defining a model

[collection] <String> name of mongodb collection (optional) if not given it will be induced from model name

Returns:
<Model> The compiled model

 

　　以下代码是通过model生成document，以及document保存的方法：

var blog01 = new Blog({
    blogTitle : 'The total eclipse of hreat',
    body : '........',
    comments : [{body : "That's awesome", date : new Date()}],
    hidden : false,
    state : {
        favors : 999,
        marks : 999
    }
});
blog01.save(function(err){
    if (err){
        return console.error(err);
    }
    console.log('saved');
})

　　真正跑过以上代码就会发现MongoDB的容错性很好，以上代码其实在生成document时漏了一个键reprints赋值，但还是可以保存，而且在查询该条document时reprints这个字段是不会显示的。另外如果在生成document时，我们把键值的名字写错了，MongoDB还是可以忽略被输错的键的，把正确键对应的值存起来，忽略错误键名。

　　而且在id上，除了document有id，comments对应的对象数组也会有唯一id，如下图：

　　

　　Schema和model的理解

　　不同于关系型数据库，MongoDB作为文档型数据库，Scheme、model、collection、document是其中的四大元素。document是MongoDB里的基本存储单位，collection是众多同类document的集合。Schema定义了一类document的模板，让这一类document在数据库中有一个具体的构成、存储模式。而Schema仅仅是定义了Document是什么样子的，至于生成document和对document进行各种操作（增删改查）则是通过相对应的model来进行的。

　　需要说明的是MongoDB中实际上只有collection和document，Schema和model不过是定义和生成前二者过程中的工具而已。

 

　　总结

　　本文忽略了有关methods的介绍和connection与model之间的切换，主要是自己没完全搞清楚，搞清楚了会加上

　　以下代码是全文代码汇总：

var mongoose = require('mongoose');
mongoose.connect('mongodb://localhost/test');
var db = mongoose.connection;
db.on('error', console.error.bind(console, 'connection error:'));
db.once('open', function() {
    console.log('connected');
});
var Schema = mongoose.Schema;
var blogSchema = Schema
({
    blogTitle : String,
    body : String,
    comments : [{body : String, date : Date}],
    hidden : Boolean,
    state : {
        favors : Number,
        marks : Number
    }
});
blogSchema.add({reprints : Number});
blogSchema.index({blogTitel : 1, reprints : -1});
var Blog = mongoose.model('Blog', blogSchema);
var blog01 = new Blog({
    blogTitle : 'The total eclipse of hreat',
    body : '........',
    comments : [{body : "That's awesome", date : new Date()}],
    hidden : false,
    state : {
        favors : 999,
        marks : 999
    },
    reprints : 999
});
blog01.save(function(err){
    if (err){
        return console.error(err);
    }
    console.log('saved');
});

mongoose.connection.close();