web3sdk 是什么 Spring Boot Starter怎么用

2024-09-03 08:58

本文主要是介绍web3sdk 是什么 Spring Boot Starter怎么用,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

一、Web3SDK是什么

Web3SDK为FISCO BCOS提供Java API。

利用FISCO BCOS JAVA SDK可以简单快捷的基于FISCO-BCOS进行区块链应用开发。

此版本只支持FISCO BCOS 2.0+。

 

 

 

关键特性

  • 实现FISCO BCOS的JSON-RPC的Java API。
  • 支持预编译合约管理区块链。
  • 支持链上信使协议为联盟链提供安全高效的消息信道。
  • 支持使用国密算法发送交易。

 

源码编译

环境要求:

  • JDK8及以上

一定要安装java8

https://shijianfeng.blog.csdn.net/article/details/116152884

 

  • Gradle 5.0及以上

 

编译运行如下命令:

$ cd web3sdk
$ ./gradlew build

编译结果: 编译的web3sdk jar位于:

web3sdk/dist/apps/web3sdk.jar

文档

  • 英文
  • 中文

快速入门

提供基于SDK的spring boot starter示例项目,示例项目使用了SDK的核心特性, 包括:

  • 如何连接FISCO BCOS区块链节点。
  • 在区块链网络中部署合约。
  • 读取部署合约的变量值。
  • 更新部署合约的变量值。
  • 提供SDK API接口的测试案例。

 

https://gitee.com/FISCO-BCOS/web3sdk/

 

 

二、怎么用

Spring Boot Starter

  该项目是基于Web3SDK的spring boot版本的示例项目。提供FISCO BCOS区块链应用开发的基本框架和基本的测试案例,帮助开发者基于FISCO BCOS区块链快速进行应用开发。此版本只支持FISCO BCOS 2.0+。

 

快速启动

前置条件

搭建FISCO BCOS区块链,具体步骤参考这里。

 

获取源码

git clone https://github.com/FISCO-BCOS/spring-boot-starter.git

 

节点证书配置

将节点所在目录nodes/${ip}/sdk下的ca.crtsdk.crtsdk.key文件拷贝到项目的src/main/resources录下供SDK使用

