数据库

云开发提供的三个基本功能：

1. 数据库

2. 云函数

3. 存储

本章，着重讲解云开发的数据操作。

云开发提供的是一个json数据库，该数据库可以拥有多个集合，每个集合相当于一个json数组

每个json数组是由多个json对象组成。

例如：

    一个存放图书信息的 bookes 集合
    
    [
        {
            "_id":"book_1",
            "_openid":"cVdkjaskjdfVdfjask678",
            "author":"Joh",
             characters: [
              'Holden Caulfield',
              'Stradlater',
              'Mr. Antolini'
            ],
            publishInfo: {
              year: 1951,
              country: 'United States'
            }
        },
        {
            "_id":"book_2",
            "_openid":"cVdkjas34kjdfVdfjask678",
            "author":"Joh",
             characters: [
              'Holden Caulfield',
              'Stradlater',
              'Mr. Antolini'
            ],
            publishInfo: {
              year: 1951,
              country: 'United States'
            }
        },
        {
            "_id":"book_3",
            "_openid":"cVdkjaskjdf443Vdfjask678",
            "author":"Joh",
             characters: [
              'Holden Caulfield',
              'Stradlater',
              'Mr. Antolini'
            ],
            publishInfo: {
              year: 1951,
              country: 'United States'
            }
        }
        
    ]
    
在其中我们可以看到，字段既可以是字符串或数字，还可以是对象或数组，就是一个JSON对象。 

如何操作数据库

数据库 API 分为小程序端和服务端两部分，小程序端API拥有严格的调用权限控制，开发者可

在小程序内直接调用API进行非敏感数据的操作。对于有更高安全要求的数据，可在云函数内通

过服务端 API 进行操作。云函数的环境是与客户端完全隔离的，在云函数上可以私密且安全的

操作数据库。

数据库 API 包含增删改查的能力，使用API操作数据库只需三步：

    1. 获取数据库引用
    
    2. 构造查询/更新条件
    
    3. 发出请求。
    
以上面列举的 bookes 集合为例子：

    /*
    *  获取数据库 ： database 可填参数 @type string 
    *   
    *  无参数时默认环境数据库，可选测试环境  wx.cloud.database('test')     
    */ 
    
    const db = wx.cloud.database(); 
     
    // 查询未例子 + 请求
    
    db.collection("bookes").where({
        publishInfo: {
            country: 'United States'
        }
    }).get({
        success(res)  {
            console.log("搜索结果：",res)
        }
    })
    
    搜索 “bookes” 数据集合  条件：publishInfo[country] = "Unites States"
    
    get() 发出请求 搜索成功返回结果在success函数中  参数res 即为结果
    

数据库的增删改查

我们假设一存在个数据库   bookes ， 并存在一个数据集合   author 

let db = wx.cloud.database();

 let authorCollection = db.collection("author");

/*
* ps：获取某一个数据的引用(注意：这里不是简单存储的json数据)
*   
* authorCollection.doc("it is json id")
*/

# 1 ： 往数据库中增加数据

authorCollection.add({
    data:{  // 数据集合存的是object ，这里直接写要存的object即可
            
    },
    success:function(result){
        // 存取成功则返回增加的那条数据的_id
        let _id = result._id;
    },
    fail:function(e){
        console.error("添加数据失败：",e)
    },
    complete:function(){
        console.log("有一次添加数据的动作")
    }
})

# 2 ：删

在小程序端删除单条数据

let jsonObject_1 = authorCollection.doc("first_author_id");

jsonObject_1.remove({
    success:function(res){
        console.log("删除成功：",res)
        // res = {stats：{ removed： 0  / 1 }}  removed 为删除的条数
    },
    fail:function(e){
        console.error("删除失败：",e);
    }
})

如果想批量删除数据，则必须在云函数中操作，用where 查询遇见搜索到符合条件的再删除

authorCollection.where({
    key:value           // 搜索json对象的某个key的值
}).remove({
    success:function(res){
        
    }
})


# 3 . 改

更新数据主要涉及两个api

    1. update
    
    2. set
    
update 可认为是更新记录的局部字段，而 set 则是将某个记录直接全部更改
    
