package tsgen import ( _ "embed" "fmt" "path" "strings" "text/template" "github.com/zeromicro/go-zero/tools/goctl/api/spec" apiutil "github.com/zeromicro/go-zero/tools/goctl/api/util" "github.com/zeromicro/go-zero/tools/goctl/util" "github.com/zeromicro/go-zero/tools/goctl/util/pathx" ) //go:embed handler.tpl var handlerTemplate string func genHandler(dir, webAPI, caller string, api *spec.ApiSpec, unwrapAPI bool) error { filename := strings.Replace(api.Service.Name, "-api", "", 1) + ".ts" if err := pathx.RemoveIfExist(path.Join(dir, filename)); err != nil { return err } fp, created, err := apiutil.MaybeCreateFile(dir, "", filename) if err != nil { return err } if !created { return nil } defer fp.Close() imports := "" if len(caller) == 0 { caller = "webapi" } importCaller := caller if unwrapAPI { importCaller = "{ " + importCaller + " }" } if len(webAPI) > 0 { imports += `import ` + importCaller + ` from ` + "\"" + webAPI + "\"" } if len(api.Types) != 0 { if len(imports) > 0 { imports += pathx.NL } outputFile := apiutil.ComponentName(api) imports += fmt.Sprintf(`import * as components from "%s"`, "./"+outputFile) imports += fmt.Sprintf(`%sexport * from "%s"`, pathx.NL, "./"+outputFile) } apis, err := genAPI(api, caller) if err != nil { return err } t := template.Must(template.New("handlerTemplate").Parse(handlerTemplate)) return t.Execute(fp, map[string]string{ "imports": imports, "apis": strings.TrimSpace(apis), }) } func genAPI(api *spec.ApiSpec, caller string) (string, error) { var builder strings.Builder for _, group := range api.Service.Groups { for _, route := range group.Routes { handler := route.Handler if len(handler) == 0 { return "", fmt.Errorf("missing handler annotation for route %q", route.Path) } handler = util.Untitle(handler) handler = strings.Replace(handler, "Handler", "", 1) comment := commentForRoute(route) if len(comment) > 0 { fmt.Fprintf(&builder, "%s\n", comment) } fmt.Fprintf(&builder, "export function %s(%s) {\n", handler, paramsForRoute(route)) writeIndent(&builder, 1) responseGeneric := "" if len(route.ResponseTypeName()) > 0 { val, err := goTypeToTs(route.ResponseType, true) if err != nil { return "", err } responseGeneric = fmt.Sprintf("<%s>", val) } fmt.Fprintf(&builder, `return %s.%s%s(%s)`, caller, strings.ToLower(route.Method), util.Title(responseGeneric), callParamsForRoute(route, group)) builder.WriteString("\n}\n\n") } } apis := builder.String() return apis, nil } func paramsForRoute(route spec.Route) string { if route.RequestType == nil { return "" } hasParams := pathHasParams(route) hasBody := hasRequestBody(route) hasHeader := hasRequestHeader(route) hasPath := hasRequestPath(route) rt, err := goTypeToTs(route.RequestType, true) if err != nil { fmt.Println(err.Error()) return "" } var params []string if hasParams { params = append(params, fmt.Sprintf("params: %s", rt+"Params")) } if hasBody { params = append(params, fmt.Sprintf("req: %s", rt)) } if hasHeader { params = append(params, fmt.Sprintf("headers: %s", rt+"Headers")) } if hasPath { ds, ok := route.RequestType.(spec.DefineStruct) if !ok { fmt.Printf("invalid route.RequestType: {%v}\n", route.RequestType) } members := ds.GetTagMembers(pathTagKey) for _, member := range members { tags := member.Tags() if len(tags) > 0 && tags[0].Key == pathTagKey { valueType, err := goTypeToTs(member.Type, false) if err != nil { fmt.Println(err.Error()) return "" } params = append(params, fmt.Sprintf("%s: %s", tags[0].Name, valueType)) } } } return strings.Join(params, ", ") } func commentForRoute(route spec.Route) string { var builder strings.Builder comment := route.JoinedDoc() builder.WriteString("/**") builder.WriteString("\n * @description " + comment) hasParams := pathHasParams(route) hasBody := hasRequestBody(route) hasHeader := hasRequestHeader(route) if hasParams { builder.WriteString("\n * @param params") } if hasBody { builder.WriteString("\n * @param req") } if hasHeader { builder.WriteString("\n * @param headers") } builder.WriteString("\n */") return builder.String() } func callParamsForRoute(route spec.Route, group spec.Group) string { hasParams := pathHasParams(route) hasBody := hasRequestBody(route) hasHeader := hasRequestHeader(route) var params = []string{pathForRoute(route, group)} if hasParams { params = append(params, "params") } if hasBody { params = append(params, "req") } if hasHeader { params = append(params, "headers") } return strings.Join(params, ", ") } func pathForRoute(route spec.Route, group spec.Group) string { prefix := group.GetAnnotation(pathPrefix) routePath := route.Path if strings.Contains(routePath, ":") { pathSlice := strings.Split(routePath, "/") for i, part := range pathSlice { if strings.Contains(part, ":") { pathSlice[i] = fmt.Sprintf("${%s}", part[1:]) } } routePath = strings.Join(pathSlice, "/") } if len(prefix) == 0 { return "`" + routePath + "`" } prefix = strings.TrimPrefix(prefix, `"`) prefix = strings.TrimSuffix(prefix, `"`) return fmt.Sprintf("`%s/%s`", prefix, strings.TrimPrefix(routePath, "/")) } func pathHasParams(route spec.Route) bool { ds, ok := route.RequestType.(spec.DefineStruct) if !ok { return false } return len(ds.Members) != len(ds.GetBodyMembers()) } func hasRequestBody(route spec.Route) bool { ds, ok := route.RequestType.(spec.DefineStruct) if !ok { return false } return len(route.RequestTypeName()) > 0 && len(ds.GetBodyMembers()) > 0 } func hasRequestPath(route spec.Route) bool { ds, ok := route.RequestType.(spec.DefineStruct) if !ok { return false } return len(route.RequestTypeName()) > 0 && len(ds.GetTagMembers(pathTagKey)) > 0 } func hasRequestHeader(route spec.Route) bool { ds, ok := route.RequestType.(spec.DefineStruct) if !ok { return false } return len(route.RequestTypeName()) > 0 && len(ds.GetTagMembers(headerTagKey)) > 0 }