本篇內(nèi)容介紹了“EOS開發(fā)中區(qū)塊鏈數(shù)據(jù)怎么實(shí)現(xiàn)持久性”的有關(guān)知識(shí),在實(shí)際案例的操作過程中,不少人都會(huì)遇到這樣的困境,接下來就讓小編帶領(lǐng)大家學(xué)習(xí)一下如何處理這些情況吧!希望大家仔細(xì)閱讀,能夠?qū)W有所成!
創(chuàng)新互聯(lián)為企業(yè)級客戶提高一站式互聯(lián)網(wǎng)+設(shè)計(jì)服務(wù),主要包括網(wǎng)站建設(shè)、成都網(wǎng)站建設(shè)、app軟件開發(fā)公司、小程序開發(fā)、宣傳片制作、LOGO設(shè)計(jì)等,幫助客戶快速提升營銷能力和企業(yè)形象,創(chuàng)新互聯(lián)各部門都有經(jīng)驗(yàn)豐富的經(jīng)驗(yàn),可以確保每一個(gè)作品的質(zhì)量和創(chuàng)作周期,同時(shí)每年都有很多新員工加入,為我們帶來大量新的創(chuàng)意。
之前,你創(chuàng)建了一個(gè)合約目錄,現(xiàn)在就在那里開始。
//shell cd CONTRACTS_DIR
為我們的合約創(chuàng)建一個(gè)新目錄并進(jìn)入目錄:
//c++ mkdir addressbook cd addressbook
//c++ touch addressbook.cpp
在你喜歡的編輯器中打開文件。
在之前的教程中,你創(chuàng)建了一個(gè)hello world合約,并學(xué)習(xí)了基礎(chǔ)知識(shí)。你將熟悉下面的結(jié)構(gòu),該類已分別命名為addressbook
。
//c++ #include#include using namespace eosio; class addressbook : public eosio::contract { public: private: };
在配置和實(shí)例化表之前,需要編寫表示地址簿數(shù)據(jù)結(jié)構(gòu)的結(jié)構(gòu)。 將此視為“schema”。 由于它是一個(gè)地址簿,該表將包含人,因此創(chuàng)建一個(gè)名為“person”的struct
。
//c++ struct person {};
定義multi_index
表的模式時(shí),需要使用唯一值作為主鍵。
對于此合約,請使用類型為account_name
的名為“key”的字段。此合約將為每個(gè)用戶提供一個(gè)唯一條目,因此該密鑰將是基于用戶的account_name
保證一致性且有唯一值。
//c++ struct person { account_name key; };
由于該合約是地址簿,因此可能應(yīng)該為每個(gè)條目或人員存儲(chǔ)一些相關(guān)的詳細(xì)信息。
//c++ struct person { account_name key; string first_name; string last_name; string street; string city; string state; };
ok?;?code>schema架構(gòu)現(xiàn)已完成。接下來,定義一個(gè)primary_key
方法,該方法將由multi_index
迭代器使用。每個(gè)multi_index
架構(gòu)都需要一個(gè)主鍵。要實(shí)現(xiàn)此目的,只需創(chuàng)建一個(gè)名為primary_key()
的方法,并返回一個(gè)值,在本例中為結(jié)構(gòu)中定義的成員key
。
//c++ struct person { account_name key; string first_name; string last_name; string street; string city; string state; uint64_t primary_key() const { return key; } };
現(xiàn)在已經(jīng)使用結(jié)構(gòu)定義了表的模式,我們需要配置表。需要對eosio::multi_index
構(gòu)造函數(shù)進(jìn)行命名和配置,以使用我們之前定義的結(jié)構(gòu)。
//c++ typedef eosio::multi_indexaddress_index;
我們把N
(N(base32 X),用于從X的base32編碼的字符串解釋生成編譯時(shí)uint64_t)命名為表。該表包含許多不同的個(gè)體“persons”,因此將表命名為“people”。
傳入上一步中定義的單person
結(jié)構(gòu)
聲明此表的類型。此類型將用于稍后實(shí)例化此表。
//c++ //configure the table typedef eosio::multi_indexaddress_index;
使用上述multi_index
配置,有一個(gè)名為people
的multi_index
表,該表基于使用struct
person
的該表的單個(gè)行的模式或數(shù)據(jù)結(jié)構(gòu)。
到目前為止,我們的文件應(yīng)該是這樣的。
//c++ #include#include using namespace eosio; class addressbook : public eosio::contract { public: private: struct [[eosio::table]] person { account_name key; std::string first_name; std::string last_name; std::string street; std::string city; std::string state; uint64_t primary_key() const { return key; } }; typedef eosio::multi_index address_index; };
使用C++類時(shí),你應(yīng)該創(chuàng)建的第一個(gè)公共方法是構(gòu)造函數(shù)。
我們的構(gòu)造函數(shù)將負(fù)責(zé)最初設(shè)置合約。
EOSIO合約擴(kuò)展了合約類。使用合約范圍初始化我們的父合約類。我們的構(gòu)造函數(shù)傳遞的范圍參數(shù)是正在部署合約的區(qū)塊鏈上的帳戶。
//c++ addressbook(account_name self): contract(self){}
以前,多索引表的主鍵被定義為強(qiáng)制執(zhí)行此合約將僅為每個(gè)用戶存儲(chǔ)一條記錄。為了使其全部工作,需要建立一些關(guān)于設(shè)計(jì)的假設(shè)。
授權(quán)修改通訊簿的唯一帳戶是用戶。
我們表的primary_key
是唯一的,基于用戶名。
對于可用性,合約應(yīng)該能夠通過單個(gè)操作創(chuàng)建和修改表行。
在eosio中,區(qū)塊鏈具有唯一的帳戶,因此在此特定用例中,account_name
是作為primary_key
的理想候選者。account_name
類型是uint64_t
。
接下來,為用戶定義添加或更新記錄的操作。此操作需要接受此操作需要能夠放置(創(chuàng)建)或修改的任何值。
格式化定義以使其更容易閱讀。為了簡化用戶體驗(yàn)和界面,有一個(gè)方法負(fù)責(zé)創(chuàng)建和修改行。因此,將其命名為“upsert”,即“update”和“insert”的組合。
//c++ void upsert( account_name user, std::string first_name, std::string last_name, std::string street, std::string city, std::string state ) {}
早些時(shí)候,有人提到只有用戶才能控制自己的記錄,因?yàn)檫@個(gè)合約是選擇加入的。為此,請使用eosio.cdt
提供的require_auth
方法。此方法接受一個(gè)參數(shù),即account_name
類型,并斷言執(zhí)行交易的帳戶等于提供的值。
//c++ void upsert(account_name user, std::string first_name, std::string last_name, std::string street, std::string city, std::string state) { require_auth( user ); }
實(shí)例化表。之前,配置了multi_index
表,并將其聲明為address_index
。要實(shí)例化一個(gè)表,請考慮這兩個(gè)必需參數(shù):
“code”,代表合約的帳戶。可以通過作用域_self
變量訪問此值。
定義合約付款人的范圍“scope”,該用例中的合約負(fù)責(zé)支付ram費(fèi)用。
//c++ void upsert(account_name user, std::string first_name, std::string last_name, std::string street, std::string city, std::string state) { require_auth( user ); address_index addresses(_self, _self ); }
接下來,查詢迭代器,將其設(shè)置為變量,因?yàn)榇说鲗⒈欢啻问褂谩?/p>
//c++ void upsert(account_name user, std::string first_name, std::string last_name, std::string street, std::string city, std::string state) { require_auth( user ); address_index addresses(_self, _self ); auto iterator = addresses.find(user); }
安全性已經(jīng)建立并且表格實(shí)例化了,太棒了!
接下來,編寫用于創(chuàng)建或修改表的邏輯。檢測特定用戶是否已存在。
為此,請通過傳遞user
參數(shù)來使用表的find
方法。find
方法將返回一個(gè)迭代器。使用該迭代器對end
方法進(jìn)行測試。end
方法是“null”的別名。
//c++ void upsert(account_name user, std::string first_name, std::string last_name, std::string street, std::string city, std::string state) { require_auth( user ); auto iterator = addresses.find( user ); address_index addresses(_self, _self ); if( addresses.find( user ) == addresses.end() ) { //The user isn't in the table } else { //The user is in the table } }
使用multi_index
方法emplace
在表中創(chuàng)建記錄。此方法接受兩個(gè)參數(shù),即此記錄的范圍“scope”和回調(diào)函數(shù)。
emplace
方法的回調(diào)函數(shù)必須使用lamba來創(chuàng)建接口。在body中分配行的值和提供給upsert
的值。
//c++ void upsert(account_name user, std::string first_name, std::string last_name, std::string street, std::string city, std::string state) { require_auth( user ); address_index addresses(_self, _self ); auto iterator = addresses.find( user ); if( iterator == addresses.end() ) { addresses.emplace(user, [&]( auto& row ) { row.key = user; row.first_name = first_name; row.last_name = last_name; row.street = street; row.city = city; row.state = state; }); } else { //The user is in the table } }
接下來,處理“upsert”函數(shù)的修改或更新。使用modify
方法,傳遞一些參數(shù)
前面定義的迭代器,在調(diào)用此操作時(shí)設(shè)置為聲明的用戶。
范圍“scope”或“ram payer”ram消費(fèi)者,在這種情況下是用戶,如先前在提出該合約的設(shè)計(jì)時(shí)所決定的那樣。
回調(diào)函數(shù)用于處理表的修改。
//c++ void upsert(account_name user, std::string first_name, std::string last_name, std::string street, std::string city, std::string state) { require_auth( user ); address_index addresses(_self, _self ); auto iterator = addresses.find( user ); if( iterator == addresses.end() ) { addresses.emplace(user, [&]( auto& row ) { row.key = user; row.first_name = first_name; row.last_name = last_name; row.street = street; row.city = city; row.state = state; }); } else { addresses.modify(iterator, user, [&]( auto& row ) { row.first_name = first_name; row.last_name = last_name; row.street = street; row.city = city; row.state = state; }); } }
地址簿合約現(xiàn)在具有一個(gè)功能操作,如果該記錄尚不存在,將允許用戶在表中創(chuàng)建一行,如果已存在則修改它。
“EOS開發(fā)中區(qū)塊鏈數(shù)據(jù)怎么實(shí)現(xiàn)持久性”的內(nèi)容就介紹到這里了,感謝大家的閱讀。如果想了解更多行業(yè)相關(guān)的知識(shí)可以關(guān)注創(chuàng)新互聯(lián)網(wǎng)站,小編將為大家輸出更多高質(zhì)量的實(shí)用文章!