Hyperledger Fabric 1.3 特性調(diào)研之其他(三)

1. 查詢(xún)支持翻頁(yè)

Fabric提供支持翻頁(yè)的查詢(xún)接口劳澄,可以設(shè)置書(shū)簽(頁(yè)面起始位置)和頁(yè)面大小。

適用場(chǎng)景

對(duì)于請(qǐng)求范圍數(shù)據(jù)蜈七,數(shù)據(jù)記錄數(shù)過(guò)多的情況秒拔,可以使用Fabric新增的翻頁(yè)查詢(xún)功能,免除代碼中自己實(shí)現(xiàn)翻頁(yè)邏輯宪潮。

技術(shù)實(shí)現(xiàn)

Fabric實(shí)現(xiàn)了翻頁(yè)邏輯的代碼溯警,通過(guò)設(shè)置書(shū)簽記錄頁(yè)面起始位置。對(duì)于LevelDB狡相,返回的書(shū)簽是本次查詢(xún)結(jié)果最后一條記錄的下一條記錄的key梯轻;對(duì)于CouchDB,F(xiàn)abric并沒(méi)有使用它的skip和limit參數(shù)尽棕,使用了bookmark參數(shù)喳挑。

接口

合約新增的支持翻頁(yè)的查詢(xún)函數(shù)包括如下:

GetStateByRangeWithPagination(startKey, endKey string, pageSize int32, bookmark string) (StateQueryIteratorInterface, *pb.QueryResponseMetadata, error)
GetStateByPartialCompositeKeyWithPagination(objectType string, keys []string, pageSize int32, bookmark string) (StateQueryIteratorInterface, *pb.QueryResponseMetadata, error)
// 該接口僅支持CouchDB
GetQueryResultWithPagination(query string, pageSize int32, bookmark string) (StateQueryIteratorInterface, *pb.QueryResponseMetadata, error)

實(shí)際操作

【此處參照f(shuō)abric-sample中提供的marbles02合約示例√舷ぃ】
合約可以通過(guò)如下代碼獲得從指定位置開(kāi)始的指定頁(yè)面大小的數(shù)據(jù):

resultsIterator, responseMetadata, err := stub.GetStateByRangeWithPagination(startKey, endKey, int32(pageSize), bookmark)
if err != nil {
    return shim.Error(err.Error())
}
defer resultsIterator.Close()

其中StartKey和endKey是范圍的開(kāi)始值(包括在內(nèi)伊诵,如果設(shè)置為空字符串“”,則從開(kāi)頭處開(kāi)始)和結(jié)束值(不包括在內(nèi)回官,如果設(shè)置為空字符串“”曹宴,則包括結(jié)尾),和GetStateByRange函數(shù)一致歉提。pageSize為頁(yè)面大械烟埂;bookmark是頁(yè)面開(kāi)始的位置苔巨,如果是leveldb則為key的值版扩,如果是couchdb則為類(lèi)似“g1AAAAA-eJzLYWBgYMpgSmHgKy5JLCrJTq2MT8lPzkzJBYqz5yYWJeWkGoKkOWDSyBJZABxmEgs”的字符串。如果設(shè)置bookmark為空字符串“”侄泽,則默認(rèn)從startKey開(kāi)始礁芦。
返回的responseMetadata中包括兩個(gè)字段:FetchedRecordsCount是本次查詢(xún)獲取的記錄數(shù)目,Bookmark是下一頁(yè)開(kāi)始的位置悼尾。

2. 合約支持Java

Fabric合約原先支持Golang和Node.js柿扣,現(xiàn)在提供對(duì)Java的支持。

3. 廢除event hub

Fabric事件的查詢(xún)可以通過(guò)兩種方式:event hub和peer channel-based event service诀豁。其中窄刘,后者在release 1.1中已經(jīng)支持。

  • Event hub:每當(dāng)產(chǎn)生新的區(qū)塊舷胜,則發(fā)送事件通知娩践;
  • 基于通道的事件服務(wù)(peer channel-based event service):可以查詢(xún)指定channel下的指定區(qū)塊范圍內(nèi)的事件信息。
    而Fabric 1.3將不再支持event hub烹骨。

適用場(chǎng)景

事件查詢(xún)可以用于執(zhí)行交易后查詢(xún)交易是否寫(xiě)入?yún)^(qū)塊且有效翻伺,也可以用于回溯以往的區(qū)塊中的事件。

接口

peer channel-based event service提供以下接口支持:

// PeerDeliverClient defines the interface for a peer deliver clienttype 
PeerDeliverClient interface {
   Deliver(ctx context.Context, opts ...grpc.CallOption) (api.Deliver, error)
   DeliverFiltered(ctx context.Context, opts ...grpc.CallOption) (api.Deliver, error)
}
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末沮焕,一起剝皮案震驚了整個(gè)濱河市吨岭,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌峦树,老刑警劉巖辣辫,帶你破解...
    沈念sama閱讀 218,858評(píng)論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件旦事,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡急灭,警方通過(guò)查閱死者的電腦和手機(jī)姐浮,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,372評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門(mén),熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)葬馋,“玉大人卖鲤,你說(shuō)我怎么就攤上這事〕胨唬” “怎么了蛋逾?”我有些...
    開(kāi)封第一講書(shū)人閱讀 165,282評(píng)論 0 356
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)窗悯。 經(jīng)常有香客問(wèn)我区匣,道長(zhǎng),這世上最難降的妖魔是什么蟀瞧? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 58,842評(píng)論 1 295
  • 正文 為了忘掉前任沉颂,我火速辦了婚禮,結(jié)果婚禮上悦污,老公的妹妹穿的比我還像新娘铸屉。我一直安慰自己,他們只是感情好切端,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,857評(píng)論 6 392
  • 文/花漫 我一把揭開(kāi)白布彻坛。 她就那樣靜靜地躺著,像睡著了一般踏枣。 火紅的嫁衣襯著肌膚如雪昌屉。 梳的紋絲不亂的頭發(fā)上,一...
    開(kāi)封第一講書(shū)人閱讀 51,679評(píng)論 1 305
  • 那天茵瀑,我揣著相機(jī)與錄音间驮,去河邊找鬼。 笑死马昨,一個(gè)胖子當(dāng)著我的面吹牛竞帽,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播鸿捧,決...
    沈念sama閱讀 40,406評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼屹篓,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了匙奴?” 一聲冷哼從身側(cè)響起堆巧,我...
    開(kāi)封第一講書(shū)人閱讀 39,311評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后谍肤,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體啦租,經(jīng)...
    沈念sama閱讀 45,767評(píng)論 1 315
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,945評(píng)論 3 336
  • 正文 我和宋清朗相戀三年荒揣,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了刷钢。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,090評(píng)論 1 350
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡乳附,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出伴澄,到底是詐尸還是另有隱情赋除,我是刑警寧澤,帶...
    沈念sama閱讀 35,785評(píng)論 5 346
  • 正文 年R本政府宣布非凌,位于F島的核電站举农,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏敞嗡。R本人自食惡果不足惜颁糟,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,420評(píng)論 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望喉悴。 院中可真熱鬧棱貌,春花似錦、人聲如沸箕肃。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 31,988評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)勺像。三九已至障贸,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間吟宦,已是汗流浹背篮洁。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 33,101評(píng)論 1 271
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留殃姓,地道東北人袁波。 一個(gè)月前我還...
    沈念sama閱讀 48,298評(píng)論 3 372
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像辰狡,于是被迫代替她去往敵國(guó)和親锋叨。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,033評(píng)論 2 355

推薦閱讀更多精彩內(nèi)容