Type Declaration

Overview

The API type declaration is very similar to the Golang type statement, but there are some nuances and we turn to the API type statement.

Type Declaration

In the API description, the type declaration needs to satisfy the following rule:

  1. Type declaration must start with type
  2. No need to declare structurekeywords
  3. Nested Structural Declarations are not supported
  4. Alias not supported

Sample

  2. type StructureExample {
  3.     // Basic data type example
  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.     // slice example
  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 example
  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.     // anonymous example
  23.     *Base
  24.     // pointer example
  25.     Base4 *Base `json:"base4"`
  27.     // new features ( goctl >= 1.5.1 version support )
  28.     // tag ignore example
  29.     TagOmit string
  30. }
Type Declaration - 图1tip

New API features are referenced New API Resolver Us

We don’t support generic, weak types, e.g. any type

You can participate in the discussion discussion to share your views https://github.com/zeroicro/go-zero/discussions/3121 ::