本文共 6514 字,大约阅读时间需要 21 分钟。
web3j是一个轻量级、高度模块化、响应式、类型安全的Java和Android类库提供丰富API,用于处理以太坊智能合约及与以太坊网络上的客户端(节点)进行集成。
可以通过它进行以太坊区块链的开发,而无需为你的java应用平台编写集成代码。
想要快速启动的话,有一个可用,演示了通过Web3j开发以太坊的许多核心特征,其中包括:
首先将最新版本的web3j安装到项目中。
Java 8:
org.web3j core 3.4.0
Android:
org.web3j core 3.3.1-android
Java 8:
compile ('org.web3j:core:3.4.0')
Android:
compile ('org.web3j:core:3.3.1-android')
需要启动一个以太坊客户端,当然如果你已经启动了就不需要再次启动。
如果是的话这么启动:
$ geth --rpcapi personal,db,eth,net,web3 --rpc --rinkeby
如果是启动:
$ parity --chain testnet
如果使用客户端提供的免费的云端服务,这么启动:
Web3j web3 = Web3j.build(new HttpService("https://morden.infura.io/your-token"));
如果想进一步的了解infura,请参阅。
在网络上如何获得以太币的相关文档可以看这个:。
当不需要Web3j实例时,需要调用shutdown
方法来释放它所使用的资源。
web3.shutdown()
发送同步请求
Web3j web3 = Web3j.build(new HttpService()); // defaults to http://localhost:8545/Web3ClientVersion web3ClientVersion = web3.web3ClientVersion().send();String clientVersion = web3ClientVersion.getWeb3ClientVersion();
* 使用CompletableFuture (Future on Android) 发送异步请求*
Web3j web3 = Web3j.build(new HttpService()); // defaults to http://localhost:8545/Web3ClientVersion web3ClientVersion = web3.web3ClientVersion().sendAsync().get();String clientVersion = web3ClientVersion.getWeb3ClientVersion();
*使用RxJava的Observable
Web3j web3 = Web3j.build(new HttpService()); // defaults to http://localhost:8545/web3.web3ClientVersion().observable().subscribe(x -> { String clientVersion = x.getWeb3ClientVersion(); ...});
注意Android使用方式
Web3j web3 = Web3jFactory.build(new HttpService()); // defaults to http://localhost:8545/...
Web3j还支持通过文件套接字快速运行进程间通信(IPC),支持客户端在相同的主机上同时运行Web3j。在创建服务时,使用相关的IPCService
就可以实现而不需要通过HTTPService
。
// OS X/Linux/Unix:Web3j web3 = Web3j.build(new UnixIpcService("/path/to/socketfile"));...// WindowsWeb3j web3 = Web3j.build(new WindowsIpcService("/path/to/namedpipefile"));...
需要注意:IPC通信在web3j-android中不可用。
Web3j可以自动打包智能合同代码,以便在不脱离JVM的情况下进行以太坊智能合同部署和交互。
要打包代码,需要先编译智能合同:
$ solc.sol --bin --abi --optimize -o /
然后用打包代码:
web3j solidity generate /path/to/.bin /path/to/ .abi -o /path/to/src/main/java -p com.your.organisation.name
接下来就可以新建和部署智能合约了:
Web3j web3 = Web3j.build(new HttpService()); // defaults to http://localhost:8545/Credentials credentials = WalletUtils.loadCredentials("password", "/path/to/walletfile");YourSmartContract contract = YourSmartContract.deploy(, , GAS_PRICE, GAS_LIMIT, , ..., ).send(); // constructor params
或者使用一个现有的智能合约:
YourSmartContract contract = YourSmartContract.load( "0x|", , , GAS_PRICE, GAS_LIMIT);
然后就可以进行智能合约的交互了:
TransactionReceipt transactionReceipt = contract.someMethod(, ...).send();
调用智能合约:
Type result = contract.someMethod(, ...).send();
更多关于打包的资料可以看这里:
web3j的响应式函数可以使观察者通过事件去通知消息订阅者变得很简单,并能够记录在区块链中。接收所有新的区块并把它们添加到区块链中:
Subscription subscription = web3j.blockObservable(false).subscribe(block -> { ...});
接收所有新的交易并把它们添加到区块链中:
Subscription subscription = web3j.transactionObservable().subscribe(tx -> { ...});
接收所有已经提交到网络中等待处理的交易。(他们被统一的分配到一个区块之前。)
Subscription subscription = web3j.pendingTransactionObservable().subscribe(tx -> { ...});
或者你重置所有的区块到最新的位置,那么当有新建区块的时候会通知你。
Subscription subscription = catchUpToLatestAndSubscribeToNewBlocksObservable(, ) .subscribe(block -> { ...});
主题过滤也被支持:
EthFilter filter = new EthFilter(DefaultBlockParameterName.EARLIEST, DefaultBlockParameterName.LATEST,) .addSingleTopic(...)|.addOptionalTopics(..., ...)|...;web3j.ethLogObservable(filter).subscribe(log -> { ...});
当不再需要时,订阅也应该被取消:
subscription.unsubscribe();
注意:Infura中不支持filters。
需要了解更多有关过滤器和事件的信息可以查看和的接口。
Web3j支持使用以太坊钱包文件(推荐的)和用于发送事务的以太坊客户端管理命令。
使用以太钱包文件发送以太币给其他人:
Web3j web3 = Web3j.build(new HttpService()); // defaults to http://localhost:8545/Credentials credentials = WalletUtils.loadCredentials("password", "/path/to/walletfile");TransactionReceipt transactionReceipt = Transfer.sendFunds( web3, credentials, "0x|", BigDecimal.valueOf(1.0), Convert.Unit.ETHER) .send();
或者你希望建立你自己定制的交易:
Web3j web3 = Web3j.build(new HttpService()); // defaults to http://localhost:8545/Credentials credentials = WalletUtils.loadCredentials("password", "/path/to/walletfile");// get the next available nonceEthGetTransactionCount ethGetTransactionCount = web3j.ethGetTransactionCount( address, DefaultBlockParameterName.LATEST).send();BigInteger nonce = ethGetTransactionCount.getTransactionCount();// create our transactionRawTransaction rawTransaction = RawTransaction.createEtherTransaction( nonce,, , , );// sign & send our transactionbyte[] signedMessage = TransactionEncoder.signMessage(rawTransaction, credentials);String hexValue = Numeric.toHexString(signedMessage);EthSendTransaction ethSendTransaction = web3j.ethSendRawTransaction(hexValue).send();// ...
使用Web3j的进行以太币交易要简单得多。
使用以太坊客户端的管理命令(如果你的钱包密钥已经在客户端存储):
Admin web3j = Admin.build(new HttpService()); // defaults to http://localhost:8545/PersonalUnlockAccount personalUnlockAccount = web3j.personalUnlockAccount("0x000...", "a password").sendAsync().get();if (personalUnlockAccount.accountUnlocked()) { // send a transaction}
如果你想使用 或者 功能, 或者 Geth’s 客户端 APIs,可以使用org.web3j:parity
和org.web3j:geth
模块。
web3j的jar包为每一个版本都提供命令行工具。命令行工具允许你直接通过一些命令使用web3j的一些功能:
请参阅以获得命令行相关的进一步的信息。
java8 bulid:
在java 8的Android版本:
Response.getResult()
获取字符串类型的数量结果。includeRawResponse
参数将原生的JSON包放置在响应中。原文请访问:开发以太坊智能合约快速入门
安利两个教程:
1.,java和android app开发以太坊区块链类库web3j开发详解。 2.,主要介绍智能合约与dapp应用开发,适合入门。 3.,主要是介绍使用node.js、mongodb、区块链、ipfs实现去中心化电商DApp实战,适合进阶。转载地址:http://rrnnx.baihongyu.com/