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去中心化以太坊電商應用開發實戰

其餘更多內容也能夠訪問這個以太坊博客。