Author: elleryq

主要可以 trigger 兩個，一個是 onCreate，一個是 onDelete

onCreate 在以下情況會被觸發

• A user creates an email account and password.
• A user signs in for the first time using a federated identity provider.
• The developer creates an account using the Firebase Admin SDK.
• A user signs in to a new anonymous auth session for the first time.

exports.sendWelcomeEmail = functions.auth.user().onCreate((user) => {
  // ...
});

onDelete 在使用者被刪除時觸發

exports.sendByeEmail = functions.auth.user().onDelete((user) => {
  // ...
});

裡面的 user 主要就是 UserRecord

email / displayName / customClaims / uid / …. 等欄位都有。

onDelete 可以用來做刪除 firestore/realtime database 上的資料，需要考慮 functions 能執行多久。

依照 Queries, Part 1: Common SQL Queries Converted for Firebase 來練習

• By ID ，路徑指定好就可以了 firebase.database().ref(‘/messages/’ + messageID).once(‘value’, function(snap) { … });
• WHERE, 除了路徑之外，還要指定 orderByKey() 或 orderByChild()，然後再用 startAt/endAt
  • orderByKey 是依照 key 的值：firebase.database().ref(‘/messages’).orderByKey().startAt(‘user001’).endAt(‘user010’).once(‘value’, function(snap) { … });
  • orderByChild 是依照子節點的值：firebase.database().ref(‘/messages’).orderByChild(’email’).startAt(‘user001@example.com’).endAt(‘user010@example.com’).once(‘value’, function(snap) {…});
  • 用 orderByChild 時，要在規則裡加上 .indexOn ，否則會有警告，警告的大意是說加indexOn 後，效能會比較好。
• LIMIT，加 limitToFirst(10) 或 limitToLast(10)
  • 可以跟前面提到的 startAt / endAt 結合：firebase.database().ref(‘/messages’).orderByChild(’email’).startAt(‘user001@example.com‘).endAt(‘user010@example.com‘).limitToFirst(10).once(‘value’, function(snap) {…});
  • limitToLast 就是指定後面幾筆

閱讀的文件：https://firebase.google.com/docs/functions/database-events

可以寫這些事件的處理常式

• onWrite() 資料被建立、更新或刪除時，會觸發
• onCreate() 資料被建立時，會觸發
• onUpdate() 資料被更新時，會觸發
• onDelete() 資料被刪除時，會觸發

可以只針對指定的路徑，對，也因為事件資料同時包含舊的跟新的，資料量有限制，資料量大的時候要針對個別路徑拆開來寫處理常式。

可以用參數，例如 ref(‘foo/{bar}’)  ，那麼存取 foo/hello 或 foo/firebase 時，都會觸發常式對 foo/ 寫入，像下面

{
  "foo": {
    "hello": "world",
    "firebase": "functions"
  }
}

會觸發兩次常式，一次是 foo/hello ，一次是 foo/firebase從 EventContext.params 可以用 bar 這個 key 去拿到 hello 或 firebase
範例

 
// 當有訊息加到 /messages/:pushId/original 時，執行這常式。 
// 這常式會把指定路徑下的值，轉為大寫，再放到 /messages/:pushId/uppercase 
exports.makeUppercase = functions.database.ref('/messages/{pushId}/original') 
    .onCreate((snapshot, context) => {  // snapshot 是 DataSnapshot ，context 是 EventContext 
      // 先取得寫入的值 
      const original = snapshot.val(); 
      console.log('Uppercasing', context.params.pushId, original); 
      const uppercase = original.toUpperCase(); 
      // 把資料寫到 "uppercase" sibling 然後回傳 Promise 
      // snapshot.ref.parent -> /messages/:pushId 
      // snapshot.ref.parent.child('uppercase') -> /messages/:pushId/uppercase 
      return snapshot.ref.parent.child('uppercase').set(uppercase); 
    }); 

用 EventContext 的 auth / authType 就可以取得 authentication 資訊 (這邊我有點迷糊了，為啥 authType 可以是 ADMIN / USER ??

onWrite 的時候，是用 change, context change 是 Change，提供了 before/after property 可以存取寫之前/之後的值 。