类型声明

概述

API 的类型声明和 Golang 的类型声明非常相似，但是有一些细微的差别，接下来我们来看一下 API 的类型声明吧。

类型声明

在 API 描述语言中，类型声明需要满足如下规则:

  1. 类型声明必须以 type 开头
  2. 不需要声明 struct关键字
  3. 不支持嵌套结构体声明
  4. 不支持别名

示例

  2. type StructureExample {
  3.     // 基本数据类型示例
  4.     BaseInt     int     `json:"base_int"`
  5.     BaseBool    bool    `json:"base_bool"`
  6.     BaseString  string  `json:"base_string"`
  7.     BaseByte    byte    `json:"base_byte"`
  8.     BaseFloat32 float32 `json:"base_float32"`
  9.     BaseFloat64 float64 `json:"base_float64"`
  10.     // 切片示例
  11.     BaseIntSlice     []int     `json:"base_int_slice"`
  12.     BaseBoolSlice    []bool    `json:"base_bool_slice"`
  13.     BaseStringSlice  []string  `json:"base_string_slice"`
  14.     BaseByteSlice    []byte    `json:"base_byte_slice"`
  15.     BaseFloat32Slice []float32 `json:"base_float32_slice"`
  16.     BaseFloat64Slice []float64 `json:"base_float64_slice"`
  17.     // map 示例
  18.     BaseMapIntString      map[int]string               `json:"base_map_int_string"`
  19.     BaseMapStringInt      map[string]int               `json:"base_map_string_int"`
  20.     BaseMapStringStruct   map[string]*StructureExample `json:"base_map_string_struct"`
  21.     BaseMapStringIntArray map[string][]int             `json:"base_map_string_int_array"`
  22.     // 匿名示例
  23.     *Base
  24.     // 指针示例
  25.     Base4 *Base `json:"base4"`
  27.     // 新的特性（ goctl >= 1.5.1 版本支持 ）
  28.     // 标签忽略示例
  29.     TagOmit string
  30. }
类型声明 - 图1tip

API 新特性使用可参考新版 API 解析器使用

我们暂时不支持泛型、弱类型，如 any 类型

可以参与 discussion 讨论说出你的看法 https://github.com/zeromicro/go-zero/discussions/3121