web3j是一个轻量级的以太坊Java开发包,可用于桌面、服务器或手机应用中实现对以太坊区块链智能合约的访问。web3j开发环境包括开发测试用的节点以及web3j开发栈,本文将介绍如何在自己的机器上搭建web3j开发环境。
web3j开发环境的搭建分为以下几个步骤:
- 安装以太坊开发节点:Ganache
- 安装Java开发套件:OpenJDK
- 安装Java项目构建工具:Gradle
- 安装智能合约命令行工具:Solc和Web3j
- web3j应用开发调试:hello web3j
1. 安装以太坊开发节点
web3j通过标准的以太坊RPC接口访问节点区块链,因此可以对接各种节点软件例如geth或parity等。不过通常在开发过程中我们使用开发节点Ganache,它无须从网络同步区块数据,非常适合开发过程中的快速验证。
使用npm安装ganache:
代码语言:javascript复制~$ npm install -g ganache-cli
安装完毕,直接执行即可启动节点:
代码语言:javascript复制~$ ganache-cli
2. 安装JDK
安装openjdk或oracle的jdk都可以。在ubuntu下可以使用apt直接安装:
代码语言:javascript复制~$ sudo apt-get install openjdk-8-jdk
安装完毕,使用下面命令验证安装成功:
代码语言:javascript复制~$ java -version
3. 安装Gradle
web3j支持maven或gradle作为项目构建工具。本文以gradle为例进行说明。
从gradle官网下载最新版的预编译包,然后解压、配置环境变量即可:
代码语言:javascript复制~$ wget https://gradle.org/next-steps/?version=5.1&format=bin
~$ mkdir /opt/gradle
~$ unzip -d /opt/gradle gradle-5.1-bin.zip
~$ echo PATH=/opt/gradle/bin:$PATH >> .bashrc
~$ source .bashrc
验证安装:
代码语言:javascript复制~$ gradle -version
4. 安装智能合约开发工具
智能合约的开发工具包括以下两个命令行软件:
- solc:solidity智能合约编译器,官方下载
- web3j:web3j命令行工具,官方下载
solc下载后直接可运行,例如验证安装:
代码语言:javascript复制~$ solc
web3j命令行工具下载后先用unzip解压,然后执行其中的web3j即可。例如:
代码语言:javascript复制~$ web3j
这两个工具主要用于solidity智能合约的处理,我们暂时忽略。
5. hello,web3j
现在我们可以创建一个目录,以及App.java和build.gradle文件,来实现web3j的hello world应用:
代码语言:javascript复制~$ mkdir hubwiz && cd hubwiz
~/hubwiz$ touch App.java build.gradle
编写如下的App.java:
代码语言:javascript复制package com.hubwiz.demo;
import org.web3j.protocol.Web3j;
import org.web3j.protocol.http.HttpService;
import org.web3j.protocol.core.Request;
import org.web3j.protocol.core.methods.request.*;
import org.web3j.protocol.core.methods.response.*;
public class App{
public static void main(String[] args) throws Exception{
Web3j web3j = Web3j.build(new HttpService("http://localhost:8545"));
Request<?,Web3ClientVersion> request = web3j.web3ClientVersion();
Web3ClientVersion web3ClientVersion = request.send();
String clientVersion = web3ClientVersion.getWeb3ClientVersion();
System.out.println(clientVersion);
}
}
然后再build.gralde中声明依赖包:
代码语言:javascript复制dependencies {
compile 'org.web3j:core:3.3.0',
'ch.qos.logback:logback-core:1.2.3',
'ch.qos.logback:logback-classic:1.2.3'
}
现在打开一个终端,启动节点:
代码语言:javascript复制~$ ganache-cli
然后打开另一个终端,运行我们的java应用:
代码语言:javascript复制~/hubwiz$ gradle run
如果你看到这个简单的web3j以太坊应用在终端成功输出节点软件ganache的版本信息,就表示我们的web3j开发环境搭建成功了!