智慧合約基礎語言（八）：Solidity事件
ofollow,noindex"> 原文連結：http://www.liankuai.tech/public/technology/105.html
1
目錄
☞事件的定義
☞web3事件監聽
☞檢索日誌
☞底層日誌介面
2
事件的定義
事件是使用EVM日誌內建功能的方便工具，在DAPP的介面中，它可以反過來呼叫Javascript的監聽事件的回撥。
事件在合約中可被繼承。當被呼叫時，會觸發引數儲存到交易的日誌中（一種區塊鏈上的特殊資料結構）。這些日誌與合約的地址關聯，併合併到區塊鏈中，只要區塊可以訪問就一直存在(至少Frontier，Homestead是這樣，但Serenity也許也是這樣)。日誌和事件在合約內不可直接被訪問，即使是建立日誌的合約。
日誌的SPV(簡單支付驗證)是可能的，如果一個外部的實體提供了一個這樣證明的合約，它可以證明日誌在區塊鏈是否存在。但需要留意的是，由於合約中僅能訪問最近的256個區塊雜湊，所以還需要提供區塊頭資訊。
可以最多有三個引數被設定為indexed，來設定是否被索引。設定為索引後，可以允許通過這個引數來查詢日誌，甚至可以按特定的值過濾。
如果陣列(包括string和bytes)型別被標記為索引項，會用它對應的Keccak-256雜湊值做為topic。
除非是匿名事件，否則事件簽名（比如：Deposit(address,hash256,uint256)）是其中一個topic，同時也意味著對於匿名事件無法通過名字來過濾。
所有未被索引的引數將被做為日誌的一部分被儲存起來。
被索引的引數將不會儲存它們自己，你可以搜尋他們的值，但不能檢索值本身。下面我們來看看，如何在Solidity中實現一個事件：
從上面的例子中，我們使用event關鍵字定義一個事件，引數列表中為要記錄的日誌引數的名稱及型別。
匿名和非匿名事件的結果對比：
下圖是通過掃描器觀察到的匿名和非匿名事件情況：
如圖所示，非匿名事件中的四個引數分別對應了四個topic，類似為四個值分別建立對應的索引。
3
deleteweb3事件監聽
在web3.js中，提供了響應事件的方法，如下：
另外一種簡便寫法是直接加入事件回撥，這樣就不用再寫watch的部分：
注意：在操作執行完成後，我們要記得呼叫event.stopWatching();來終止監聽。
4
檢索日誌
4.1Indexed屬性
可以在事件引數上增加indexed屬性，最多可以對三個引數增加這樣的屬性。加上這個屬性，可以允許你在web3.js中通過對加了這個屬性的引數進行值過濾，方式如下：
上面實現的是對value值為100的日誌，過濾後的返回。
如果你想同時匹配多個值，還可以傳入一個要匹配的陣列。
增加了indexed的引數值會存到日誌結構的Topic部分，便於快速查詢。而未加indexed的引數值會存在data部分，成為原始日誌。需要注意的是，如果增加indexed屬性的是陣列型別（包括string和bytes），那麼只會在Topic儲存對應的資料的web3.sha3雜湊值，將不會再存原始資料。因為Topic是用於快速查詢的，不能存任意長度的資料，所以通過Topic實際存的是陣列這種非固定長度資料雜湊結果。要查詢時，是將要查詢內容雜湊後與Topic內容進行匹配，但我們不能反推雜湊結果，從而得不到原始值。
4.2 顯式轉換
事件還支援傳入其它引數物件來限定可檢索的範圍，支援fromBlock，toBlock等過濾條件。
上面的程式碼實現了從第一塊開始搜尋日誌。
5
底層的日誌介面
可以通過底層的日誌介面來訪問底層的日誌機制。通過函式log0，log1，log2，log3，log4。logi支援i + 1個型別為bytes32的引數。其中第一個引數是日誌的data部分，其它引數為topic。所以下述事件：
使用API的等同寫法為:
下面是一個使用log3列印日誌的例子：
第一個引數為事件簽名的雜湊值keccak256("Deposit(address,bytes32,uint256)")，後面三個是按順序的indexed的值。
-END-
鏈塊學院區塊鏈系列網課已上線
學習路徑已為您規劃好
離區塊鏈工程師就差這一張圖的距離了~
本文完，獲取更多資訊，敬請關注區塊鏈工程師。
來源：鏈塊學院
本文由布洛克專欄作者釋出，代表作者觀點，版權歸作者所有，不代表布洛克科技觀點
——TheEnd——
關注“布洛克科技”
