feat: sorted response jons keys

Author: alovn

examples/docs/apis-greeter.md

@@ -18,10 +18,10 @@ GET /greeter
 // object main 
 {
   "code": 0,  // int, 返回状态码
-  "msg": "返回消息",  // string, 返回文本消息
   "data": {
     "my_title": "example"  // string, 标题
-  }
+  },
+  "msg": "返回消息"  // string, 返回文本消息
 }
 ```
 
@@ -31,8 +31,8 @@ GET /greeter
 // StatusCode: 500
 // object main 
 {
-  "data": null,  // any, 返回的具体数据
   "code": 10010,  // int, 返回状态码
+  "data": null,  // any, 返回的具体数据
   "msg": "异常"  // string, 返回文本消息
 }
 ```

parser.go

@@ -432,57 +432,57 @@ func (parser *Parser) ParseDefinition(typeSpecDef *TypeSpecDef) (*TypeSchema, er
 	return &sch, nil
 }
 
-func (parser *Parser) parseTypeExpr(file *ast.File, field *ast.Field, typeExpr ast.Expr, ref bool) (*TypeSchema, error) {
-	switch expr := typeExpr.(type) {
-	// type Foo interface{}
-	case *ast.InterfaceType:
-		return &TypeSchema{}, nil
-
-	// type Foo struct {...}
-	case *ast.StructType:
-		return parser.parseStruct(file, expr.Fields)
-
-	// type Foo Baz
-	case *ast.Ident:
-		return parser.getTypeSchema(expr.Name, file, field, ref)
-
-	// type Foo *Baz
-	case *ast.StarExpr:
-		return parser.parseTypeExpr(file, field, expr.X, ref)
-
-	// type Foo pkg.Bar
-	case *ast.SelectorExpr:
-		if xIdent, ok := expr.X.(*ast.Ident); ok {
-			return parser.getTypeSchema(fullTypeName(xIdent.Name, expr.Sel.Name), file, field, ref)
-		}
-	// type Foo []Baz
-	case *ast.ArrayType:
-		itemSchema, err := parser.parseTypeExpr(file, field, expr.Elt, true)
-		if err != nil {
-			return nil, err
-		}
-		return &TypeSchema{Type: "array", ArraySchema: itemSchema}, nil
-	// type Foo map[string]Bar
-	// case *ast.MapType:
-	// 	if _, ok := expr.Value.(*ast.InterfaceType); ok {
-	// 		return &TypeSchema{Type: OBJECT, Properties: nil}, nil
-	// 	}
-	// 	schema, err := parser.parseTypeExpr(file, expr.Value, true)
-	// 	if err != nil {
-	// 		return nil, err
-	// 	}
-
-	// 	return spec.MapProperty(schema), nil
-
-	// case *ast.FuncType:
-	// 	return nil, ErrFuncTypeField
-	// ...
-	default:
-		fmt.Printf("Type definition of type '%T' is not supported yet. Using 'object' instead.\n", typeExpr)
-	}
-
-	return &TypeSchema{Type: OBJECT}, nil
-}
+// func (parser *Parser) parseTypeExpr(file *ast.File, field *ast.Field, typeExpr ast.Expr, ref bool) (*TypeSchema, error) {
+// 	switch expr := typeExpr.(type) {
+// 	// type Foo interface{}
+// 	case *ast.InterfaceType:
+// 		return &TypeSchema{}, nil
+
+// 	// type Foo struct {...}
+// 	case *ast.StructType:
+// 		return parser.parseStruct(file, expr.Fields)
+
+// 	// type Foo Baz
+// 	case *ast.Ident:
+// 		return parser.getTypeSchema(expr.Name, file, field, ref)
+
+// 	// type Foo *Baz
+// 	case *ast.StarExpr:
+// 		return parser.parseTypeExpr(file, field, expr.X, ref)
+
+// 	// type Foo pkg.Bar
+// 	case *ast.SelectorExpr:
+// 		if xIdent, ok := expr.X.(*ast.Ident); ok {
+// 			return parser.getTypeSchema(fullTypeName(xIdent.Name, expr.Sel.Name), file, field, ref)
+// 		}
+// 	// type Foo []Baz
+// 	case *ast.ArrayType:
+// 		itemSchema, err := parser.parseTypeExpr(file, field, expr.Elt, true)
+// 		if err != nil {
+// 			return nil, err
+// 		}
+// 		return &TypeSchema{Type: "array", ArraySchema: itemSchema}, nil
+// 	// type Foo map[string]Bar
+// 	// case *ast.MapType:
+// 	// 	if _, ok := expr.Value.(*ast.InterfaceType); ok {
+// 	// 		return &TypeSchema{Type: OBJECT, Properties: nil}, nil
+// 	// 	}
+// 	// 	schema, err := parser.parseTypeExpr(file, expr.Value, true)
+// 	// 	if err != nil {
+// 	// 		return nil, err
+// 	// 	}
+
+// 	// 	return spec.MapProperty(schema), nil
+
+// 	// case *ast.FuncType:
+// 	// 	return nil, ErrFuncTypeField
+// 	// ...
+// 	default:
+// 		fmt.Printf("Type definition of type '%T' is not supported yet. Using 'object' instead.\n", typeExpr)
+// 	}
+
+// 	return &TypeSchema{Type: OBJECT}, nil
+// }
 
 func (parser *Parser) parseStruct(file *ast.File, fields *ast.FieldList) (*TypeSchema, error) {
 	properties := make(map[string]*TypeSchema)

spec.go

@@ -4,6 +4,7 @@ import (
 	"fmt"
 	"go/ast"
 	"reflect"
+	"sort"
 	"strconv"
 	"strings"
 )
@@ -88,7 +89,14 @@ func (s *TypeSchema) parseJSON(depth int, sb *strings.Builder, isNewLine bool) {
 		sb.WriteString("\n")
 		var i int = 0
 		prefix2 := prefix + "  "
-		for k, v := range s.Properties {
+		//sort keys
+		var keys []string
+		for k := range s.Properties {
+			keys = append(keys, k)
+		}
+		sort.Strings(keys)
+		for _, k := range keys {
+			v := s.Properties[k]
 			sb.WriteString(fmt.Sprintf(prefix2+"\"%s\": ", k)) //write key
 			v.parseJSON(depth+1, sb, false)
 			haxNext := i < len(s.Properties)-1