统一返回值

在前后端分离大行其道的今天，有一个统一的返回值格式不仅能使我们的接口看起来更漂亮，而且还可以使前端可以统一处理很多东西，避免很多问题的产生。

比较通用的返回值格式如下：

public class Result<T> {
    // 接口调用成功或者失败
    private Integer code = 0;
    // 失败的具体code
    private String errorCode = "";
    // 需要传递的信息，例如错误信息
    private String msg;
    // 需要传递的数据
    private T data;
    ...
}

最原始的接口如下：

    @GetMapping("/test")
    public User test() {
        return new User();
    }

当我们需要统一返回值时，可能会使用这样一个办法：

    @GetMapping("/test")
    public Result test() {
        return Result.success(new User());
    }

这个方法确实达到了统一接口返回值的目的，但是却有几个新问题诞生了：

• 接口返回值不明显，不能一眼看出来该接口的返回值。
• 每一个接口都需要增加额外的代码量。

所幸Spring Boot已经为我们提供了更好的解决办法，只需要在项目中加上以下代码，就可以无感知的为我们统一全局返回值。

/**
 * 全局返回值统一封装
 */
@EnableWebMvc
@Configuration
public class GlobalReturnConfig {

    @RestControllerAdvice
    static class ResultResponseAdvice implements ResponseBodyAdvice<Object> {
        @Override
        public boolean supports(MethodParameter methodParameter, Class<? extends HttpMessageConverter<?>> aClass) {
            return true;
        }

        @Override
        public Object beforeBodyWrite(Object body, MethodParameter methodParameter, MediaType mediaType, Class<? extends HttpMessageConverter<?>> aClass, ServerHttpRequest serverHttpRequest, ServerHttpResponse serverHttpResponse) {
            if (body instanceof Result) {
                return body;
            }
            return new Result(body);
        }
    }
}

而我们的接口只需要写成最原始的样子就行了。

    @GetMapping("/test")
    public User test() {
        return new User();
    }

统一处理异常

将返回值统一封装时我们没有考虑当接口抛出异常的情况。当接口抛出异常时让用户直接看到服务端的异常肯定是不够友好的，而我们也不可能每一个接口都去try/catch进行处理，此时只需要使用@ExceptionHandler注解即可无感知的全局统一处理异常。

@RestControllerAdvice
public class GlobalExceptionHandler {

    private static final Logger LOG = LoggerFactory.getLogger(GlobalExceptionHandler.class);

    /**
     * 全局异常处理
     */
    @ExceptionHandler
    public JsonData handleException(HttpServletRequest request, HttpServletResponse response, final Exception e) {
        LOG.error(e.getMessage(), e);
        if (e instanceof AlertException) {//可以在前端Alert的异常
            if (((AlertException) e).getRetCode() != null) {//预定义异常
                return new Result(((AlertException) e).getRetCode());
            } else {
                return new Result(1, e.getMessage() != null ? e.getMessage() : "");
            }
        } else {//其它异常
            if (Util.isProduct()) {//如果是正式环境，统一提示
                return new Result(RetCode.ERROR);
            } else {//测试环境，alert异常信息
                return new Result(1, StringUtils.isNotBlank(e.getMessage()) ? e.getMessage() : e.toString());
            }
        }
    }

}

其中的AlertException为我们自定义的异常，因此当业务中需要抛出错误时，可以手动抛出AlertException。

以上就是统一处理返回值和统一处理异常的两步。

Macos Catalina 10.15 Beta (19A526h)升级导致 JetBrain 系列无法选择文件夹打开项目是已知 bug，可以在 jetbrain 家的 bug 追踪网站查看：
https://youtrack.jetbrains.co...
该 bug 将在后续更新中修复。Jetbrain 软件包括 PhpStrom，GoLand，Intellij Idea 等。
临时，我们可以通过关闭原生的文件选择器使用 JetBrain 自带的文件选择器即可。

步骤：

• 点击 Help
• 点击 Edit Custom VM Options

• 在打开的文件末尾添加：

  Dide.mac.file.chooser.native=false

• 保存，重启软件。

FO 是官方在 FibOS 发行的数字货币，也在多个交易所上交易，作者在写文章的时候，大概报价是 0.05 元。官方也推出了一个简洁易用的钱包 APP 供大家管理自己的 FO 资产，有兴趣的同学也可以下载使用（https://wallet.fo/zh-cn）。有 FO 账户还没有 FO 的小伙伴不妨留下 FO 账户，说不定我会抽几个给大家打 FO 呢。

但是怎么打 FO 呢，很简单，大家可以 FO 钱包 APP 中点击转帐，输入收款账户和转账数量后点确定一气呵成。

