solidity源文件布局

源文件的布局

源文件包括任意数量的合约定义和 include指令 引入其余源文件

语法和语义

Solidity支持 import语句，很是相似于JavaScript（ES6）,虽然Solidity不知道“缺省导出”的概念。

在全局层次上，你能够用下列形式使用import语句

import "filename";

将会从"filename"导入全部的全局符号(和当前导入的符号)到当前的全局范围里（不一样于ES6，可是Solidity保持向后兼容）

**import** ***** as symbolName from "filename";

创立了一个全局的符号名 symbolName,其中的成员就来自“filename”的全部符号

import {symbol1 as alias, symbol2} from “filename”;

将创立一个新的全局变量别名：alias 和 symbol2， 它将分别从"filename" 引入symbol1 和 symbol2

另外，Solidity语法不是ES6的子集，但可能（使用）更便利

import “filename” as symbolName;

等价于 import * as symbolName from “filename”;.

路径

• 在上面，文件名老是用/做为目录分割符，. 是当前的目录，.. 是父目录，路径名称不用.开头的都将视为绝对路径。

• 从同一个目录下import 一个文件 x 做为当前文件，用 import ”./x” as x; 若是使用

• import “x” as x; 是不一样的文件引用（在全局中使用"include directory"）,。

• 它将依赖于编译器（见后）来解析路径。一般，目录层次没必要严格限定映射到你的本地文件系统，它也能够映射到ipfs,http或git上的其余资源

使用真正的编译器

当编译器启动时，不只能够定义如何找到第一个元素的路径，也可能定义前缀重映射的路径，如 github.com/ethereum/dapp-bin/library将重映射到 /usr/local/dapp-bin/library ，编译器将从这个路径下读取文件。 若是重映射的keys是前缀， （编译器将尝试）最长的路径。容许回退而且映射到“/usr/local/include/solidity”。

solc:

solc(行命令编译器)，重映射将提供 key=值参数, =值 部分是可选的（缺省就是key ） 。

全部重映射的常规文件都将被编译（包括他们的依赖文件），这个机制彻底向后兼容（只要没有文件名包含 a=） ，这不是一个很大的变化，

好比 ，若是你从 github.com/ethereum/dapp-bin/ 克隆到本地 /usr/local/dapp-bin, 你能够用下列源文件

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

运行编译器时以下

solc github.com/ethereum/dapp-bin/=/usr/local/dapp-bin/ source.sol

注意： solc仅仅容许你从特定的目录下include文件，他们必须是一个显式定义的，包含目录或子目录的源文件， 或者是重映射目标的目录（子目录）。若是你容许直接include, 要增长remapping =/.

若是有多个重映射，就要作一个合法文件，文件中选择最长的公共前缀

基于浏览器的solidity

基于浏览器的编译器提供了从github上的自动重映射,而且自动检索网络上的文件，你能够import 迭代映射 如

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

其余源代码提供者能够之后增长进来。

注释

可用单行注释 (//) 和多行注释 (/.../)

有种特别的注释 叫作 “natspec ” （文档之后写出来），在函数声明或定义的右边用三个斜杠（///）或者用 两个星号 (/** ... */). 。若是想要调用一个函数，可使用doxygen-style标签里面文档功能,形式验证,并提供一个确认条件的文本注释显示给用户。

转自： https://blog.csdn.net/mongo_node/article/details/80152156

若是你但愿高效的学习以太坊DApp开发，能够访问汇智网提供的最热门在线互动教程：

• 适合区块链新手的以太坊DApp实战入门教程
• 区块链+IPFS+Node.js+MongoDB+Express去中心化以太坊电商应用开发实战

其余更多内容也能够访问这个以太坊博客。