github.com/kaisawind/go-swagger@v0.19.0/generator/templates/server/urlbuilder.gotmpl

{{ define "queryparambuilder" }}
{{ if not .IsArray }}{{ template "simplequeryparambuilder" . }}{{ else }}{{ template "slicequeryparambuilder" . }}{{ end }}
{{- end }}
{{ define "simplequeryparambuilder" }}
{{ if .IsNullable -}}
var {{ varname .ID }} string
if {{ .ReceiverName }}.{{ pascalize .ID }} != nil {
  {{ varname .ID }} = {{ if .Formatter }}{{ .Formatter }}(*{{ .ReceiverName }}.{{ pascalize .ID }}){{ else }}{{ if not .IsCustomFormatter }}*{{ end }}{{ .ReceiverName }}.{{ pascalize .ID }}{{ if .IsCustomFormatter }}.String(){{end}}{{end}}
}
{{ else }}{{ varname .ID }} := {{ if .Formatter }}{{ .Formatter }}({{ .ReceiverName }}.{{ pascalize .ID }}){{ else }}{{ .ReceiverName }}.{{ pascalize .ID }}{{ if .IsCustomFormatter }}.String(){{end}}{{end}}
{{ end -}}
if {{ varname .ID }} != "" {
  qs.Set({{ printf "%q" .Name }}, {{ varname .ID }})
}
{{ end }}
{{ define "sliceitemqueryparambuilder" }}
{{ if .IsNullable -}}
var {{ .ValueExpression }}S string
if {{ .ValueExpression }} != nil {
  {{ .ValueExpression }}S = {{ if .Formatter }}{{ .Formatter }}(*{{ .ValueExpression }}){{ else }}*{{ .ValueExpression }}{{ if .IsCustomFormatter }}.String(){{end}}{{end}}
}
{{ else -}}
{{ .ValueExpression }}S := {{ if .Formatter }}{{ .Formatter }}({{ .ValueExpression }}){{ else }}{{ .ValueExpression }}{{ if .IsCustomFormatter }}.String(){{end}}{{end}}
{{ end -}}
if {{ .ValueExpression }}S != "" {
  {{ .ValueExpression }}R = append({{ .ValueExpression }}R, {{ .ValueExpression }}S)
}
{{ end }}
{{define "slicequeryparambuilder" }}
var {{ .Child.ValueExpression }}R []string
for _, {{ .Child.ValueExpression }} := range {{ .ValueExpression }} {
  {{- if not .Child.IsArray }}{{ template "sliceitemqueryparambuilder" .Child }}{{ else }}{{ template "slicequeryparambuilder" .Child }}{{ end -}}
}

{{ if not .Child.Parent -}}
{{ varname .ID }} := swag.JoinByFormat({{ .Child.ValueExpression }}R, {{ printf "%q" .CollectionFormat }})
{{ if eq .CollectionFormat "multi" }}
for _, qsv := range {{ varname .ID }} {
  qs.Add({{ printf "%q" .Name }}, qsv)
}
{{ else }}
if len({{ varname .ID }}) > 0 {
  qsv := {{ varname .ID }}[0]
  if qsv != "" {
    qs.Set({{ printf "%q" .Name }}, qsv)
  }
}
{{ end }}
{{ else -}}
{{ .ValueExpression }}S := swag.JoinByFormat({{ .Child.ValueExpression }}R, {{ printf "%q" .CollectionFormat }})
if len({{ .ValueExpression }}S) > 0 {
  {{ .ValueExpression }}Ss := {{ .ValueExpression }}S[0]
  if {{ .ValueExpression }}Ss != "" {
    {{ .ValueExpression }}R = append({{ .ValueExpression }}R, {{ .ValueExpression }}Ss)
  }
}
{{ end -}}
{{ end -}}
{{ define "slicepathparambuilder" }}
var {{ .Child.ValueExpression }}R []string
for _, {{ .Child.ValueExpression }} := range {{ .ValueExpression }} {
  {{- if not .Child.IsArray }}{{ template "sliceitemqueryparambuilder" .Child }}{{ else }}{{ template "slicepathparambuilder" .Child }}{{ end -}}
}

{{ if not .Child.Parent -}}
{{ varname .ID }} := swag.JoinByFormat({{ .Child.ValueExpression }}R, {{ printf "%q" .CollectionFormat }})
if len({{ varname .ID }}) > 0 {
  psv := {{ varname .ID }}[0]
  if psv != "" {
    _path = strings.Replace(_path, "{{ printf "{%s}" .Name }}", psv, -1)
  } else {
    return nil, errors.New("{{ camelize .ID }} is required on {{ pascalize $.Name }}URL")
  }
}
{{ else -}}
{{ .ValueExpression }}S := swag.JoinByFormat({{ .Child.ValueExpression }}R, {{ printf "%q" .CollectionFormat }})
if len({{ .ValueExpression }}S) > 0 {
  {{ .ValueExpression }}Ss := {{ .ValueExpression }}S[0]
  if {{ .ValueExpression }}Ss != "" {
    {{ .ValueExpression }}R = append({{ .ValueExpression }}R, {{ .ValueExpression }}Ss)
  }
}
{{ end -}}
{{ end }}
// Code generated by go-swagger; DO NOT EDIT.


