util.go 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211
  1. package tsgen
  2. import (
  3. "errors"
  4. "fmt"
  5. "io"
  6. "strings"
  7. "github.com/zeromicro/go-zero/tools/goctl/api/spec"
  8. apiutil "github.com/zeromicro/go-zero/tools/goctl/api/util"
  9. "github.com/zeromicro/go-zero/tools/goctl/util"
  10. )
  11. const (
  12. formTagKey = "form"
  13. pathTagKey = "path"
  14. headerTagKey = "header"
  15. )
  16. func writeProperty(writer io.Writer, member spec.Member, indent int) error {
  17. writeIndent(writer, indent)
  18. ty, err := goTypeToTs(member.Type, false)
  19. if err != nil {
  20. return err
  21. }
  22. optionalTag := ""
  23. if member.IsOptional() || member.IsOmitEmpty() {
  24. optionalTag = "?"
  25. }
  26. name, err := member.GetPropertyName()
  27. if err != nil {
  28. return err
  29. }
  30. comment := member.GetComment()
  31. if len(comment) > 0 {
  32. comment = strings.TrimPrefix(comment, "//")
  33. comment = " // " + strings.TrimSpace(comment)
  34. }
  35. if len(member.Docs) > 0 {
  36. fmt.Fprintf(writer, "%s\n", strings.Join(member.Docs, ""))
  37. writeIndent(writer, 1)
  38. }
  39. _, err = fmt.Fprintf(writer, "%s%s: %s%s\n", name, optionalTag, ty, comment)
  40. return err
  41. }
  42. func writeIndent(writer io.Writer, indent int) {
  43. for i := 0; i < indent; i++ {
  44. fmt.Fprint(writer, "\t")
  45. }
  46. }
  47. func goTypeToTs(tp spec.Type, fromPacket bool) (string, error) {
  48. switch v := tp.(type) {
  49. case spec.DefineStruct:
  50. return addPrefix(tp, fromPacket), nil
  51. case spec.PrimitiveType:
  52. r, ok := primitiveType(tp.Name())
  53. if !ok {
  54. return "", errors.New("unsupported primitive type " + tp.Name())
  55. }
  56. return r, nil
  57. case spec.MapType:
  58. valueType, err := goTypeToTs(v.Value, fromPacket)
  59. if err != nil {
  60. return "", err
  61. }
  62. return fmt.Sprintf("{ [key: string]: %s }", valueType), nil
  63. case spec.ArrayType:
  64. if tp.Name() == "[]byte" {
  65. return "Blob", nil
  66. }
  67. valueType, err := goTypeToTs(v.Value, fromPacket)
  68. if err != nil {
  69. return "", err
  70. }
  71. return fmt.Sprintf("Array<%s>", valueType), nil
  72. case spec.InterfaceType:
  73. return "any", nil
  74. case spec.PointerType:
  75. return goTypeToTs(v.Type, fromPacket)
  76. }
  77. return "", errors.New("unsupported type " + tp.Name())
  78. }
  79. func addPrefix(tp spec.Type, fromPacket bool) string {
  80. if fromPacket {
  81. return packagePrefix + util.Title(tp.Name())
  82. }
  83. return util.Title(tp.Name())
  84. }
  85. func primitiveType(tp string) (string, bool) {
  86. switch tp {
  87. case "string":
  88. return "string", true
  89. case "int", "int8", "int32", "int64", "uint", "uint8", "uint16", "uint32", "uint64":
  90. return "number", true
  91. case "float", "float32", "float64":
  92. return "number", true
  93. case "bool":
  94. return "boolean", true
  95. case "[]byte":
  96. return "Blob", true
  97. case "interface{}":
  98. return "any", true
  99. }
  100. return "", false
  101. }
  102. func writeType(writer io.Writer, tp spec.Type) error {
  103. fmt.Fprintf(writer, "export interface %s {\n", util.Title(tp.Name()))
  104. if err := writeMembers(writer, tp, false); err != nil {
  105. return err
  106. }
  107. fmt.Fprintf(writer, "}\n")
  108. return genParamsTypesIfNeed(writer, tp)
  109. }
  110. func genParamsTypesIfNeed(writer io.Writer, tp spec.Type) error {
  111. definedType, ok := tp.(spec.DefineStruct)
  112. if !ok {
  113. return errors.New("no members of type " + tp.Name())
  114. }
  115. members := definedType.GetNonBodyMembers()
  116. if len(members) == 0 {
  117. return nil
  118. }
  119. fmt.Fprintf(writer, "export interface %sParams {\n", util.Title(tp.Name()))
  120. if err := writeTagMembers(writer, tp, formTagKey); err != nil {
  121. return err
  122. }
  123. fmt.Fprintf(writer, "}\n")
  124. if len(definedType.GetTagMembers(headerTagKey)) > 0 {
  125. fmt.Fprintf(writer, "export interface %sHeaders {\n", util.Title(tp.Name()))
  126. if err := writeTagMembers(writer, tp, headerTagKey); err != nil {
  127. return err
  128. }
  129. fmt.Fprintf(writer, "}\n")
  130. }
  131. return nil
  132. }
  133. func writeMembers(writer io.Writer, tp spec.Type, isParam bool) error {
  134. definedType, ok := tp.(spec.DefineStruct)
  135. if !ok {
  136. pointType, ok := tp.(spec.PointerType)
  137. if ok {
  138. return writeMembers(writer, pointType.Type, isParam)
  139. }
  140. return fmt.Errorf("type %s not supported", tp.Name())
  141. }
  142. members := definedType.GetBodyMembers()
  143. if isParam {
  144. members = definedType.GetNonBodyMembers()
  145. }
  146. for _, member := range members {
  147. if member.IsInline {
  148. if err := writeMembers(writer, member.Type, isParam); err != nil {
  149. return err
  150. }
  151. continue
  152. }
  153. if err := writeProperty(writer, member, 1); err != nil {
  154. return apiutil.WrapErr(err, " type "+tp.Name())
  155. }
  156. }
  157. return nil
  158. }
  159. func writeTagMembers(writer io.Writer, tp spec.Type, tagKey string) error {
  160. definedType, ok := tp.(spec.DefineStruct)
  161. if !ok {
  162. pointType, ok := tp.(spec.PointerType)
  163. if ok {
  164. return writeTagMembers(writer, pointType.Type, tagKey)
  165. }
  166. return fmt.Errorf("type %s not supported", tp.Name())
  167. }
  168. members := definedType.GetTagMembers(tagKey)
  169. for _, member := range members {
  170. if member.IsInline {
  171. if err := writeTagMembers(writer, member.Type, tagKey); err != nil {
  172. return err
  173. }
  174. continue
  175. }
  176. if err := writeProperty(writer, member, 1); err != nil {
  177. return apiutil.WrapErr(err, " type "+tp.Name())
  178. }
  179. }
  180. return nil
  181. }