Function GenerateResponseDefinitions

pkg/codegen/operations.go:1031–1167

(operationID string, responses map[string]*openapi3.ResponseRef, pathItemRef string)

}

func GenerateResponseDefinitions(operationID string, responses map[string]*openapi3.ResponseRef, pathItemRef string) ([]ResponseDefinition, error) {
	externalPkg := externalPackageFor(pathItemRef)

	var responseDefinitions []ResponseDefinition
	// do not let multiple status codes ref to same response, it will break the type switch
	refSet := make(map[string]struct{})

	for _, statusCode := range SortedMapKeys(responses) {
		responseOrRef := responses[statusCode]
		if responseOrRef == nil {
			continue
		}
		response := responseOrRef.Value

		var responseContentDefinitions []ResponseContentDefinition

		for _, contentType := range SortedMapKeys(response.Content) {
			content := response.Content[contentType]
			var tag string
			switch {
			case contentType == "application/json":
				tag = "JSON"
			case util.IsMediaTypeJson(contentType):
				tag = mediaTypeToCamelCase(contentType)
			case contentType == "application/x-www-form-urlencoded":
				tag = "Formdata"
			case strings.HasPrefix(contentType, "multipart/"):
				tag = "Multipart"
			case contentType == "text/plain":
				tag = "Text"
			default:
				rcd := ResponseContentDefinition{
					ContentType: contentType,
				}
				responseContentDefinitions = append(responseContentDefinitions, rcd)
				continue
			}

			responseTypeName := operationID + statusCode + tag + "Response"
			// The strict-server envelope keeps the bare ...Response name
			// (e.g. "GetPing200JSONResponse"); the hoisted body type is
			// suffixed so the envelope can reference it without colliding
			// (the strict envelope is sometimes a struct that wraps the
			// body in a Body field, which would self-reference if the
			// names matched).
			responseBodyTypeName := responseTypeName + "Body"
			contentSchema, err := GenerateGoSchema(content.Schema, []string{responseBodyTypeName})
			if err != nil {
				return nil, fmt.Errorf("error generating request body definition: %w", err)
			}

			// Hoist inline response-root schemas that need method-emitting
			// boilerplate (UnionElements / AdditionalProperties) to a
			// synthetic top-level TypeDefinition. The hoisted typedef flows
			// via op.TypeDefinitions (collected in
			// GenerateTypeDefsForOperation) and gets declared once via
			// typedef.tmpl with full union/additionalProperties methods.
			// The strict-server template references it as the body type