3.1 update 可以局部更新一个 / 多个 记录（json数据）

    let needUpdate_1 = authorCollection.doc("need_update_id_1");
    
    needUpdate_1.update({
        key:value,   // 将该条数据的 key 指定设置为某个值，
        success:function(res){
            console.log("更新成功：",res);
        },
        faile:function(e){
            console.error("更新失败：",e);
        },
        complete:function(){
            console.log("进行过一次更新数据的操作");
        }
    })
    
    除了指定更新某个key的值外，微信还提供了一系列的api方便直接操作key或key的值
    
    更新指令        说明
    set         设置字段为指定值
    remove      删除字段
    inc         原子自增字段值
    mul         原子自乘字段值
    push        如字段值为数组，往数组尾部增加指定值
    pop         如字段值为数组，从数组尾部删除一个元素
    shift       如字段值为数组，从数组头部删除一个元素
    unshift     如字段值为数组，往数组头部增加指定值
    
    要使用这些命令，首先要获取更新指令对象
    
    const _ = db.command;

    1. set
    
    上面的例子直接更新了值，那么set 的作用就是将值更新为对象
    
    needUpdate_1.update({
        data:{
            style:_.set({
                color:"bule"
            })
        }
    })
    
    2. remove
    
    删除某一个字段 
    
    needUpdate_1.update({
        data:{
            style:_.remove()  // 删除这条数据中的style字段
        }
    })
    
    3. inc
    
    微信原描述：直接对原子进行自增操作
    （虽然官方没有明确表示要用做数字，建议对number类型的值用这个方法）
    
    例子1： 将某个字段的值增加 10 
    
     needUpdate_1.update({
        data:{
            moeny:_.inc(10)
        }
    })
    
    4. mul 自乘
    
     needUpdate_1.update({
        data:{
             moeny:_.mul(10000)
        }
    })
    
    5. 如果是想操作数组的话 push pop shift unshift
    
        使用效果和js对应名称的数组操作方法一致
        
         needUpdate_1.update({
            data:{
                bookes:_.push("new_book_1")
            }
        })
        
        ……
        
3.2 set

set 用于直接替换某一个记录

    needUpdate_1.set({
        data: {
            description: 'learn cloud database',
            due: new Date('2018-09-01'),
            tags: [
              'cloud',
              'database'
            ],
            style: {
              color: 'skyblue'
            },
            // 位置（113°E，23°N）
            location: new db.Geo.Point(113, 23),
            done: false
          },
      success(res) {
        console.log("替换成功：",res);
      },
      fail:function(e){
          console.error("替换失败：",e)
      },
      compelet:function(){
          console.log("进行一次数据替换操作")
      }
    })


4. 查

    where 则是微信官方提供给开发者用于筛选数据的api
    
    get() 方法基本会配合使用，用来获取搜索到的数据
    
    我们即可以指定筛选某个字段的值
    
    authorCollection.where({
        sorce:10,
    }).get({
        success:function(res){
            console.log("成功查询到数据：",res)
        },
        faile:function(e){
            console.error("查询数据失败：",e)
        },
        complete:function(){
            console.log("有过一次查询数据的操作")
        }
    })
    
    我们也可以依靠提供的指令筛选范围值
    
    当然这些指令依然在 db.command 中
    
    const _ = db.command;
    
    查询指令        说明
    eq              等于
    neq             不等于
    lt              小于
    lte             小于或等于
    gt              大于
    gte             大于或等于
    in              字段值在给定数组中
    nin             字段值不在给定数组中
    
    例子1：  筛选分数等于10的记录
    
    authorCollection.where({
        sorce:_.eq(100)
    })
    
    这些指令能解决很多东西，但远不够，微信还提供了逻辑指令，可用于我们筛选范围内的值
    
    and or
    
    authorCollection.where({
        sorce:_.gte(100).and(_.lte(1000))   // 搜索大于等于100 且 小于等于1000
    })
    
    
    authorCollection.where({
        sorce:_.gte(1000).or(_.lte(100))   // 搜索大于等于1000  或  小于等于100
    })
    
    or 的命令还可以实现多条件查询
    
    authorCollection.where(_.or([
        {
            sorce:_.eq(100)
        },
        {
            name:"name_1"
        }
    ])).get({
        success:function(res){
            console.log("成功查询到数据：",res)
        },
        faile:function(e){
            console.error("查询数据失败：",e)
        },
        complete:function(){
            console.log("有过一次查询数据的操作")
        }
    })

promise 方式 (主要为了熟悉重新写一遍)

上述的增删改查都可以以promise回调的形式获取到结果

let db = wx.cloud.database();

const _ = db.command;

let authorCollection = db.collection("author");

// add

    authorCollection.add({
        data:{
            
        }
    }).then(res => {
        console.log("增加数据成功：",res);
    }).catch(e => {
        console.error("增加数据失败：",e);
    })

// remove

    1. 删除单条
    
        authorCollection.doc("remove_id").remove().then(res => {
                                    
                                                  })
                                                  .cathc(e => {
                                                      
                                                  })
                                                  
    2. 删除多条需要在云环境下运行（云函数内操作）
    
        authorCollection.where({
            sorce:_.gt(5)
        }).remove().then(res => {
            
        }).catch(e => {
            
        })


// 更新 / 更改

    // update
    
    let doObject_1 = authorCollection.doc("do_id_1");
    
    doObject_1.update({
        data:{
            style:_.set({
                color:""red""
            })
        }
    }).then(res => {
        
    }).catch(e => {
        
    })
    
    doObject_1.update({
        data:{
            sorce:100
        }
    }).then(res => {
        
    }).catch(e => {
        
    })
    
    // set
    
    doObject_1.set({
       data:{
            style:{
                color:"red",
                font:5
            },
            sorce:123
       }
    }).then(res => {
        
    }).catch(e => {
        
    })
    
// 查

authorCollection.where({
    sorce:_.gte(100).and(_.lte(1000))
}).get().then(res => {
    
}).catch(e => {
    
})