以太坊Java开发入门,搭建测试环境与实战指南

• 对于本地开发和测试，最常用的以太坊客户端是 Geth (Go-Ethereum) 或 Parity,我们需要安装一个并启动一个私有测试链或连接到公开的测试网络。
• 安装Geth：访问Geth官方GitHub页面下载对应操作系统的二进制文件,并配置环境变量。
• 启动私有测试链：在命令行中执行类似 geth --datadir "./myethchain" init genesis.json (初始化创世块) 和 geth --datadir "./myethchain" --rpc --rpcaddr "localhost" --rpcport "8545" --rpccorsdomain "*" --dev (启动开发模式节点，开启RPC服务) 的命令，开发模式会自动分配一些测试以太坊,并允许挖矿。

连接以太坊测试节点并进行基础交互

环境搭建完成后,我们就可以编写Java代码来连接以太坊节点了。

1. 连接到以太坊节点： 假设我们之前启动的Geth节点开启了RPC服务，监听localhost:8545。

   import org.web3j.protocol.Web3j;
   import org.web3j.protocol.http.HttpService;
   import org.web3j.utils.Convert;
   import java.math.BigDecimal;
   import java.util.concurrent.ExecutionException;
   public class EthereumJavaConnection {
       public static void main(String[] args) {
           // 连接到本地以太坊节点
           Web3j web3j = Web3j.build(new HttpService("http://localhost:8545"));
           try {
               // 获取最新区块号
               String latestBlockNumber = web3j.ethBlockNumber().send().getBlockNumber().toString();
               System.out.println("Latest Block Number: " + latestBlockNumber);
               // 获取当前gas价格
               BigDecimal gasPrice = web3j.ethGasPrice().send().getGasPrice();
               System.out.println("Current Gas Price: " + Convert.fromWei(gasPrice.toString(), Convert.Unit.GWEI) + " GWEI");
               // 关闭连接
               web3j.shutdown();
           } catch (Exception e) {
               e.printStackTrace();
           }
       }
   }

   运行这段代码，如果成功连接并获取到信息,说明你的Java环境已经可以与以太坊节点通信了。

智能合约的Java测试

智能合约的测试是“以太坊 Java 测试”的核心环节,Web3j提供了强大的工具来简化这一过程。

1. 编译Solidity合约并生成Java包装类： 假设我们有一个简单的SimpleStorage.sol智能合约：

   // SPDX-License-Identifier: MIT
   pragma solidity ^0.8.0;
   contract SimpleStorage {
       uint256 private storedData;
       event ValueChanged(uint256 oldValue, uint256 newValue);
       function set(uint256 x) public {
           uint256 oldValue = storedData;
           storedData = x;
           emit ValueChanged(oldValue, storedData);
       }
       function get() public view returns (uint256) {
           return storedData;
       }
   }

   使用Web3j命令行工具生成Java类：

   web3j solidity generate -a SimpleStorage.bin -b SimpleStorage.binabi -o src/main/java -p com.example.contracts

   这会根据合约的二进制文件(bin)和ABI接口描述(abi)生成Java包装类，位于src/main/java/com/example/contracts目录下，包括SimpleStorage.java和SimpleStorageFactory.java等。

2. 编写Java测试代码： 生成的Java类使得我们可以像调用普通Java方法一样与智能合约交互。

   import org.web3j.protocol.core.methods.response.TransactionReceipt;
   import org.web3j.tuples.generated.Tuple2;
   import org.web3j.tx.Contract;
   import org.web3j.tx.ManagedTransaction;
   import org.web3j.tx.gas.ContractGasProvider;
   import java.math.BigInteger;
   import java.util.concurrent.ExecutionException;
   public class SimpleStorageTest {
       private static final String CONTRACT_ADDRESS = "0x..."; // 部署后的合约地址
       private static final String PRIVATE_KEY = "0x..."; // 用于部署和交易的账户私钥
       public static void main(String[] args) throws Exception {
           // 连接到节点
           Web3j web3j = Web3j.build(new HttpService("http://localhost:8545"));
           // 加载账户
           Credentials credentials = Credentials.create(PRIVATE_KEY);
           // 加载已部署的合约
           SimpleStorage simpleStorage = SimpleStorage.load(
               CONTRACT_ADDRESS, 
               web3j, 
               credentials, 
               ContractGasProvider.DEFAULT // 可以自定义gas价格和限制
           );
           // 测试get()方法
           BigInteger currentValue = simpleStorage.get().send();
           System.out.println("Current stored value: " + currentValue);
           // 测试set()方法
           BigInteger newValue = BigInteger.valueOf(42);
           System.out.println("Setting value to: " + newValue);
           TransactionReceipt receipt = simpleStorage.set(newValue).send();
           System.out.println("Transaction hash: " + receipt.getTransactionHash());
           // 再次验证get()方法
           BigInteger updatedValue = simpleStorage.get().send();
           System.out.println("Updated stored value: " + updatedValue);
           // 验证事件日志（可选）
           Tuple2<BigInteger, BigInteger> logResult = simpleStorage.valueChangedFlowable(receipt.getBlockNumber(), receipt.getBlockNumber()).blockingFirst();
           System.out.println("ValueChanged event - Old: " + logResult.getValue1() + ", New: " + logResult.getValue2());
           web3j.shutdown();
       }
   }

   在运行测试代码之前，你需要先使用Web3j或Truffle等工具将SimpleStorage.sol合约部署到你的测试链上，并将部署后的合约地址填入代码中的CONTRACT_ADDRESS,确保用于交易的账户有足够的ETH支付gas费用。

更高级的测试场景

对于更复杂的测试,可以考虑：

• 使用TestNG或JUnit：将上述交互代码封装成单元测试用例,实现自动化测试。
• Mock以太坊节点：在单元测试中，可以使用如Besu（以太坊客户端，由PegaSys开发，支持Java）的测试