api 文件格式化

概述

在 api 文件编写完之后,我们的 api 内容参差不齐,就有如下内容:

  1. syntax= "v1"
  2. info(
  3. key1:value1
  4. key2:value2
  5. longkey:longvalue
  6. )
  7. type Foo {
  8. Bar string
  9. Baz int
  10. }

这样的 api 文件不利于阅读,我们可以使用 goctl api format 命令对 api 文件进行格式化。

任务目标

  1. 熟悉 goctl api format 命令的使用
  2. 了解 goctl api format 命令的功能

准备条件

  1. 完成 goctl 安装

格式化 api 文件

  1. 创建 api 文件,将如下内容拷贝到 demo.api 文件中:

    1. syntax = "v1"
    2. type User {
    3. Id int64 `json:"id"`
    4. Name string `json:"name"`
    5. Age int `json:"age"`
    6. Description string `json:"description"`
    7. }
    8. type Student {
    9. Id int64 `json:"id"`
    10. No int64 `json:"no"`
    11. Name string `json:"name"`
    12. Age int `json:"age"`
    13. Description string `json:"description"`
    14. }
    15. service User {
    16. @handler ping
    17. get /ping
    18. }
  2. 创建工作空间和目录

    1. $ mkdir -p ~/workspace/api/format
  3. 将上文中的 demo.api 文件拷贝到 ~/workspace/api/format 目录下

  4. 格式化 api 文件

    1. $ cd ~/workspace/api/format
    2. $ goctl api format --dir demo.api
  5. 查看格式化后的 api 文件

    1. syntax = "v1"
    2. type User {
    3. Id int64 `json:"id"`
    4. Name string `json:"name"`
    5. Age int `json:"age"`
    6. Description string `json:"description"`
    7. }
    8. type Student {
    9. Id int64 `json:"id"`
    10. No int64 `json:"no"`
    11. Name string `json:"name"`
    12. Age int `json:"age"`
    13. Description string `json:"description"`
    14. }
    15. service User {
    16. @handler ping
    17. get /ping
    18. }