EOS开发中区块链数据持久性(上) 原

本教程假定你已经完成了EOS开发从智能合约开始。

要了解数据持久性,请编写一个简单的智能合约,作为地址记录。虽然这个用例由于各种原因而不太适合作为生产智能合约,但开始学习数据持久性如何在EOSIO上运行而不被与eosio的multi_index功能无关的业务逻辑分心,这也算的上一个很好的合约。

第1步:创建一个新目录

之前,你创建了一个合约目录,现在就在那里开始。

//shell
cd CONTRACTS_DIR

为我们的合约创建一个新目录并进入目录:

//c++
mkdir addressbook
cd addressbook

第2步:创建并打开一个新文件

//c++
touch addressbook.cpp

在你喜欢的编辑器中打开文件。

第3步:编写扩展标准类并包含EOSIO

在之前的教程中,你创建了一个hello world合约,并学习了基础知识。你将熟悉下面的结构,该类已分别命名为addressbook

//c++

#include <eosiolib/eosio.hpp>
#include <eosiolib/print.hpp>
using namespace eosio;

class addressbook : public eosio::contract {
  public:
       
  private: 
  
};

第4步:为表创建数据结构

在配置和实例化表之前,需要编写表示地址簿数据结构的结构。 将此视为“schema”。 由于它是一个地址簿,该表将包含人,因此创建一个名为“person”的struct

//c++
struct person {};

定义multi_index表的模式时,需要使用唯一值作为主键。

对于此合约,请使用类型为account_name的名为“key”的字段。此合约将为每个用户提供一个唯一条目,因此该密钥将是基于用户的account_name保证一致性且有唯一值。

//c++
struct person {
	account_name key; 
};

由于该合约是地址簿,因此可能应该为每个条目或人员存储一些相关的详细信息。

//c++
struct person {
 account_name key;
 string first_name;
 string last_name;
 string street;
 string city;
 string state;
};

ok。基本schema架构现已完成。接下来,定义一个primary_key方法,该方法将由multi_index迭代器使用。每个multi_index架构都需要一个主键。要实现此目的,只需创建一个名为primary_key()的方法,并返回一个值,在本例中为结构中定义的成员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; }
};

步骤5:配置多索引表

现在已经使用结构定义了表的模式,我们需要配置表。需要对eosio::multi_index构造函数进行命名和配置,以使用我们之前定义的结构。

//c++
typedef eosio::multi_index<N(people), person> address_index;
  • 我们把N(N(base32 X),用于从X的base32编码的字符串解释生成编译时uint64_t)命名为表。该表包含许多不同的个体“persons”,因此将表命名为“people”。
  • 传入上一步中定义的单person结构
  • 声明此表的类型。此类型将用于稍后实例化此表。
//c++
//configure the table
typedef eosio::multi_index<N(people), person> address_index;

使用上述multi_index配置,有一个名为peoplemulti_index表,该表基于使用struct person的该表的单个行的模式或数据结构。

到目前为止,我们的文件应该是这样的。

//c++

#include <eosiolib/eosio.hpp>
#include <eosiolib/print.hpp>

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<N(people), person> address_index;

};

第6步:构造函数

使用C++类时,你应该创建的第一个公共方法是构造函数。

我们的构造函数将负责最初设置合约。

EOSIO合约扩展了合约类。使用合约范围初始化我们的父合约类。我们的构造函数传递的范围参数是正在部署合约的区块链上的帐户。

//c++
addressbook(account_name self): contract(self){}

第7步:向表中添加记录

以前,多索引表的主键被定义为强制执行此合约将仅为每个用户存储一条记录。为了使其全部工作,需要建立一些关于设计的假设。

  • 授权修改通讯簿的唯一帐户是用户。
  • 我们表的primary_key是唯一的,基于用户名。
  • 对于可用性,合约应该能够通过单个操作创建和修改表行。

在eosio中,区块链具有唯一的帐户,因此在此特定用例中,account_name是作为primary_key的理想候选者。account_name类型是uint64_t

接下来,为用户定义添加或更新记录的操作。此操作需要接受此操作需要能够放置(创建)或修改的任何值。

格式化定义以使其更容易阅读。为了简化用户体验和界面,有一个方法负责创建和修改行。因此,将其命名为“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
) {}

早些时候,有人提到只有用户才能控制自己的记录,因为这个合约是选择加入的。为此,请使用eosio.cdt提供的require_auth方法。此方法接受一个参数,即account_name类型,并断言执行交易的帐户等于提供的值。

//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 );
}