但是例如我们在一些需要大批量转账或自动化转账的情况下，我们如何通过代码实现呢？接下来我带领大家一起来体验一下：

1. 创建项目

我们创建一个文件夹叫 transfer，并且进入该文件夹：

mkdir transfer
cd transfer

初始化项目。我们可以执行 fibos 命令是因为我们已经安装了 fibos 命令行工具。如果不清楚如何安装的可以阅读我本专栏的前一篇文章。

fibos --init

安装 fibos 依赖包。这里可以 使用 fibos 安装也可以选择 npm 命令安装。当然如果您安装特别慢，可以使用 cnpm 或者淘宝 npm 镜像。

fibos --install fibos.js

到此为止，准备工作就做完了。此时你的 transfer 文件夹的目录结构是这样的:

.
├── node_modules
└── package.json

2. 主网和测试网介绍

这里需要解释一下的是，我们在开发过程中经常碰到的链主要有三类：

• 主链/主网（Main Chain / Main Net），是由 21 个投票当选的节点负责出块。我们上述说到的价值 0.05 的 FO 就记录在主链上。
• 测试链/测试网 (Test Chain / Test Chain)，测试链运行着跟主链一模一样的机制，就是大家都知道这是一条开发用来测试的链，上面的 FO 并没有价值。
• 本地链/本地网。这个是我生造的一个词。根据官网：https://dev.fo/zh-cn/guide/tu... 的介绍应该是在本地生成一个链或者网，只是只有你一个节点。官网上的说法感觉容易产生误解。

上述三个链或者网完全隔离。大家不要搞混了。

主链：

ID：6aa7bd33b6b45192465afa3553dedb531acaaff8928cf64b70bd4c5e49b7ec6a
EndPoint: http://api.fibos.me  
# 当然还有其他，可以在官方文档中查询：节点介绍 — Dev.fo

测试链：

ID：68cee14f598d88d340b50940b6ddfba28c444b46cd5f33201ace82c78896793a
EndPoint：http://api.testnet.fo
这里我们为了快速开始，建议使用测试网络，减少工作量和不必要的坑打击积极性。

我们可以在测试网的网站上创建几个测试账户并给几个账户空投几个 FO，创建方法：

• 进入http://api.testnet.fo/account，点击随机账户随机密钥，记录你的账户、私钥和公钥匙，点击创建
• 进入 http://api.testnet.fo/reward，输入你刚才创建的账户名称，点击获取奖励。

目前我申请了两个账户，并且空投了一些测试链的 FO。分别是：

账户: gtcmpcrcm2h5
私钥: 5JVtt2nHcr52xfULsRCAKGAFDuCazWs5Z1RcvZmerE8W3Fr66UL
公钥: FO7zZJJdfTvGKpdudAcYQp1y97wP9cC9vG2McmeWzvgLWVnkVy9m

账户: cmvdkvfgedjg
私钥: 5JBoQimR9kDB4922S7BaDjQnm8zaD5D2qNXRbbVKZryRCdUxhfc
公钥: FO7wwaYC7r1z1sP7xyBBa9prEt7dFNoMXY9ZMREEyRUYxKgx4KD4

⚠️ 注意：此处是测试链，且为了方便大家才列在这里。千万千万不要在任何地方泄露你的私钥，泄露代表资产丢失。

3. 初始化客户端

一切准备就绪，我们要实现转账，我们需要获取一个客户端。我们在目录下创建一个 initClien.js 文件，编写以下代码：

var FIBOS = require('fibos.js');

function initClient(_keyProvider) {
    return FIBOS({
        chainId: '68cee14f598d88d340b50940b6ddfba28c444b46cd5f33201ace82c78896793a',
        keyProvider: _keyProvider,
        httpEndpoint: 'http://api.testnet.fo',
        logger: {
            log: null,
            error: null
        }
    });
}

module.exports = initClient;

其中 chainId 即链的 ID，这里我们接入测试链，所以输入的是测试链的 ID。httpEndpoint 即为接入点，也是测试链的接入点。_keyProvider 为要创建 Client 的那个账户的私钥，我们后续会以参数的形式传入。

此时目录结构为：

.
├── initClient.js
├── node_modules
└── package.json

4. 转帐

我们在目录中新建一个 transfer.js 文件，在文件中编码：

  var FIBOS = require('./initClient.js')
    var config = {
        'public-key': 'FO7zZJJdfTvGKpdudAcYQp1y97wP9cC9vG2McmeWzvgLWVnkVy9m', // FO 转出方私钥
        'private-key': '5JVtt2nHcr52xfULsRCAKGAFDuCazWs5Z1RcvZmerE8W3Fr66UL' // FO 转入方私钥
    };

