Firebase概览

暮鼓集行走集

原作于2016年08月29日

1. Overview

Firebase数据库为Key-value的JSON Tree

限制子节点深度 32 Key长度 768bytes 子节点大小 10M 写入 16M，(REST方式)256M Read操作的Node 100M

Backup/Restore 系统每日自动备份，由硬件层完成，保存60天，这些备份主要用于灾难恢复，但是开发者也可用于紧急恢复。提供私有备份，可以备份到Google Clould Storage或Amazon Simple Storage Solution bucket，这也是硬件层完成，不影响性能，这需要升级到Bonfire，Blaze或Inferno计划。也可以通过REST API来手动备份，对于小于200M的DB，直接读取root，否则要分片读取。

实时同步到所有连接的客户端

2. 保存数据

set() - 将JSON数据保存到指定路径，覆盖掉该路径上包括子节点在内的所有数据返回一个该位置引用对象

update() - 更新数据但不会覆盖全部可以同时更新多个需要注意 “A/B:value”的形式

可以为set与update增加完成Complete回调

push() - 在数据中加入一个数据列表，每次调用push()数据库将生成一个ID，这个ID基于时间戳，使用.key()获取这个ID

var data = { 'name':name, 'addr':addr, 'tel':tel };
var ref1 = firebase.database().ref('restaurants');
var ref2 = ref1.push();
ref2.set(data);
var path = ref2.toString();

transaction() - 事务

offline writes Firebase在本地维护了一个本地版本，在写数据时都是先保存到本地，所以，在断网时也可以保存数据，当网络恢复时可以同步数据。这些都是自动完成的而无须写代码实现。

3 读取数据

Firebase 通过异步侦听方式获取数据，Firebase定义了两种侦听器与五个侦听事件

public interface ValueEventListener {

    // 读取和侦听对路径的全部内容所做的更改
    void onDataChange(DataSnapshot var1);

    void onCancelled(DatabaseError var1);
}

public interface ChildEventListener{

    //检索项目列表，或侦听项目列表中是否添加了新项目
    void onChildAdded(DataSnapshot snapshot, String previousChild);

    // 侦听对列表中的项目所做的更改
    void onChildChanged(DataSnapshot dataSnapshot, String s);

    // 侦听正从列表中删除的项目
    void onChildRemoved(DataSnapshot dataSnapshot) {}

    // 与经过排序的数据配合使用，从而侦听对项目优先级所做的更改
    void onChildMoved(DataSnapshot dataSnapshot, String s);

    void onCancelled(DatabaseError databaseError) { }
}

两种侦听器的区别是，ValueEventListener侦听某一节点下的全部变化，而ChildEventListener侦听子节点的变化。ValueEventListener只有一个Callback的方法onDataChange，ChildEventListener则有多个，控制更为精细，但是需要多个Callback方法组合使用才能获得对node进行增删改查的完整侦听。

侦听器使DataSnapShop来传递数据，如果没有任何数据，返回null。

应小心的设计侦听的node的层级，仅在需要观察更改的最低级别附加侦听器，避免加在根节点上。

读取一次

addValueEventListener();
addListenerForSingleValueEvent()

排序

String myUserId = getUid();
Query myTopPostsQuery = databaseReference.child("user-posts").child(myUserId)
        .orderByChild("starCount");

过滤

Query recentPostsQuery = databaseReference.child("posts")
        .limitToFirst(100);

4 设置规则

使用灵活的，基于表达式的，类JavaScript符号定义了数据如何结构化，如何索引和何时读写使用Web Console或Command Line来设置，后一种对程序自动部署很有用 .read - 是否以及何时允许读 .write - 是否以及何时允许写 .validate - 设置值的样子，是否允许有Child Node，以及类型 .indexOn

预定义变量 now, root, new Data, data, $variables, auth

对Public开放

{
    "rules": {
        ".read": true,
        ".write": true
    }
}

仅对鉴权用户开放

{
  "rules": {
    ".read": "auth != null",
    ".write": "auth != null"
  }
}

{
  "rules": {
    "messages": {
      "$message": {
        // only messages from the last ten minutes can be read
        ".read": "data.child('timestamp').val() > (now - 600000)",

        // new messages must have a string content and a number timestamp
        ".validate": "newData.hasChildren(['content', 'timestamp']) && newData.child('content').isString() && newData.child('timestamp').isNumber()"
      }
    }
  }
}

限制为1900-2000的YYYY-MM-DD

".validate": "newData.isString() &&
              newData.val().matches(/^(19|20)[0-9][0-9][-\\/. ](0[1-9]|1[012])[-\\/. ](0[1-9]|[12][0-9]|3[01])$/)"

层级控制，浅层的规则覆盖深层，最浅层则是root 如果一个node下有任何子node设置为读false，那么读取这个node就会失败

限制用户访问自己的数据一个常用的做法是所有的user放在users节点下，并使用如下规则来访问自己的数据

暮鼓集 行走集

猜你喜欢

Firebase概览

暮鼓集 行走集

猜你喜欢

暮鼓集行走集