Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/niqifan007/fiscobcos-springboot
这是一个整合fisco-bcos和springboot的项目
https://github.com/niqifan007/fiscobcos-springboot
blockchain fisco-bcos
Last synced: 27 days ago
JSON representation
这是一个整合fisco-bcos和springboot的项目
- Host: GitHub
- URL: https://github.com/niqifan007/fiscobcos-springboot
- Owner: niqifan007
- License: apache-2.0
- Created: 2023-03-02T03:50:06.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-08-02T10:15:04.000Z (5 months ago)
- Last Synced: 2024-08-02T11:46:01.316Z (5 months ago)
- Topics: blockchain, fisco-bcos
- Language: Java
- Homepage:
- Size: 81.1 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FISCO BCOS 基于 Spring Boot 的 CRUD 示例项目
本示例项目基于 Java SDK + Maven + Spring Boot 来调用智能合约。该项目仅适配 FISCO BCOS 3.0.x 版本，如果需要适配其他版本，请修改 `pom.xml` 文件中的 `fisco-java-sdk` 版本号。
## 前置条件
搭建 FISCO BCOS 单群组区块链（Air 版本），具体步骤请[参考这里](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/tutorial/air/build_chain.html)。
**注意：** 节点 rc4 版本以后才支持 Table 的 CRUD 接口，之前的版本只能用 KV 接口的功能。
### 获取源码
克隆仓库：
```bash
$ git clone https://github.com/your-repo/spring-boot-crud.git
$ cd spring-boot-crud
```
### 配置节点证书
将节点目录 `nodes/${ip}/sdk` 下的 `ca.crt`、`sdk.crt` 和 `sdk.key` 文件拷贝到项目的 `src/main/resources/conf` 目录下供 SDK 使用（FISCO BCOS 2.1 以前，证书为 `ca.crt`、`node.crt` 和 `node.key`）。
假设节点路径为 `~/fisco/nodes/127.0.0.1`，可使用以下命令拷贝 SDK 证书：
```bash
# 创建证书存放路径
$ mkdir -p src/main/resources/conf
# 拷贝 SDK 证书
$ cp ~/fisco/nodes/127.0.0.1/sdk/* src/main/resources/conf/
```
### 设置配置文件
项目包含 SDK 配置文件（位于 `src/main/resources/applicationContext.xml` 路径）和 WebServer 配置文件（位于 `src/main/resources/application.yml` 路径）。
#### SDK 配置
根据区块链节点的 IP 和端口相应配置 `applicationContext.xml` 的 `network.peers` 配置项：
```xml
127.0.0.1:20200
127.0.0.1:20201
```
在 `applicationContext.xml` 中更新账户地址和密钥路径：
```xml
```
关于 SDK 配置的详细说明请[参考这里](https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/sdk/java_sdk/configuration.html)。
#### WebServer 配置
在 `application.yml` 中更新 WebServer 的监听端口（默认为 `45000`）：
```yml
server:
port: 45000
```
### 编译和安装项目
可以使用 IntelliJ IDEA 导入并编译和安装该项目，也可使用提供的 `mvnw` 脚本在命令行编译项目：
```bash
# 编译项目
$ bash mvnw compile
# 安装项目，安装完毕后，在 target/ 目录下生成 fisco-bcos-spring-boot-crud-0.0.1-SNAPSHOT.jar 的 JAR 包
$ bash mvnw install
```
### 启动 Spring Boot CRUD 服务
**方法一：使用 IntelliJ IDEA**
导入项目至 IntelliJ IDEA，编译并运行 `AppApplication.java` 启动 Spring Boot 服务。
**方法二：使用命令行**
使用生成的 JAR 包启动服务：
```bash
# 启动 Spring Boot CRUD 服务
$ java -jar ./target/fisco-bcos-spring-boot-crud-0.0.1-SNAPSHOT.jar
```
## 访问 Spring Boot Web 服务
服务启动后，可以通过配置的端口（默认是 `45000`）进行访问。
---
此 README 提供了设置和运行基于 Spring Boot 的 CRUD 项目的简要指南。