Solidity基础教程1——整体结构

本教程使用的开发环境是一款在线编译器——ChainIDE,具体的使用方法在之前的文章当中已经有讲解过,有需要的同学可以自行查看。

网址:https://eth.chainide.com/

文件架构

Solidity语言的文件名后缀为.sol,一般用作智能合约的编写,文件内会包含以下的一些内容:
1.编译器版本定义
2.外部合约调用(非必需)
3.合约主体
4.注释(非必需)

编译器版本定义。版本限制是为了解决程序有可能被不兼容的编译器所导致编译失败而产生的,我们可以通过几个例子来了解一些它的常用方法。

pragma solidity ^0.4.0;

这句话的意思是,该文件使用的编译器是大于等于0.4.0但小于0.5.0(不包括0.5.0),后面这个条件由^符号进行限定,这样可以保证在编译器的一个中等版本内进行编译。

pragma solidity >=0.4.0 <0.7.0;

这种写法更像程序内的一种条件语句,也就是该文件使用的编译器大于等于0.4.0且小于0.7.0。

外部合约调用。在开源的仓库比如github,或者本地的文件内,有已经写好的合约,我们就可以通过外部调用的方式直接引用,不用再重写一遍。这种不仅是为了节约时间和精力,而且是为了保证安全,通常来说已经在区块链上运行了一段时间的库是具有安全保障的,比如大家会经常使用的Openzipplin的Safemath等众所周知的轮子。

调用方法也很简单:

import "filename";

这是最简单的,直接通过路径来进行库的引用,可以引用本地路径下的库,也可以引用github上的一些库。具体引用方式可以看下面两个例子。

import "github.com/OpenZeppelin/openzeppelin-contracts/blob/v2.5.1/contracts/math/SafeMath.sol";
import "../test.sol"

上面那行引用的是github上的OpeZeppelin的库,这样会把这个库放到编译器环境当中进行编译。下面那行引用的是本地路径下的一个test.sol文件,文件的位置在它的父目录下。

import "github.com/ethereum/dapp-bin/library/iterable_mapping.sol" as it_mapping;

还有一个技巧是可以把引用的库给一个简称,这样在调用的时候可以更加方便,类似于python当中import pandas as py这种方式。

合约主体。智能合约就是由Contract关键字编写的程序模块,它的内部是作用域,它的大括号内的一切都是属于这个合约的一部分。一个合约主要会包含这五个元素:

1.状态变量。

uint storedData; // 状态变量

状态变量是一个永久储存在合约储存当中的值,状态变量可以是整形、布尔型、等等,状态变量的类型可以由程序设定,或者是通过逻辑进行推断得出,具体的细节内容我们会在下一节教程当中讲解。

2.自定义类型

    enum Class { Chinese, Math, English }       // 枚举

    struct Student{                             // 结构体
        uint number;
        bool isboy;
        address WalletAddress;
        uint grade;
    }

自定义类型有枚举类型和结构体两种形式,都是通过一个程序开发者自行定义的方式来对改类型进行设定,并且在程序当中调用这个值。

3.函数

    function get() public view returns (uint) {
        return storedData;
    }

函数是合约用来实现功能的逻辑部分,它包含了输入值,返回值,函数类型,函数可见性以及内部逻辑等部分,是合约当中一个非常重要的部分。

4.函数Modifier

    modifier onlyOwner {
        require(msg.sender == owner);
        _;
    }

Modifier可以更改函数的行为,比如让它加入一些前置判断条件,对函数的使用进行限制。这种Modifier是合约的可继承属性,可能被派生属性所覆盖,总的来说是函数设计的一种表达方式。

上面这个onlyOwner的modifier就表示只有与合约当中owner变量的值相同的地址才可以调用这个函数,后面的_表示待填充的代码。

5.事件

event EventName(address bidder, uint amount);  //定义一个事件

function testEvent() public {
     emit EventName(msg.sender, msg.value);     // 触发一个事件
}

这个部分有些与平常的语言不一样的地方,由于程序运行的基础环境是EVM,程序的调试和监管所需的日志也是储存在EVM上的,event关键词就是定义一个事件,在emit的时候调用它。

在合约内是不可以查看这个事件的日志的,想要查看日志可以使用Javascript的接口从以太坊查询这个日志。

我们可以举个例子,比如你是一个制作DEX前端的程序员,你要跟合约进行交互,观察函数是否正确被调用了,交易是否完成,这个时候就可以通过调用日志来进行查询。这个部分在我们稍微后面一点的教程当中会提及。

最后,注释。虽然注释不是一个程序编译时的必须组成部分,但是不写注释的程序员都是要被开除的[狗头]。

   //  这是一条注释

希望大家在写程序的时候也能好好写注释,这样在与别人协作或者是自己调试的时候会有很大帮助。

结语

今天的内容就到这里结束了,主要是帮助大家对.sol文件结构有个整体的认识,这样在真正开始编程的时候可以更快的入手。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,524评论 5 460
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,869评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,813评论 0 320
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,210评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,085评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,117评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,533评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,219评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,487评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,582评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,362评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,218评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,589评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,899评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,176评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,503评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,707评论 2 335

推荐阅读更多精彩内容

  •   Solidity是传说中编写智能合约的脚本语言,运行在EVM中;用以解决区块链中的任务执行。一个目前看起来还非...
    杨强AT南京阅读 5,229评论 0 1
  • solidity的数据位置特性深入了解简介:代码在执行前,一般会编译成指令。指令就是一个个逻辑,逻辑操作的是数据。...
    Lnhj阅读 560评论 0 0
  • 分享一个很有趣的以太坊开发教程。从零开始手把手教你以太坊开发。 第1章: 课程概述 第一课你将创造一个"僵尸工厂"...
    那个大螺丝阅读 2,408评论 1 20
  • solidity的自定义结构体深入详解结构体,solidity中的自定义类型,我们可以使用关键字struct来进行...
    Lnhj阅读 1,094评论 0 0
  • 黑色的海岛上悬着一轮又大又圆的明月,毫不嫌弃地把温柔的月色照在这寸草不生的小岛上。一个少年白衣白发,悠闲自如地倚坐...
    小水Vivian阅读 3,088评论 1 5