package main import ( "fmt" "strings" "google.golang.org/genproto/googleapis/api/annotations" "google.golang.org/protobuf/compiler/protogen" "google.golang.org/protobuf/proto" "google.golang.org/protobuf/types/descriptorpb" ) const ( contextPackage = protogen.GoImportPath("context") httpPackage = protogen.GoImportPath("net/http") transportPackage = protogen.GoImportPath("github.com/go-kratos/kratos/v2/transport/http") ) var methodSets = make(map[string]int) // generateFile generates a _http.pb.go file containing kratos errors definitions. func generateFile(gen *protogen.Plugin, file *protogen.File) *protogen.GeneratedFile { if len(file.Services) == 0 { return nil } filename := file.GeneratedFilenamePrefix + "_http.pb.go" g := gen.NewGeneratedFile(filename, file.GoImportPath) g.P("// Code generated by protoc-gen-go-http. DO NOT EDIT.") g.P() g.P("package ", file.GoPackageName) g.P() generateFileContent(gen, file, g) return g } // generateFileContent generates the kratos errors definitions, excluding the package statement. func generateFileContent(gen *protogen.Plugin, file *protogen.File, g *protogen.GeneratedFile) { if len(file.Services) == 0 { return } g.P("// This is a compile-time assertion to ensure that this generated file") g.P("// is compatible with the kratos package it is being compiled against.") g.P("// ", contextPackage.Ident(""), "/", httpPackage.Ident("")) g.P("const _ = ", transportPackage.Ident("SupportPackageIsVersion1")) g.P() for _, service := range file.Services { genService(gen, file, g, service) } } func genService(gen *protogen.Plugin, file *protogen.File, g *protogen.GeneratedFile, service *protogen.Service) { if service.Desc.Options().(*descriptorpb.ServiceOptions).GetDeprecated() { g.P("//") g.P(deprecationComment) } // HTTP Server. sd := &serviceDesc{ ServiceType: service.GoName, ServiceName: string(service.Desc.FullName()), Metadata: file.Desc.Path(), } for _, method := range service.Methods { rule, ok := proto.GetExtension(method.Desc.Options(), annotations.E_Http).(*annotations.HttpRule) if rule != nil && ok { for _, bind := range rule.AdditionalBindings { sd.Methods = append(sd.Methods, buildHTTPRule(method, bind)) } sd.Methods = append(sd.Methods, buildHTTPRule(method, rule)) } else { path := fmt.Sprintf("/%s/%s", service.Desc.FullName(), method.Desc.Name()) sd.Methods = append(sd.Methods, buildMethodDesc(method, "POST", path)) } } g.P(sd.execute()) } func buildHTTPRule(m *protogen.Method, rule *annotations.HttpRule) *methodDesc { var ( path string method string body string responseBody string ) switch pattern := rule.Pattern.(type) { case *annotations.HttpRule_Get: path = pattern.Get method = "GET" case *annotations.HttpRule_Put: path = pattern.Put method = "PUT" case *annotations.HttpRule_Post: path = pattern.Post method = "POST" case *annotations.HttpRule_Delete: path = pattern.Delete method = "DELETE" case *annotations.HttpRule_Patch: path = pattern.Patch method = "PATCH" case *annotations.HttpRule_Custom: path = pattern.Custom.Path method = pattern.Custom.Kind } body = rule.Body responseBody = rule.ResponseBody md := buildMethodDesc(m, method, path) if body != "" { md.Body = "." + camelCaseVars(body) } if responseBody != "" { md.ResponseBody = "." + camelCaseVars(responseBody) } return md } func buildMethodDesc(m *protogen.Method, method, path string) *methodDesc { defer func() { methodSets[m.GoName]++ }() return &methodDesc{ Name: m.GoName, Num: methodSets[m.GoName], Request: m.Input.GoIdent.GoName, Reply: m.Output.GoIdent.GoName, Path: path, Method: method, Vars: buildPathVars(m, path), } } func buildPathVars(method *protogen.Method, path string) (res []string) { for _, v := range strings.Split(path, "/") { if strings.HasPrefix(v, "{") && strings.HasSuffix(v, "}") { name := strings.TrimRight(strings.TrimLeft(v, "{"), "}") res = append(res, name) } } return } func camelCaseVars(s string) string { var ( vars []string subs = strings.Split(s, ".") ) for _, sub := range subs { vars = append(vars, camelCase(sub)) } return strings.Join(vars, ".") } // camelCase returns the CamelCased name. // If there is an interior underscore followed by a lower case letter, // drop the underscore and convert the letter to upper case. // There is a remote possibility of this rewrite causing a name collision, // but it's so remote we're prepared to pretend it's nonexistent - since the // C++ generator lowercases names, it's extremely unlikely to have two fields // with different capitalizations. // In short, _my_field_name_2 becomes XMyFieldName_2. func camelCase(s string) string { if s == "" { return "" } t := make([]byte, 0, 32) i := 0 if s[0] == '_' { // Need a capital letter; drop the '_'. t = append(t, 'X') i++ } // Invariant: if the next letter is lower case, it must be converted // to upper case. // That is, we process a word at a time, where words are marked by _ or // upper case letter. Digits are treated as words. for ; i < len(s); i++ { c := s[i] if c == '_' && i+1 < len(s) && isASCIILower(s[i+1]) { continue // Skip the underscore in s. } if isASCIIDigit(c) { t = append(t, c) continue } // Assume we have a letter now - if not, it's a bogus identifier. // The next word is a sequence of characters that must start upper case. if isASCIILower(c) { c ^= ' ' // Make it a capital letter. } t = append(t, c) // Guaranteed not lower case. // Accept lower case sequence that follows. for i+1 < len(s) && isASCIILower(s[i+1]) { i++ t = append(t, s[i]) } } return string(t) } // Is c an ASCII lower-case letter? func isASCIILower(c byte) bool { return 'a' <= c && c <= 'z' } // Is c an ASCII digit? func isASCIIDigit(c byte) bool { return '0' <= c && c <= '9' } const deprecationComment = "// Deprecated: Do not use."