Strict server generation (#499)

* Added strict server generation that does automatic marshaling of request and response bodies, meaning less manual code and forced schema compliance

* Support any content type by using io.Reader

* removed generating marshalling code from client for content types other than JSON

* Multipart and formdata are now passed as forms without any binding

* run make generate to fix the build

* added sorting of request bodies to reduce number of random changes in generated code, fixed content type in RequestBody's comment

* Implemented basic formdata binder (not yet integrated into strict server)

* Added tests for strict generation, support for form marshalling, client improvements

* Fixed incorrect referencing of request bodies, added sorting of response definitions

* Added sorting of content types in responses

* Support multipart responses using callback function, added header example

* Added sorting of headers in response objects

* Added proper testing to strict servers

* Fix after master merge

* Reuse responses defined in components section, moved strict test to tests

* When multiple responses ref to a single reusable response, only the first one will use an alias, all others will generate new structs

* Update generated code after merge

* Some documentation for strict server

* Support for AdditionalProperties when binding forms

Co-authored-by: ilya.bogdanov <ilya.bogdanov@ispringsolutions.com>
Co-authored-by: ilya.bogdanov <ilya.bogdanov@ispring.com>

Author: 3 people

file.go

@@ -0,0 +1,71 @@
+package types
+
+import (
+	"bytes"
+	"encoding/json"
+	"io"
+	"mime/multipart"
+)
+
+type File struct {
+	multipart *multipart.FileHeader
+	data      []byte
+	filename  string
+}
+
+func (file *File) InitFromMultipart(header *multipart.FileHeader) {
+	file.multipart = header
+	file.data = nil
+	file.filename = ""
+}
+
+func (file *File) InitFromBytes(data []byte, filename string) {
+	file.data = data
+	file.filename = filename
+	file.multipart = nil
+}
+
+func (file *File) MarshalJSON() ([]byte, error) {
+	b, err := file.Bytes()
+	if err != nil {
+		return nil, err
+	}
+	return json.Marshal(b)
+}
+
+func (file *File) UnmarshalJSON(data []byte) error {
+	return json.Unmarshal(data, &file.data)
+}
+
+func (file File) Bytes() ([]byte, error) {
+	if file.multipart != nil {
+		f, err := file.multipart.Open()
+		if err != nil {
+			return nil, err
+		}
+		defer func() { _ = f.Close() }()
+		return io.ReadAll(f)
+	}
+	return file.data, nil
+}
+
+func (file File) Reader() (io.ReadCloser, error) {
+	if file.multipart != nil {
+		return file.multipart.Open()
+	}
+	return io.NopCloser(bytes.NewReader(file.data)), nil
+}
+
+func (file File) Filename() string {
+	if file.multipart != nil {
+		return file.multipart.Filename
+	}
+	return file.filename
+}
+
+func (file File) FileSize() int64 {
+	if file.multipart != nil {
+		return file.multipart.Size
+	}
+	return int64(len(file.data))
+}