Java以太坊智能合约开发规范.pdfVIP

目 录 序言 开发规范 开发流程 Java智能合约开发示例 底层C++对注解的约束 全文 本文档使用 看云 构建 - 2 - 序言 序言 序言 基于Java语言开发以太坊智能合约的开发规范 本文档使用 看云 构建 - 3 - 开发规范 开发规范 智能合约注解使用说明 注解使用规范 Juice区块链平台提供的Java智能合约分为交易和查询 ，以及其他非合约接口。默认情况下所有的接口都是非 合约接口 （不能直接访问, 不能修改区块链数据 ），保证Java智能合约的编程是面向合约接口的编程。Juice区 块链系统提供两类注解 ， 包括 ： 合约类型注解 ，接口类型注解。 合约类型注解 @Contract ，表示是否为智能合约 ，用来区分是否为可调用智能合约 ，不添加此注解则当作系统内置类处理 注解合约类型注。 接口类型注解 @Transaction ，定义为交易型接口注解 ，即调用了这个接口会发送交易并改变区块链数据 ， 该类型接口建议 不需要返回值 ！ @Call ，定义为非交易类型注解 ，与@Transaction不同 ，它需要返回结果值 ，但是接口不会产生区块链交 易、不会改变区块链数据 ，用户需要获取数据必须通过此类注解接口 ！ 智能合约开发规范说明 合约类 1. 必须使用开发SDK提供的@Contract注解 @Contract public class ExampleContract 2. 必须实现java.io的序列化接口 public class ExampleContract implements Serializable 3. 不可依赖JDK以外的第三方JAR包 本文档使用 看云 构建 - 4 - 开发规范 import org.springframework.stereotype.Controller; 合约方法 1. 合约方法必须使用@Transaction(写方法)或@Call(读方法)注解 @Transaction public void setX(String a) @Call public String getX() 2. 合约方法权限必须为public @Transaction public void setX(String a) 3. 使用@Call(读方法)注解的合约方法必须有返回值 @Call public String getX() 本文档使用 看云 构建 - 5 - 开发流程 开发流程 开发流程 提供基于gradle插件SDK工具包 ，自动生成合约代理类 1.准备开发工具 ide(eclipse, idea) gradle maven jdk 2.下载相关SDK工具包(安装到本地maven库) gradle juice插件 com.juzix.gradlejuice-plugin 1.0 合约代理类生成 com.juzix.generatorjuice-generator 1.0 合约开发SDK com.juzix.utiljuice-util 1.0 web3j org.web3j core 2.1.1 3.新建一个gradle工程 build.gradle 示例 /* * 引入gradle juice插件 */ buildscript { repositories { mavenLocal() mavenCentral() } dependencies { classpath com.juzix.gradle:jui