support multipart/form-data (#502)

Author: armersong

parameter.go

@@ -20,6 +20,9 @@ const (
 // FormParameterKind = indicator of Request parameter type "form"
 FormParameterKind
 
+// MultiPartFormParameterKind = indicator of Request parameter type "multipart/form-data"
+MultiPartFormParameterKind
+
 // CollectionFormatCSV comma separated values `foo,bar`
 CollectionFormatCSV = CollectionFormat("csv")
 
@@ -94,6 +97,11 @@ func (p *Parameter) beForm() *Parameter {
 return p
 }
 
+func (p *Parameter) beMultiPartForm() *Parameter {
+p.data.Kind = MultiPartFormParameterKind
+return p
+}
+
 // Required sets the required field and returns the receiver
 func (p *Parameter) Required(required bool) *Parameter {
 p.data.Required = required

web_service.go

@@ -165,6 +165,18 @@ func FormParameter(name, description string) *Parameter {
 return p
 }
 
+// MultiPartFormParameter creates a new Parameter of kind Form (using multipart/form-data) for documentation purposes.
+// It is initialized as required with string as its DataType.
+func (w *WebService) MultiPartFormParameter(name, description string) *Parameter {
+return MultiPartFormParameter(name, description)
+}
+
+func MultiPartFormParameter(name, description string) *Parameter {
+p := &Parameter{&ParameterData{Name: name, Description: description, Required: false, DataType: "string"}}
+p.beMultiPartForm()
+return p
+}
+
 // Route creates a new Route using the RouteBuilder and add to the ordered list of Routes.
 func (w *WebService) Route(builder *RouteBuilder) *WebService {
 w.routesLock.Lock()