长安链Docker Java智能合约引擎的架构、应用与规划

#功能发布

长安链3.0正式版发布了多个重点功能，包括共识算法切换、支持java智能合约引擎、支持后量子密码、web3生态兼容等。我们接下来为大家详细介绍新功能的设计、应用与规划。

在《2022年度长安链开源社区开发者调研报告》中，对Java合约语言支持是开发者更为普遍的需求；《2023年中国开发者调研报告》显示，熟悉Java语言的开发者占到40%以上，尤其在传统行业应用中为应对使用区块链技术进行数字化转型的需求，支持java语言合约将使区块链技术更快的渗透到各行各业。

Docker Go上线以来，因其良好的可移植性，可扩展性和安全性获得较多使用，更因其支持使用原生的Go语言编写合约，有更好的易用性。

在企业客户的使用中Java语言的使用更为广泛，因此在长安链v3.0.0正式版中新增Docker Java合约引擎，支持使用原生Java语言编写合约。

 1. 整体架构 

Docker Java合约引擎的设计复用了Docker Go的架构。依然是采用抢占式任务调度和多个合约进程并发，单个合约进程串行执行交易的形式运行。更详细的设计可以参考长安链 VM Engine架构设计深度解读。

Docker Java 和 Docker Go 合约引擎互不冲突，可以同时启用。部署和连接方式如下图所示：

图片

 2. 编写Java合约 

2.1 版本和工具

当前合约执行环境为JDK 11，推荐使用JDK 11编写合约；推荐使用 IDEA 或 Vscode等IDE编写和编译Java合约。

2.2 引用合约sdk

2.2.1 添加依赖包
在gradle项目中使用SDK

在build.gradle 中添加dependencies：

implementation group:'org.chainmaker', name:'contracts-sdk-java', version:'1.0'

在Maven项目中使用SDK

在pom.xml 中添加dependencies：

<dependency>

    <groupId>org.chainmaker</groupId>

    <artifactId>contracts-sdk-java</artifactId>

    <version>1.0</version>

</dependency>

2.2.2 本地编译包

将项目引入到本地并编译安装到本地maven库：

git clone -b v3.0.0 https://git.chainmaker.org.cn/chainmaker/contract-sdk-java.git

cd contract-sdk-javamvn clean install  

'-Dmaven.test.skip=true'

然后通过添加依赖包引入到合约开发项目。

2.3 合约编写规则 

2.3.1 合约必须实现接口 IContract

合约必须需要实现合约初始化方法（initContract） 和合约升级方法（upgradeContract）。

IContract 中定义了默认的 initContract 和 upgradeContract 的接口。默认这两个接口只返回成功的message。

合约可以根据需求自行实现这两个接口。

2.3.2 代码的执行入口

在合约类定义的main方法中，需要将合约实例作为参数传给sanbox.serve：

publicclass fact implementsIContract{

    // ... 

   publicstaticvoidmain(String[] args){

        Sandbox.serve(args,newfact());

    }

}

2.3.3 定义合约方法

在合约类中定义合约方法，方法权限必须是public，返回值为Response，并且使用@ContractMethod注解标识。在链上调用中，指定的合约方法名与定义的方法名同名（区分大小写）：

 @ContractMethod

    publicResponsesave()throwsIOException,

ContractException{

SDK.putState("key1","field1", 

SDK.getParam("value"));

        return SDK.success("store success");

   }

2.3.4 获取合约的调用参数

（1）使用SDK.getArgs()获取参数map

// 获取参数map

Map<String, ByteString> args = SDK.getArgs();

// 获取参数 key的值, 如果不存在则报错

ByteString getKey = args.get("key");

if(getKey ==null){

   return SDK.error("key not exist");

}

String key = getKey.toStringUtf8();

// 获取参数 value 的值, 如果不存在使用空字符串

ByteString getField = args.get("field");

String field = getField ==null?"": getField.toStringUtf8();

（2）使用SDK.getParam() 和 SDK.getParamBytes()

