http://wiki.jikexueyuan.com/project/solidity-zh/solidity-example.html
投票合约的代码来自solidity官方文档,我将对这个合约进行简单分析
/// @title Voting with delegation.
/// @title 授权投票
contract Ballot
{
// 这里声明了复杂类型
// 将会在被后面的参数使用
// 代表一个独立的投票人。
struct Voter
{
uint weight; // 累积的权重。
bool voted; // 如果为真,则表示该投票人已经投票。
address delegate; // 委托的投票代表
uint vote; // 投票选择的提案索引号
}
// 这是一个独立提案的类型
struct Proposal
{
bytes32 name; // 短名称(32字节)
uint voteCount; // 累计获得的票数
}
address public chairperson;
//这里声明一个状态变量,保存每个独立地址的`Voter` 结构
mapping(address => Voter) public voters;
//一个存储`Proposal`结构的动态数组
Proposal[] public proposals;
// 创建一个新的投票用于选出一个提案名`proposalNames`.
function Ballot(bytes32[] proposalNames)
{
chairperson = msg.sender;
voters[chairperson].weight = 1;
//对提供的每一个提案名称,创建一个新的提案
//对象添加到数组末尾
for (uint i = 0; i < proposalNames.length; i++)
//`Proposal({...})` 创建了一个临时的提案对象,
//`proposal.push(...)`添加到了提案数组`proposals`末尾。
proposals.push(Proposal({name: proposalNames[i],
voteCount: 0
}));
}
//给投票人`voter`参加投票的投票权,
//只能由投票主持人`chairperson`调用。
function giveRightToVote(address voter)
{
if (msg.sender != chairperson || voters[voter].voted)
//`throw`会终止和撤销所有的状态和以太改变。
//如果函数调用无效,这通常是一个好的选择。
//但是需要注意,这会消耗提供的所有gas。
throw;
voters[voter].weight = 1;
}
// 委托你的投票权到一个投票代表 `to`。
function delegate(address to)
{
// 指定引用
Voter sender = voters[msg.sender];
if (sender.voted)
throw;
//当投票代表`to`也委托给别人时,寻找到最终的投票代表
while (voters[to].delegate != address(0) &&
voters[to].delegate != msg.sender)
to = voters[to].delegate;
// 当最终投票代表等于调用者,是不被允许的。
if (to == msg.sender)
throw;
//因为`sender`是一个引用,
//这里实际修改了`voters[msg.sender].voted`
sender.voted = true;
sender.delegate = to;
Voter delegate = voters[to];
if (delegate.voted)
//如果委托的投票代表已经投票了,直接修改票数
proposals[delegate.vote].voteCount += sender.weight;
else
//如果投票代表还没有投票,则修改其投票权重。
delegate.weight += sender.weight;
}
///投出你的选票(包括委托给你的选票)
///给 `proposals[proposal].name`。
function vote(uint proposal)
{
Voter sender = voters[msg.sender];
if (sender.voted) throw;
sender.voted = true;
sender.vote = proposal;
//如果`proposal`索引超出了给定的提案数组范围
//将会自动抛出异常,并撤销所有的改变。
proposals[proposal].voteCount += sender.weight;
}
///@dev 根据当前所有的投票计算出当前的胜出提案
function winningProposal() constant
returns (uint winningProposal)
{
uint winningVoteCount = 0;
for (uint p = 0; p < proposals.length; p++)
{
if (proposals[p].voteCount > winningVoteCount)
{
winningVoteCount = proposals[p].voteCount;
winningProposal = p;
}
}
}
}
1.合约定义了俩个结构体,代表投票人的Voter和代表提案的Proposal;与这俩个结构体对应的voters(映射,我的理解是相当于对Voter的一个索引)和proposals(可变数组)分别用于存储投票人结构体和提案结构体。在这里,要找到投票人,需要一个投票人地址(address);而要找到提案,需要一个访问可变数组的索引。
2.address public chairperson指的是创建投票的那个投票人
3.function Ballot(bytes32[] proposalNames)函数用于创建一个新投票,创建人是当前合约的调用者,具体逻辑如下:
a:得到调用者的地址
b:在投票人映射(voters)中找到这个地址,将它的其权重设为1;(这个权重仅代表本次投票)
c:将该地址提供的所有提案(函数的输入参数proposalNames)存储到全局的天数组中
4:function giveRightToVote(address voter)该函数用于给需要投票的人投票权,只是简单的将需要投票的投票人地址的权重置为1(多人投票时,该函数需调用多次)
**5**function delegate(address to)委托投票权给一个投票人(某几个投票人不想投票,选择将自己的权重转让给一个信的过的人(代表)),通过传入的投票人地址找到这个人,分以下情况:
a:该地址已将投票权转让,通过投票人结构体的delegate地址找到最终可以投票的人。
b:未转让但已投票,通过投票人结构体的vote索引找到已投票的提案直接将票投给该提案。
c:未转让未投票,将自己权重加到代表的权重上。(在这之前已经将投票标志(voted)置为true表示自己已投票,丧失投票权)
**6**function vote(uint proposal),投出选票将相应的提案找出,并在得票额上加上投票人的权重。
**7**function winningProposal() constant returns (uint winningProposal),简单的找出一个数组中的最大值,即计算出胜出提案。