console.log(config['private-key'])
var fibos = FIBOS(config['private-key']);

let ctx = fibos.contractSync('eosio.token');
var r = ctx.transferSync(
    'gtcmpcrcm2h5',  // FO 转出方
    'cmvdkvfgedjg',   // FO 转入方
    '0.1000 FO',  // FO数量
    'Hello Fibos',  // 附言
    {
  authorization: 'gtcmpcrcm2h5' // FO 转出方账户
});
console.log(r);

此时目录结构为：

.
├── initClient.js
├── node_modules
├── package.json
└── transfer.js

执行以下命令进行转账：

fibos transfer.js

成功后会输出这次转账的详情：

{
  "broadcast": true,
  "transaction": {
    "compression": "none",
    "transaction": {
      "expiration": "2019-07-03T11:49:58",
      "ref_block_num": 52798,
      "ref_block_prefix": 459488456,
      "max_net_usage_words": 0,
      "max_cpu_usage_ms": 0,
      "delay_sec": 0,
      "context_free_actions": [],
      "actions": [
        {
          "account": "eosio.token",
          "name": "transfer",
          "authorization": [
            {
              "actor": "gtcmpcrcm2h5",
              "permission": "active"
            }
          ],
          "data": "509a90e8a22a5166c05e526c6d98b644e80300000000000004464f00000000000b48656c6c6f204669626f73"
        }
      ],
      "transaction_extensions": []
    },
    "signatures": [
      "SIG_K1_K46edAAzozP1bThRBGnkNX5M11z4kVBzAAt4qrLZfFVcqaUBhsww3rBdiYgxvhdy3K39bZso1uZGMTp6PEMiQQiDWZATnx"
    ]
  },
  "transaction_id": "5dc6a856f8821a395993a083945e919eb19c0dc277c2a88e60ea31655cc07fba",
  "processed": { ... }

5. 常见错误

Provided keys, permissions, and delays do not satisfy declared authorizations
{

"code":500,
"message":"Internal Service Error",
"error":{
    "code":3090003,
    "name":"unsatisfied_authorization",
    "what":"Provided keys, permissions, and delays do not satisfy declared authorizations",
    "details":[
        {
            "message":"transaction declares authority '{"actor":"cmvdkvfgedjg","permission":"active"}', but does not have signatures for it under a provided delay of 0 ms, provided permissions [], provided keys ["FO7zZJJdfTvGKpdudAcYQp1y97wP9cC9vG2McmeWzvgLWVnkVy9m"], and a delay max limit of 3888000000 ms",
            "file":"authorization_manager.cpp",
            "line_number":520,
            "method":"check_authorization"
        }
    ]
}

}
检查 transfer.js 文件中的公钥、私钥和 authorization 是否正确，而且都是 FO 转出方的。这里官网的示例代码注释写错了：https://dev.fo/zh-cn/guide/to...

symbol precision mismatch

{
    "code":500,
    "message":"Internal Service Error",
    "error":{
        "code":3050003,
        "name":"eosio_assert_message_exception",
        "what":"eosio_assert_message assertion failure",
        "details":[
            {
                "message":"assertion failure with message: symbol precision mismatch",
                "file":"wasm_interface.cpp",
                "line_number":924,
                "method":"eosio_assert"
            },
            {
                "message":"pending console output: ",
                "file":"apply_context.cpp",
                "line_number":72,
                "method":"exec_one"
            }
        ]
    }
}

FO 的精度错误，FO 数量一定要写四位小数。多了少了都会报这个错误。

missing contract
/Users/charlie/Code/fibos/transfer/node_modules/_eosjs@16.0.2@eosjs/lib/structs.js:546:7
      assert(contract != null, 'missing contract');
      ^
Error: missing contract extransfer.quantity action.data transaction.actions
    at Object.fromObject (/Users/charlie/Code/fibos/transfer/node_modules/_eosjs@16.0.2@eosjs/lib/structs.js:546:7)
    at Object.fromObject (/Users/charlie/Code/fibos/transfer/node_modules/_fcbuffer@2.2.0@fcbuffer/lib/struct.js:151:34)
    at actionDataFromObject (/Users/charlie/Code/fibos/transfer/node_modules/_eosjs@16.0.2@eosjs/lib/structs.js:753:29)
    at Object.fromObject (/Users/charlie/Code/fibos/transfer/node_modules/_fcbuffer@2.2.0@fcbuffer/lib/struct.js:148:15)
    at Object.fromObject (/Users/charlie/Code/fibos/transfer/node_modules/_fcbuffer@2.2.0@fcbuffer/lib/types.js:384:28)
    at Object.fromObject (/Users/charlie/Code/fibos/transfer/node_modules/_fcbuffer@2.2.0@fcbuffer/lib/struct.js:151:34)
    at _callee2$ (/Users/charlie/Code/fibos/transfer/node_modules/_eosjs@16.0.2@eosjs/lib/write-api.js:657:38)
    at tryCatch (/Users/charlie/Code/fibos/transfer/node_modules/_regenerator-runtime@0.11.1@regenerator-runtime/runtime.js:62:40)
    at Generator.invoke [as _invoke] (/Users/charlie/Code/fibos/transfer/node_modules/_regenerator-runtime@0.11.1@regenerator-runtime/runtime.js:296:22)
    at Generator.forEach.prototype.(anonymous function) [as next] (/Users/charlie/Code/fibos/transfer/node_modules/_regenerator-runtime@0.11.1@regenerator-runtime/runtime.js:114:21)

这个使用错了 transfer 和 extransfer 函数。其中 transfer 函数表示的是与 EOS 主网兼容的转账方法，函数原型为：

其中 transfer 函数表示的是与 EOS 主网兼容的转账方法，函数原型为：

void transfer(account_name from, account_name to, asset quantity, string memo)

示例：

transfer('accountfrom', 'accountto', '1.0000 FO', 'memo field')

其中 extransfer 函数表示的是与 FIBOS 主网扩展的转账方法，该方法支持在 FIBOS 上发行的所有通证的转账，函数原型为：

void extransfer(account_name from, account_name to, extended_asset quantity, string memo)

示例：

extransfer('accountfrom', 'accountto', '1.0000 FO@eosio', 'memo field')

其中，@ 字符后表示的是该通证的发行方，系统通证 FO 为 FO@eosio，eosio 表示的是该通证是系统原生发行的通证。

6. 后记

转账操作相关的内容就介绍完了。有什么问题留言。也可以在知乎上关注我：https://zhuanlan.zhihu.com/p/...

环境配置

FIBOS 开发环境配置非常简单，只需要安装 FIBOS 即可。不过值得一提的是，目前 FIBOS 只支持 UNIX 系统，比如 Mac OSX，Linux 和 FreeBSD，但是不支持 Window 系统。不过 Window 用户装一个虚拟机就可以造起来啦！

curl -s https://fibos.io/download/installer.sh | sh

一行代码搞定，So easy！

赶紧试试 FIBOS 装好没。

fibos --version

正常输出，棒！

编辑器配置

理论上任何编辑器都可以，但是我选择了宇宙第一编辑器 VSCODE。因为 FIBOS DApp 基本上都是 js 文件，所以VSCODE 代码高亮基本上不用怎么配置就可以。

唯一需要配置的是 .abi文件。我们可以在 VSCODE 菜单栏中点击 preferences，搜索 files.associations，打开settings.json文件在最后添加：

"files.associations": {
    "*.abi": "json"
  }

这几行的代码意思就是把 .abi看做 json 文件进行代码高亮。

今天就分享到这里，下一篇文章进入正题。大家有兴趣也可以关注我的知乎专栏：https://www.zhihu.com/people/...

一个普通开发者对 ETH、EOS、FIBOS的看法

一直保持着如儿童般的好奇心和技术的热情，挺早就关注区块链和加密货币。当然并没有发财，这可能跟自己知识结构和本身比较穷有关。

在读大学的时候第一次听到了比特币，那时候可能几美元吧记不清了。后来接触到了以太坊，第一次听到了 DApp 这个词。可能当时各种资料比较少，只是看了看文档并没有真正尝试去写一个 DApp。

真正想着去编写一个 DApp 应该是在 2018 年，当时一句话感触至深：

你想真正了解一件事情最好的方法是参与其中。
于是乎在 2018 年花了一点点钱买了一点点加密币。大家不用猜也知道，买在了山顶上，哈哈哈。也就是从那时候开始，在 Udemy 买了课程 Ethereum and Solidity: The Complete Developer's Guide 和 参加了 LoomNetWork 的在线互动课程。这两个课程质量非常好，强烈推荐，算是我的 DApp 入门课程。但是但是，我并没有后续自己独立开发出一个 DApp。

再后来，通过一直在微博上关注的西祠胡同响马，了解到了 FIBOS，也把自己为数不多的 EOS 兑换成了 FO。

为什么会关注 FIBOS 呢？经历了 Solidity 写 DApp 的确发现 Solidity 其实也有一定的学习成本，虽然说 Solidity 跟 Javascript 类似，但是还是有自己不同的语法。另外 DApp 编程，跟中心化应用你的大脑回路需要不一样。另外 ETH 一个缺点就是性能比较差，而且跑你的 DApp 非常贵。大家应该也听说过一个云养猫的 DApp 就让 ETH 拥堵不堪了。

当然 ETH 的开发团度肯定也意识到了这些问题，但是有号称区块链 3.0 的 EOS 出来想要解决这些问题。更快的运行速度，更大的通量，更便宜的运行成本，但是似乎并没有解决开发门槛的问题。目前 EOS 仅仅支持 C 和 C ++ 编写合约。EOS 比 ETH 开发门槛更高了。

想必无数个开发工程师都会在咆哮，就不能来一个热门语言例如 Javascript 就能开发的智能合约呀！毕竟：

一个凡是真理：凡是能用 Javascript 写的，终将被 Javascript 改写。
最终历史重任似乎落到了 FIBOS 身上，一个结合 FIBJS 以及 EOS 的 JavaScript 的运行平台，它使得 EOS 提供可编程性，并允许使用 JavaScript 编写智能合约。JavaScript 开发 + BANCOR 协议智能通证 + 开发者服务，FIBOS 平台实现了快速开发、快速部署和稳定且流动的通证体系，帮助开发者一步进入区块链时代。

官方文档中仔细罗列了其与 EOS 相比的优势：

1 目前 EOS 的环境部署困难

EOS 的编译环境依赖性强，编译过程时常遇到很多问题，对于普通一个开发者来说，大多数面对 CMake 的情况是束手无策的。

而 FIBOS 提供一套预编译开发环境，开发者可以快速实现部署，把更多的时间用在编写智能合约上。

2 开发门槛高

编写 EOS 智能合约需要掌握 C++ 语言，这对于一名开发者来说学习成本非常高，并且我们认为正确的写出编译合约的 CMAKELISTS.TXT 才是刚刚开始！

而对于 FIBOS 来说，开发者可以使用 JavaScript 脚本语言进行编写智能合约，而这门语言学习成本很低。

对于一名开发者来说，如果一件事情简单容易，我们认为他们会更容易接受，并渴望了解 FIBOS。

3 测试套件原始

EOS 的测试用例编写也必须使用 C++，高难度的语言学习，高难度的编译，使得测试这件事在 EOS 上面变得复杂、困难。

FIBOS 集成 FIBJS 服务端开发平台，拥有成熟的测试套件，在 FIBOS 平台上编写的用例，开发者可以使用 JavaScript 编写测试用例，这一切看起来非常的灵活、轻松！

4. EOS 迭代周期长

一个 EOS 智能合约要想成功部署发布，需要经过编写、编译、部署、测试、调试、修复，漫长的等待过程。

FIBOS 支持本地合约模式，随时修改随时测试，结合一些 IDE 工具可以做到一键研发测试。

5. 开发生态原始

EOS 使用 C++ 参与编写研发，并不能做到 NPM 这样的生态环境，而 FIBOS 支持 NPM 包管理，与庞大的 NPM 生态紧密连接。

6. 部署发布合约成本高

EOS 编写合约需要让 C++ 代码编译到 WASM，而 WASM 编译文件非常庞大，让发布部署运行合约成本非常高昂。

FIBOS 编写的合约可以通过打包脚本，压缩文件极大的降低部署发布成本。

7. 合约不可审计

EOS 合约编译成 WASM 后，对审计阅读合约代码带来了极大的困难，开发者无法评估合约的安全性。

FIBOS 的合约使用 JavaScript 编写并且全部开源，方便社区审计，迅速形成共识。

FIBOS 应该是我目前最好的选择
还是那句话，根据 FIBOS 的文档，FIBOS 在技术上优势明显。当然劣势也很显然，目前社区远小于 ETH 和 EOS，质量高、热闹的 DApp 也没有。

还是那句话，你想真正了解一件事情最好的方法是参与其中。我想要了解 FIBOS 是不是真的如此优秀，就是自己动手写一个 DApp。

那选哪个方向呢，我的想法是选一个业务代码不是很多的，但是需要区块链解决中心化 APP 无法解决的信任问题的场景去实现。这里先卖一个关子。

基本上技术架构：

     上链部分：FIBOS  # 需要学习，但是门槛应该不高
     前   端：Vue.js # 比较擅长
     后   端：SpingBoot # 最近正在学习，正好实践一下

计划

目前暂时是有空就去做，还没有具体的计划。后续的进度和一些开发中的有趣的点应该也会在后续文章中分享。

大家也可以关注我的知乎，知乎更新会及时一点。https://www.zhihu.com/people/...