前端开发：微信小游戏云开发的三个重要功能

最新推荐文章于 2024-07-05 11:37:01 发布

何处繁华升落

最新推荐文章于 2024-07-05 11:37:01 发布

阅读量458

点赞数 6

文章标签：微信 oracle 数据库 javascript

本文链接：https://blog.csdn.net/qq_38521742/article/details/134887949

版权

数据库

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

    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 => {
        
    })