实战：集成步骤详解

我们将通过一个完整的示例，展示 Spring Boot 项目如何连接以太坊节点,并与一个简单的智能合约进行交互。

步骤 1：创建 Spring Boot 项目

使用 Spring Initializr 创建一个新的 Maven 项目,并添加以下依赖：

• Spring Web：用于创建 RESTful API。
• Lombok：简化 Java 代码,减少样板代码。

步骤 2：添加以太坊 Java SDK 依赖

我们选择目前最流行和功能最强大的以太坊 Java SDK——Web3j，在 pom.xml 文件中添加以下依赖：

<dependency>
    <groupId>org.web3j</groupId>
    <artifactId>core</artifactId>
    <version>4.9.8</version> <!-- 请使用最新稳定版本 -->
</dependency>
<dependency>
    <groupId>org.web3j</groupId>
    <artifactId>geth</artifactId>
    <version>4.9.8</version>
</dependency>

步骤 3：配置以太坊节点连接

在 src/main/resources/application.properties 文件中,配置你的以太坊节点地址。

# 可选：指定使用的账户，用于发送交易
# 默认会使用节点中第一个可用的账户
# ethereum.account.address=0xYourAccountAddress

步骤 4：创建以太坊服务层

这是核心步骤，我们将创建一个服务类,负责与以太坊网络的所有交互。

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Service;
import org.web3j.protocol.Web3j;
import org.web3j.protocol.core.methods.response.EthBlockNumber;
import org.web3j.protocol.core.methods.response.EthGetBalance;
import org.web3j.protocol.http.HttpService;
import org.web3j.utils.Convert;
import org.web3j.utils.Convert.Unit;
import java.math.BigDecimal;
import java.math.BigInteger;
@Service
public class EthereumService {
    // 通过 @Value 注入配置文件中的节点 URL
    @Value("${ethereum.node.url}")
    private String nodeUrl;
    // Web3j 实例，在服务启动时初始化
    private Web3j web3j;
    // 使用 @PostConstruct 在 Bean 初始化后执行
    public void init() {
        this.web3j = Web3j.build(new HttpService(nodeUrl));
        System.out.println("Successfully connected to Ethereum node: " + nodeUrl);
    }
    /**
     * 获取最新区块号
     */
    public BigInteger getLatestBlockNumber() throws Exception {
        EthBlockNumber ethBlockNumber = web3j.ethBlockNumber().send();
        return ethBlockNumber.getBlockNumber();
    }
    /**
     * 获取指定地址的以太币余额
     * @param address 以太坊地址
     */
    public BigDecimal getBalance(String address) throws Exception {
        EthGetBalance ethGetBalance = web3j.ethGetBalance(address, org.web3j.protocol.core.DefaultBlockParameterName.LATEST).send();
        BigInteger weiBalance = ethGetBalance.getBalance();
        // 将 Wei 转换为 Ether
        return Convert.fromWei(new BigDecimal(weiBalance), Unit.ETHER);
    }
}

步骤 5：创建 RESTful API 控制器

我们将服务层暴露为 HTTP 接口,供前端调用。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import java.math.BigInteger;
@RestController
@RequestMapping("/api/eth")
public class EthereumController {
    @Autowired
    private EthereumService ethereumService;
    @GetMapping("/blockNumber")
    public BigInteger getBlockNumber() throws Exception {
        return ethereumService.getLatestBlockNumber();
    }
    @GetMapping("/balance/{address}")
    public String getBalance(@PathVariable String address) throws Exception {
        BigDecimal balance = ethereumService.getBalance(address);
        return "Balance of " + address + " is: " + balance.toPlainString() + " ETH";
    }
}

步骤 6：测试集成

1. 运行你的 Spring Boot 应用。

2. 使用 Postman 或浏览器访问以下 API：

   • GET http://localhost:8080/api/eth/blockNumber 你将看到当前连接的测试网的最新区块号。
   • GET http://localhost:8080/api/eth/balance/0xYourTestAccountAddress 将 0xYourTestAccountAddress 替换为你在测试网上的一个地址，你将看到该地址的 ETH 余额。

至此，你已经成功地将 Spring Boot 与以太坊节点连接起来了！

进阶：与智能合约交互

与节点交互只是基础，真正的 DApp 核心在于与智能合约的交互,以下是高级步骤：

编译智能合约并生成 Java 包装类

假设你有一个简单的 SimpleStorage.sol 合约：

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
contract SimpleStorage {
    uint256 private myNumber;
    function set(uint256 _newNumber) public {
        myNumber = _newNumber;
    }
    function get() public view returns (uint256) {
        return myNumber;
    }
}

使用 Web3j 命令行工具为其生成 Java 包装类：

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

这会在 src/main/java/com/yourpackage/contracts 目录下生成 SimpleStorage.java 等文件。

在服务中加载合约并调用方法

修改 EthereumService,添加加载合约和调用合约的方法。

// ... 其他 imports
import org.web3j.protocol.core.methods.response.TransactionReceipt;
import org.web3j.tx.g