以太坊宠物商店app.js详解,DApp前端与区块链交互的核心逻辑
以太坊宠物商店(Pet Shop)是Truffle框架官方提供的经典入门教程,被誉为区块链开发者的“Hello World”,在这个项目中,app.js扮演着承上启下的关键角色,它既是前端页面的控制器,又是连接智能合约与浏览器的桥梁,本文将深入剖析app.js的代码结构和工作原理,帮助你真正理解一个去中心化应用(DApp)的运行机制。
app.js在项目中的定位
宠物商店项目的整体架构分为三层:
- 智能合约层:
Adoption.sol,部署在以太坊区块链上,负责记录宠物领养信息; - 前端页面层:
index.html、pets.json,负责展示宠物列表和用户界面; - 交互逻辑层:也就是
app.js,通过web3.js调用智能合约,把用户操作转化为链上交易。
可以说,没有app.js,前端页面只是一具“空壳”,无法与区块链产生任何联系。
app.js的整体结构
app.js采用模块化的App对象进行组织,主要包含以下几个核心方法:
App = {
web3Provider: null,
contracts: {},
init: function() { ... },
initWeb3: function() { ... },
initContract: function() { ... },
bindEvents: function() { ... },
markAdopted: function() { ... },
handleAdopt: function() { ... }
};
$(function() {
$(window).load(function() {
App.init();
});
});
页面加载完成后自动执行App.init(),由此开启一条清晰的初始化链路:init → initWeb3 → initContract。
核心函数逐一解析
init():加载宠物数据
该函数通过jQuery读取pets.json文件,将宠物名称、图片、品种、年龄、所在地等信息填充到页面模板中,实现动态渲染宠物列表。
initWeb3():连接区块链的第一步
这是app.js中最具区块链特色的部分,它负责检测浏览器是否安装了MetaMask等钱包插件:
initWeb3: function() {
if (typeof web3 !== 'undefined') {
App.web3Provider = web3.currentProvider;
} else {
App.web3Provider = new Web3.providers.HttpProvider('http://localhost:7545');
}
web3 = new Web3(App.web3Provider);
return App.initContract();
}
如果检测到注入的web3实例,就直接使用它;否则回退连接本地的Ganache测试网络(端口7545)。
initContract():初始化合约实例
该函数加载编译后生成的Adoption.json文件,利用TruffleContract创建合约抽象实例,并设置Provider,随后调用markAdopted()同步链上状态。
markAdopted():读取链上数据
通过调用合约的getAdopters()方法(只读操作,不消耗Gas),遍历所有领养者地址,若某个宠物的领养地址不是零地址,说明已被领养,前端按钮就会显示"Success"并置灰。
handleAdopt():发送链上交易
当用户点击“Adopt”按钮时触发,该函数先获取当前账户,再调用合约的adopt()方法并发送交易:
web3.eth.getAccounts(function(error, accounts) {
var account = accounts[0];
App.contracts.Adoption.deployed().then(function(instance) {
return adoptionInstance.adopt(petId, {from: account});
}).then(function(result) { 发布于:2026-10-30,除非注明,否则均为原创文章,转载请注明出处。