实例化表。之前,配置了multi_index表,并将其声明为address_index。要实例化一个表,请考虑这两个必需参数:

  • “code”,代表合约的帐户。可以通过作用域_self变量访问此值。
  • 定义合约付款人的范围“scope”,该用例中的合约负责支付ram费用。
//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 );
}

接下来,查询迭代器,将其设置为变量,因为此迭代器将被多次使用。

//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);
}

安全性已经建立并且表格实例化了,太棒了!

接下来,编写用于创建或修改表的逻辑。检测特定用户是否已存在。

为此,请通过传递user参数来使用表的find方法。find方法将返回一个迭代器。使用该迭代器对end方法进行测试。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在表中创建记录。此方法接受两个参数,即此记录的范围“scope”和回调函数。

emplace方法的回调函数必须使用lamba来创建接口。在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”函数的修改或更新。使用modify方法,传递一些参数

  • 前面定义的迭代器,在调用此操作时设置为声明的用户。
  • 范围“scope”或“ram payer”ram消费者,在这种情况下是用户,如先前在提出该合约的设计时所决定的那样。
  • 回调函数用于处理表的修改。
//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;
   });
  }
}

地址簿合约现在具有一个功能操作,如果该记录尚不存在,将允许用户在表中创建一行,如果已存在则修改它。

但是如果用户想要完全删除记录呢?请看EOS的数据持久性(下)

对了,文中调用的各种eos方法可以参考EOS.IO C语言API手册

======================================================================

分享一个交互式的在线编程实战,EOS智能合约与DApp开发入门

EOS教程

本课程帮助你快速入门EOS区块链去中心化应用的开发,内容涵盖EOS工具链、账户与钱包、发行代币、智能合约开发与部署、使用代码与智能合约交互等核心知识点,最后综合运用各知识点完成一个便签DApp的开发。

这里是原文

(adsbygoogle = window.adsbygoogle || []).push({}); function googleAdJSAtOnload() { var element = document.createElement("script"); element.src = "//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"; element.async = true; document.body.appendChild(element); } if (window.addEventListener) { window.addEventListener("load", googleAdJSAtOnload, false); } else if (window.attachEvent) { window.attachEvent("onload", googleAdJSAtOnload); } else { window.onload = googleAdJSAtOnload; }

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏刘望舒

Android深入四大组件(三)Service的绑定过程

前言 我们可以通过调用Context的startService来启动Service,也可以通过Context的bindService来绑定Service,建议阅...

19150
来自专栏别先生

基于jsp+servlet图书管理系统之后台用户信息查询操作

上一篇的博客写的是插入操作,且附有源码和数据库,这篇博客写的是查询操作,附有从头至尾写的代码(详细的注释)和数据库!   此次查询操作的源码和数据库:http:...

477100
来自专栏散尽浮华

salt-ssh批量操作记录

根据以往运维工作中操作经验来说,当管理上百台上千台服务器时,选择一款批量操作工具是及其有必要的。 早期习惯于在ssh信任关系的前提下做fo;do;done循环语...

46480
来自专栏Laoqi's Linux运维专列

python3–内置模块

55360
来自专栏区块链入门

第四课 以太坊开发框架Truffle从入门到实战

Truffle是一个世界级的开发环境,测试框架,以太坊的资源管理通道,致力于让以太坊上的开发变得简单,Truffle有以下:

19930
来自专栏圆方圆学院精选

【刘文彬】 Controller:EOS区块链核心控制器

原文链接:醒者呆的博客园,https://www.cnblogs.com/Evsward/p/controller.html

21320
来自专栏Android小菜鸡

NativeJS理解和使用

  Native.js技术,简称NJS,是一种将手机操作系统的原生对象转义,映射为JS对象,在JS里编写原生代码的技术。   如果说Node.js把js扩展到...

1.1K50
来自专栏跟着阿笨一起玩NET

url传递中文的解决方案

本文转载:http://www.cnblogs.com/ghd258/archive/2005/10/23/260241.html

35020
来自专栏腾讯移动品质中心TMQ的专栏

结合静态代码扫描来给插件间接口把把脉

如火如荼的EP建设中小鹅收到了一个小小的需求,如何知道每个版本变更了哪些插件间接口呢,有没有及时覆盖?

24760
来自专栏Android机动车

Socket TCP协议 实时通信的粘包处理之Java与C++实现

详细内容请阅读 http://blog.csdn.net/zhangxinrun/article/details/6721495

22820

扫码关注云+社区

领取腾讯云代金券