(FISCO BCOS 2.1以前,证书为ca.crtnode.crtnode.key`)。

 

 

配置文件设置

spring boot项目的配置文件application.yml如下图所示,其中加了注释的内容根据区块链节点配置做相应修改。

encrypt-type: # 0:standard, 1:guomiencrypt-type: 0group-channel-connections-config:caCert: classpath:ca.crtsslCert: classpath:sdk.crtsslKey: classpath:sdk.keyall-channel-connections:- group-id: 1 #group IDconnections-str:- 192.168.64.129:20200 # node listen_ip:channel_listen_port- 192.168.64.131:20200- 192.168.64.132:20200- 192.168.64.130:20200- group-id: 2connections-str:- 127.0.0.1:20202 # node listen_ip:channel_listen_port- 127.0.0.1:20203channel-service:group-id: 1 # The specified group to which the SDK connectsagency-name: agencyA # agency nameaccounts:pem-file: 0xcdcce60801c0a2e6bb534322c32ae528b9dec8d2.pemp12-file: 0x98333491efac02f8ce109b0c499074d47e7779a6.p12password: 123456

 

项目中关于SDK配置的详细说明请参考这里。

 

 

运行

编译并运行测试案例,在项目根目录下运行:

cd spring-boot-starter
./gradlew build
./gradlew test

当所有测试案例运行成功,则代表

  • 区块链运行正常,
  • 该项目通过SDK连接区块链正常。

可以通过这个网址看错误报告file:///home/shijianfeng/fisco/spring-boot-starter/build/reports/tests/test/index.html

开发者可以基于该项目进行具体应用开发。

注:如果在IntelliJ IDEA或Eclipse中运行该demo工程,则使用gradle wrapper模式,此外IntelliJ IDEA需要在设置中开启Annotation Processors功能。

Web3SDK - 常见的异常启动问题错误查看https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/faq/sdk.html?highlight=Web3SDK

 

测试案例介绍

该示例项目提供的测试案例,供开发者参考使用。测试案例主要分为对Web3j API,Precompiled Serveice API、Solidity合约文件转Java合约文件、部署和调用合约的测试。

 

Web3j API测试

提供Web3jApiTest测试类测试Web3j API。示例测试如下:

@Test
public void getBlockNumber() throws IOException {BigInteger blockNumber = web3j.getBlockNumber().send().getBlockNumber();System.out.println(blockNumber);assertTrue(blockNumber.compareTo(new BigInteger("0"))>= 0);
}

温馨提示: Application类初始化了web3j对象,在业务代码需要的地方可用注解的方式直接使用,使用方式如下:

@Autowired
private Web3j web3j

 

Precompiled Service API测试

提供PrecompiledServiceApiTest测试类测试Precompiled Service API。示例测试如下:

@Test
public void testSystemConfigService() throws Exception {SystemConfigSerivce systemConfigSerivce = new SystemConfigSerivce(web3j, credentials);systemConfigSerivce.setValueByKey("tx_count_limit", "2000");String value = web3j.getSystemConfigByKey("tx_count_limit").send().getSystemConfigByKey();System.out.println(value);assertTrue("2000".equals(value));
}

 

Solidity合约文件转Java合约文件测试

提供SolidityFunctionWrapperGeneratorTest测试类测试Solidity合约文件转Java合约文件。示例测试如下:

@Test
public void compileSolFilesToJavaTest() throws IOException {File solFileList = new File("src/test/resources/contract");File[] solFiles = solFileList.listFiles();for (File solFile : solFiles) {SolidityCompiler.Result res = SolidityCompiler.compile(solFile, true, ABI, BIN, INTERFACE, METADATA);System.out.println("Out: '" + res.output + "'");System.out.println("Err: '" + res.errors + "'");CompilationResult result = CompilationResult.parse(res.output);System.out.println("contractname  " + solFile.getName());Path source = Paths.get(solFile.getPath());String contractname = solFile.getName().split("\\.")[0];CompilationResult.ContractMetadata a = result.getContract(solFile.getName().split("\\.")[0]);System.out.println("abi   " + a.abi);System.out.println("bin   " + a.bin);FileUtils.writeStringToFile(new File("src/test/resources/solidity/" + contractname + ".abi"), a.abi);FileUtils.writeStringToFile(new File("src/test/resources/solidity/" + contractname + ".bin"), a.bin);String binFile;String abiFile;String tempDirPath = new File("src/test/java/").getAbsolutePath();String packageName = "org.fisco.bcos.temp";String filename = contractname;abiFile = "src/test/resources/solidity/" + filename + ".abi";binFile = "src/test/resources/solidity/" + filename + ".bin";SolidityFunctionWrapperGenerator.main(Arrays.asList("-a", abiFile,"-b", binFile,"-p", packageName,"-o", tempDirPath).toArray(new String[0]));}System.out.println("generate successfully");
}

该测试案例将src/test/resources/contract目录下的所有Solidity合约文件(默认提供HelloWorld合约)均转为相应的abi和bin文件,保存在src/test/resources/solidity目录下。然后将abi文件和对应的bin文件组合转换为Java合约文件,保存在src/test/java/org/fisco/bcos/temp目录下。SDK将利用Java合约文件进行合约部署与调用。

 

部署和调用合约测试

提供ContractTest测试类测试部署和调用合约。示例测试如下:

@Test
public void deployAndCallHelloWorld() throws Exception {//deploy contractHelloWorld helloWorld = HelloWorld.deploy(web3j, credentials, new StaticGasProvider(gasPrice, gasLimit)).send();if (helloWorld != null) {System.out.println("HelloWorld address is: " + helloWorld.getContractAddress());//call set functionhelloWorld.set("Hello, World!").send();//call get functionString result = helloWorld.get().send();System.out.println(result);assertTrue( "Hello, World!".equals(result));}
}

https://github.com/FISCO-BCOS/spring-boot-starter/blob/master/doc/README_CN.md

这篇关于web3sdk 是什么 Spring Boot Starter怎么用的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1132572

相关文章

JVM 的类初始化机制

前言 当你在 Java 程序中new对象时,有没有考虑过 JVM 是如何把静态的字节码(byte code)转化为运行时对象的呢,这个问题看似简单,但清楚的同学相信也不会太多,这篇文章首先介绍 JVM 类初始化的机制,然后给出几个易出错的实例来分析,帮助大家更好理解这个知识点。 JVM 将字节码转化为运行时对象分为三个阶段,分别是:loading 、Linking、initialization

Spring Security 基于表达式的权限控制

前言 spring security 3.0已经可以使用spring el表达式来控制授权,允许在表达式中使用复杂的布尔逻辑来控制访问的权限。 常见的表达式 Spring Security可用表达式对象的基类是SecurityExpressionRoot。 表达式描述hasRole([role])用户拥有制定的角色时返回true (Spring security默认会带有ROLE_前缀),去

浅析Spring Security认证过程

类图 为了方便理解Spring Security认证流程,特意画了如下的类图,包含相关的核心认证类 概述 核心验证器 AuthenticationManager 该对象提供了认证方法的入口,接收一个Authentiaton对象作为参数; public interface AuthenticationManager {Authentication authenticate(Authenti

Spring Security--Architecture Overview

1 核心组件 这一节主要介绍一些在Spring Security中常见且核心的Java类,它们之间的依赖,构建起了整个框架。想要理解整个架构,最起码得对这些类眼熟。 1.1 SecurityContextHolder SecurityContextHolder用于存储安全上下文(security context)的信息。当前操作的用户是谁,该用户是否已经被认证,他拥有哪些角色权限…这些都被保

Spring Security基于数据库验证流程详解

Spring Security 校验流程图 相关解释说明(认真看哦) AbstractAuthenticationProcessingFilter 抽象类 /*** 调用 #requiresAuthentication(HttpServletRequest, HttpServletResponse) 决定是否需要进行验证操作。* 如果需要验证,则会调用 #attemptAuthentica

Spring Security 从入门到进阶系列教程

Spring Security 入门系列 《保护 Web 应用的安全》 《Spring-Security-入门(一):登录与退出》 《Spring-Security-入门(二):基于数据库验证》 《Spring-Security-入门(三):密码加密》 《Spring-Security-入门(四):自定义-Filter》 《Spring-Security-入门(五):在 Sprin

Java架构师知识体认识

源码分析 常用设计模式 Proxy代理模式Factory工厂模式Singleton单例模式Delegate委派模式Strategy策略模式Prototype原型模式Template模板模式 Spring5 beans 接口实例化代理Bean操作 Context Ioc容器设计原理及高级特性Aop设计原理Factorybean与Beanfactory Transaction 声明式事物

AI绘图怎么变现?想做点副业的小白必看!

在科技飞速发展的今天,AI绘图作为一种新兴技术,不仅改变了艺术创作的方式,也为创作者提供了多种变现途径。本文将详细探讨几种常见的AI绘图变现方式,帮助创作者更好地利用这一技术实现经济收益。 更多实操教程和AI绘画工具,可以扫描下方,免费获取 定制服务:个性化的创意商机 个性化定制 AI绘图技术能够根据用户需求生成个性化的头像、壁纸、插画等作品。例如,姓氏头像在电商平台上非常受欢迎,

W外链微信推广短连接怎么做?

制作微信推广链接的难点分析 一、内容创作难度 制作微信推广链接时,首先需要创作有吸引力的内容。这不仅要求内容本身有趣、有价值,还要能够激起人们的分享欲望。对于许多企业和个人来说,尤其是那些缺乏创意和写作能力的人来说,这是制作微信推广链接的一大难点。 二、精准定位难度 微信用户群体庞大,不同用户的需求和兴趣各异。因此,制作推广链接时需要精准定位目标受众,以便更有效地吸引他们点击并分享链接

Java进阶13讲__第12讲_1/2

多线程、线程池 1.  线程概念 1.1  什么是线程 1.2  线程的好处 2.   创建线程的三种方式 注意事项 2.1  继承Thread类 2.1.1 认识  2.1.2  编码实现  package cn.hdc.oop10.Thread;import org.slf4j.Logger;import org.slf4j.LoggerFactory