{{ if .Copyright -}}// {{ comment .Copyright -}}{{ end }}


package {{ .Package }}

// This file was generated by the swagger tool.
// Editing this file might prove futile when you re-run the generate command

import (
  "fmt"
  "errors"
  golangswaggerpaths "path"
  "strings"
  "net/url"

  "github.com/go-openapi/swag"
  "github.com/go-openapi/strfmt"
)

// {{ pascalize .Name }}URL generates an URL for the {{ humanize .Name }} operation
type {{ pascalize .Name }}URL struct {
  {{ range .PathParams }}
  {{ pascalize .ID }} {{.GoType}}
  {{- end }}
  {{ range .QueryParams }}
  {{ pascalize .ID }} {{ if and (not .IsArray) .IsNullable }}*{{ end }}{{.GoType}}
  {{- end }}

  _basePath string
  {{ if or (gt (len .PathParams ) 0) (gt (len .QueryParams) 0) -}}
  // avoid unkeyed usage
  _ struct{}
  {{- end }}

}

// WithBasePath sets the base path for this url builder, only required when it's different from the
// base path specified in the swagger spec.
// When the value of the base path is an empty string
func ({{ .ReceiverName }} *{{ pascalize .Name }}URL) WithBasePath(bp string) *{{pascalize .Name}}URL {
  {{ .ReceiverName }}.SetBasePath(bp)
  return {{ .ReceiverName }}
}


// SetBasePath sets the base path for this url builder, only required when it's different from the
// base path specified in the swagger spec.
// When the value of the base path is an empty string
func ({{ .ReceiverName }} *{{ pascalize .Name }}URL) SetBasePath(bp string) {
  {{ .ReceiverName }}._basePath = bp
}

// Build a url path and query string
func ({{ .ReceiverName }} *{{ pascalize .Name }}URL) Build() (*url.URL, error) {
  var _result url.URL

  var _path = {{ printf "%q" .Path }}
  {{ range .PathParams }}{{ if .IsArray }}
    {{ template "slicepathparambuilder" . -}}
  {{ else }}
  {{ varname .ID }} := {{ if .Formatter }}{{ .Formatter }}({{ .ReceiverName }}.{{ pascalize .ID }}){{ else }}{{ .ReceiverName }}.{{ pascalize .ID }}{{ if .IsCustomFormatter }}.String(){{end}}{{end}}
  if {{ varname .ID }} != "" {
    _path = strings.Replace(_path, "{{ printf "{%s}" .Name }}", {{ varname .ID }}, -1)
  } else {
    return nil, errors.New("{{ camelize .ID }} is required on {{ pascalize $.Name }}URL")
  }
  {{ end }}

  {{- end }}
  _basePath := {{ .ReceiverName }}._basePath
  {{ if .BasePath }}if _basePath == "" {
    _basePath = {{ printf "%q" .BasePath }}
  }
  {{ end -}}
  _result.Path = golangswaggerpaths.Join(_basePath, _path)

  {{ if gt (len .QueryParams) 0 -}}
  qs := make(url.Values)
  {{ range .QueryParams }}
  {{ template "queryparambuilder" . -}}
  {{- end }}
  _result.RawQuery = qs.Encode()
  {{- end }}

  return &_result, nil
}

// Must is a helper function to panic when the url builder returns an error
func ({{ .ReceiverName }} *{{ pascalize .Name }}URL) Must(u *url.URL, err error) *url.URL {
  if err != nil {
    panic(err)
  }
  if u == nil {
    panic("url can't be nil")
  }
  return u
}

// String returns the string representation of the path with query string
func ({{ .ReceiverName }} *{{ pascalize .Name }}URL) String() string {
  return {{ .ReceiverName }}.Must({{ .ReceiverName }}.Build()).String()
}

// BuildFull builds a full url with scheme, host, path and query string
func ({{ .ReceiverName }} *{{ pascalize .Name }}URL) BuildFull(scheme, host string) (*url.URL, error) {
  if scheme == "" {
    return nil, errors.New("scheme is required for a full url on {{ pascalize .Name }}URL")
  }
  if host == "" {
    return nil, errors.New("host is required for a full url on {{ pascalize .Name }}URL")
  }

  base, err := {{ .ReceiverName }}.Build()
  if err != nil {
    return nil, err
  }

  base.Scheme = scheme
  base.Host = host
  return base, nil
}

// StringFull returns the string representation of a complete url
func ({{ .ReceiverName }} *{{ pascalize .Name }}URL) StringFull(scheme, host string) string {
  return {{ .ReceiverName }}.Must( {{ .ReceiverName }}.BuildFull(scheme, host)).String()
}