注意：getParam 和 getParamBytes 不做null值的判断，假如参数值没有传递，则分别返回空字符串和空字节数组：

String key = SDK.getParam("key");

byte[] value = SDK.getParamBytes("value");

2.3.5 错误捕获

合约报错中ContractException中包含了正常逻辑的报错，主要包括参数的合法性检查（比如key 和field），和链上接口访问遇到的报错（比如访问的value不存在等）。因此在合约逻辑中，建议捕获ContractException，并在合约里做相应的处理。

2.4 合约编译

合约需要编译成可独立运行的jar包（包含运行所需的依赖，也叫fat jar 或uber jar）。由于包含了所有依赖，因此合约体积也较大，大概30MB左右。

2.4.1 gradle 打包方式

配置示例如下，执行./gradlew uberJar，默认生成的jar包在build/libs目录下，文件名以-uber.jar为结尾。

<plugin>

    <groupId>org.apache.maven.plugins</groupId>

    <artifactId>maven-shade-plugin</artifactId>

    <version>3.4.0</version>

    <executions>

        <execution>

            <phase>package</phase>

            <goals>

                <goal>shade</goal>

            </goals>

            <configuration>

                <filters>

                    <filter>

                        <artifact>*:*</artifact>

                        <excludes>

                            <exclude>META-INF/*.SF</exclude>

                            <exclude>META-INF/*.DSA</exclude>

                            <exclude>META-INF/*.RSA</exclude>

                        </excludes>

                    </filter>

                </filters>

                <transformers>

                    <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>

                    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">

                        

                      <mainClass>org.chainmaker.examples.demo</mainClass>

                    </transformer>

                </transformers>

            </configuration>

        </execution>

    </executions>

</plugin>

2.4.2 maven 打包方式

使用maven-shade-plugin。配置示例如下。

执行 mvn package，默认生成的jar包在target目录下：

<plugin>

    <groupId>org.apache.maven.plugins</groupId>

    <artifactId>maven-shade-plugin</artifactId>

    <version>3.4.0</version>

    <executions>

        <execution>

            <phase>package</phase>

            <goals>

                <goal>shade</goal>

            </goals>

            <configuration>

                <filters>

                    <filter>

                        <artifact>*:*</artifact>

                        <excludes>

                            <exclude>META-INF/*.SF</exclude>

                            <exclude>META-INF/*.DSA</exclude>

                            <exclude>META-INF/*.RSA</exclude>

                        </excludes>

                    </filter>

                </filters>

                <transformers> 

                  <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>

                    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">

                        

                      <mainClass>org.chainmaker.examples.demo</mainClass>

                    </transformer>

                </transformers>

            </configuration>

        </execution>

    </executions>

</plugin>

示例合约 

示例合约可以直接查看仓库的样例contracts-sdk-java（链接地址：https://git.chainmaker.org.cn/chainmaker/contract-sdk-java/-/tree/v3.0.0/src/main/java/org/chainmaker/examples）。

一个完整的简单存证合约可以如下：

packageorg.chainmaker.examples;

importcom.google.protobuf.ByteString;

importorg.chainmaker.contracts.docker.java.pb.proto.Response;

importorg.chainmaker.contracts.docker.java.sandbox.IContract;

importorg.chainmaker.contracts.docker.java.sandbox.ContractException;

importorg.chainmaker.contracts.docker.java.sandbox.SDK;

importorg.chainmaker.contracts.docker.java.sandbox.Sandbox;

importorg.chainmaker.contracts.docker.java.sandbox.annotaion.ContractMethod;

importjava.io.IOException;

// 实现智能合约接口 IContract

publicclass fact implementsIContract{

   // 使用@ContractMethod注解定义合约方法：save

   @ContractMethod

   publicResponsesave()throwsIOException,ContractException{

       // 获取参数：key

       String key = SDK.getParam("key");

       // 获取参数：value

       byte[] value = SDK.getParamBytes("value");

       // 将键值对存储到链上

        SDK.putState(key, value);

       // 返回成功信息

       return SDK.success("store success");

   }

   // 定义合约方法：get

   @ContractMethod

   publicResponseget()throwsIOException,InterruptedException,ContractException{

       // 获取参数：key

       String key = SDK.getParam("key");

       // 从链上获取对应的值并返回

       return SDK.success(SDK.getState(key));

   }

   // 主函数，启动智能合约

   publicstaticvoidmain(String[] args){

       Sandbox.serve(args,newfact());

   }

}

 接口支持 

目前提供了与Docker Go接口功能一致的所有接口。但是为了遵循Java语言的风格，与Docker Go接口略有不同：

1. 支持函数重载，因此没有Go接口中略显冗余的GetState，GetStateByte，GetStateFromKey，GetStateFromKeyByte等接口，而是函数名统一使用getState。

2. 2. 函数名首字母使用小写。

具体接口列表可以查看文档链接：https://docs.chainmaker.org.cn/v3.0.0/html/instructions/%E4%BD%BF%E7%94%A8Java%E8%BF%9B%E8%A1%8C%E6%99%BA%E8%83%BD%E5%90%88%E7%BA%A6%E5%BC%80%E5%8F%91.html#id15

 下一步规划 

目前对于Docker Java下一步的主要规划是：

1. 优化合约创建效率。因Docker Java的合约体积较大，未来会选择支持源码安装的合约创建方案，以降低创建合约对其他交易产生的性能影响；

2. 优化Docker Java交易执行效率。因JVM的启动相对较慢，以进程方式做调度对Docker Java的交易执行效率影响较大。

如果您对Docker Java有更多建议，欢迎提交issue或在社群联系我们。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/news/756791.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

51单片机—直流电机

51单片机—直流电机

1.元件介绍 2.驱动电路 3.电机调速 一般会保证一个周期的时间是一样的 应用&#xff1a; 1.LED呼吸灯 #include <REGX52.H>sbit LEDP2^0;void Delay(unsigned int t) {while(t--); } void main() {unsigned char Time,i;while(1){for(Time0;Time<100;Time){for(i0;…
阅读更多...
【前端寻宝之路】学习和总结HTML的标签属性

【前端寻宝之路】学习和总结HTML的标签属性

&#x1f308;个人主页: Aileen_0v0 &#x1f525;热门专栏: 华为鸿蒙系统学习|计算机网络|数据结构与算法|MySQL| ​&#x1f4ab;个人格言:“没有罗马,那就自己创造罗马~” 前些天发现了一个巨牛的人工智能学习网站&#xff0c;通俗易懂&#xff0c;风趣幽默&#xff0c;忍不…
阅读更多...
Linux-Arm环境下配置编译qt-everywhere及交叉编译环境

Linux-Arm环境下配置编译qt-everywhere及交叉编译环境

前言 最近在搞交叉编译的事&#xff0c;手上拿了个同事的香橙派玩交叉编译&#xff0c;现在来到了第一步&#xff0c;就是先在arm上配置qt的开发环境。当然了Qt没有直接提供qt on arm&#xff0c;而是需要自行在arm环境下编译一个qt环境出来&#xff0c;所以这里需要使用到qt提…
阅读更多...
【Linux】vim详细介绍（四）

【Linux】vim详细介绍（四）

文章目录 什么是 vimvim的主要功能&#xff1a;vim的三种模式.viminfo和.vimrc文件 什么是 vim 点击跳转至官网了解更多 Vim是一款功能强大的文本编辑器&#xff0c;适用于各种编程和文本处理任务&#xff0c;最初由Bram Moolenaar开发于1991年。它是Vi编辑器的增强版&#xf…
阅读更多...
GitHub Copilot+ESP开发实战-串口

GitHub Copilot+ESP开发实战-串口

上篇文章讲了GitHub Copilot在应用中可能遇到的问题&#xff0c;接下来小启就简单介绍下GitHub Copilot在ESP32开发中C语言实现串口功能&#xff0c;感兴趣的可以看看。 一、向Copilot提问&#xff1a; 1. ESP32用C语言实现串口初始化&#xff1b; 2.配置uart为1&#xff0c…
阅读更多...
【Thread 线程】线程的方法与状态

【Thread 线程】线程的方法与状态

SueWakeup 个人中心&#xff1a;SueWakeup 系列专栏&#xff1a;学习Java 个性签名&#xff1a;保留赤子之心也许是种幸运吧 本文封面由 凯楠&#x1f4f7; 友情赞助播出&#xff01; 目录 一个线程的生命周期 线程终止的原因 线程的方法 Thread 类的静态方法 1. 设置线程…
阅读更多...
59、服务攻防——中间件安全CVE复现IISApacheTomcatNginx

59、服务攻防——中间件安全CVE复现IISApacheTomcatNginx

文章目录 中间件——IIS漏洞中间件——Nginx漏洞中间件——Apache中间件——Tomcat 中间件&#xff1a;IIS、Apache、Nginx、Tomcat、Docker、Weblogic、JBoss、WebSphere、Jenkinsphp框架&#xff1a;Laravel、Thinkphppythonl框架&#xff1a;Flaskjs框架&#xff1a;jQueryj…
阅读更多...
【Unity】从0到1的横版2d制作笔记-DAY1

【Unity】从0到1的横版2d制作笔记-DAY1

写在前面&#xff1a; 感谢旻子提供的Unity2d课程捏&#xff0c;红豆泥阿里嘎多 创建项目 测试Visual Studio的使用 右键选择【create】&#xff0c;右键创建C# Script&#xff0c;待文件创建完毕后双击查看能否正确跳转。 正确跳转的结果是能看见代码中注释标注有&#xff1a;…
阅读更多...
mysql - 查询成本 - 优化器

mysql - 查询成本 - 优化器

查询成本 我们之前老说MySQL执行一个查询可以有不同的执行方案&#xff0c;它会选择其中成本最低&#xff0c;或者说代价最低的那种方案去真正的执行查询。不过我们之前对成本的描述是非常模糊的&#xff0c;其实在MySQL中一条查询语句的执行成本是由下边这两个方面组成的&…
阅读更多...
分布式搜索引擎elasticsearch专栏二

分布式搜索引擎elasticsearch专栏二

上一篇的传送门&#xff1a; 分布式搜索引擎elasticsearch专栏一-CSDN博客 这一篇博文主要讲解elasticsearch的数据搜索功能。下面会分别使用DSL和RestClient实现搜索。 1.DSL查询文档 elasticsearch的查询依然是基于JSON风格的DSL来实现的。 1.1.DSL查询分类 Elasticsea…
阅读更多...
[PwnThyBytes 2019]Baby_SQL

[PwnThyBytes 2019]Baby_SQL

[PwnThyBytes 2019]Baby_SQL 查看源码发现 下载源码&#xff0c;首先观察index.php 首先进入index.php&#xff0c;会执行session_start();启动session这里通过foreach将所有的环境变量的值都遍历了一遍&#xff0c;并且都使用了addslashes()进行转义&#xff0c;然后就定义了…
阅读更多...
GO语言：函数、方法、面向对象

GO语言：函数、方法、面向对象

本文分享函数的定义、特性、defer陷阱、异常处理、单元测试、基准测试等以及方法和接口相关内容 1 函数 函数的定义 func 函数名(参数列表) (返回值列表) { // 函数体&#xff08;实现函数功能的代码&#xff09; } 匿名函数的定义就是没有函数名&#xff0c;可以当做一个函…
阅读更多...
使用华为云HECS服务器+nodejs开启web服务

使用华为云HECS服务器+nodejs开启web服务

简介: 在华为云HECS服务器上使用nodejs开启一个web服务。 目录 1.开通华为云服务器 2.远程登录 2.1 使用华为官方的网页工具登录 ​编辑 2.2 使用MobaXterm登录 3 安装node 3.1 下载 2. 配置环境变量 4. 安装express模块 5.开启外网访问 1.开通华为云服务器 这…
阅读更多...
MySQL与金蝶云星空对接集成SELECT语句连通销售订单新增(销售订单集成测试)

MySQL与金蝶云星空对接集成SELECT语句连通销售订单新增(销售订单集成测试)

MySQL与金蝶云星空对接集成SELECT语句连通销售订单新增(销售订单集成测试) ​​ ​​ 数据源系统:MySQL MySQL是一个关系型数据库管理系统&#xff0c;由瑞典MySQLAB公司开发&#xff0c;属于Oracle旗下产品。MySQL是最流行的关系型数据库管理系统之一&#xff0c;在WEB应用方…
阅读更多...
ASPICE规范之系统追溯矩阵

ASPICE规范之系统追溯矩阵

系统追溯矩阵的需求来自 ISO26262 举例在描述系统追溯矩阵时&#xff1a;客户需求->系统需求&#xff1b;系统需求->客户需求&#xff1b;系统需求->软件需求&#xff1b;系统需求->硬件需求
阅读更多...
【LabVIEW FPGA入门】使用FPGA实现串行同步接口（SSI）

【LabVIEW FPGA入门】使用FPGA实现串行同步接口（SSI）

SSI&#xff08;串行同步接口&#xff09;是连接绝对位置传感器和控制器的广泛应用的串行接口。SSI利用控制器发出一个时钟脉冲序列&#xff0c;初始化传感器的门限输出。 传感器不断更新位置数据&#xff0c;并传送到移位寄存器中。在每一个时钟脉冲序列之间&#xff…
阅读更多...
在Ubuntu20.04（原为cuda12.0， gcc9.几版本和g++9.几版本）下先安装cuda9.0后再配置gcc-5环境

在Ubuntu20.04（原为cuda12.0， gcc9.几版本和g++9.几版本）下先安装cuda9.0后再配置gcc-5环境

因为自己对Linux相关操作不是很熟悉&#xff0c;所以因为之前的代码报错之后决定要安cuda9.0&#xff0c;于是先安装了cuda9.0。里面用到的一些链接&#xff0c;链接文件夹时直接去copy它的路径&#xff0c;就不那么容易错了。 今天运行程序之后发现gcc环境不太匹配cuda9.0&am…
阅读更多...
FX-数组的使用

FX-数组的使用

1一维数组 1.1一维数组的创建和初始化 1.1.1数组的创建 //代码1 int arr1[10]; char arr2[10]; float arr3[1]; double arr4[20]; //代码2 //用宏定义的方式 #define X 3 int arr5[X]; //代码3 //错误使用 int count 10; int arr6[count];//数组时候可以正常创建&#xff1…
阅读更多...
【十三】【算法分析与设计】二分查找（1）

【十三】【算法分析与设计】二分查找（1）

704. 二分查找 给定一个 n 个元素有序的&#xff08;升序&#xff09;整型数组 nums 和一个目标值 target &#xff0c;写一个函数搜索 nums 中的 target&#xff0c;如果目标值存在返回下标&#xff0c;否则返回 -1。 示例 1: 输入: nums [-1,0,3,5,9,12], target 9 输出: 4…
阅读更多...
win10笔记本在显示设置中不慎将主显示器禁用掉导致开机黑屏的解决方案

win10笔记本在显示设置中不慎将主显示器禁用掉导致开机黑屏的解决方案

因为笔记本电脑的显示扩展接口有问题&#xff0c;所以在电脑开机之后&#xff0c;会误识别出几个不存在的扩展屏幕&#xff0c;所以我就想从显示设置中将这几个误识别出来的扩展屏幕禁用掉&#xff08;不然鼠标总是移动到主屏幕边界之外的地方&#xff09;&#xff0c;在显示设…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023