fix(api-docs): handle the default value of parameter correctly

[iawia002]

What this PR does / why we need it:

For now, if we set a default value for a field of an auto parameter, the API docs generation will fail with the error below:

FATAL 0601-16:59:25.166+08 api.go:61 | json: error calling MarshalJSON for type spec.Swagger: json: error calling MarshalJSON for type *spec.Paths: json: error calling MarshalJSON for type spec.PathItem: json: error calling MarshalJSON for type *spec.Operation: json: error calling MarshalJSON for type spec.OperationProps: json: error calling MarshalJSON for type spec.Parameter: json: error calling MarshalJSON for type *swagger.rawJSON: invalid character 's' after top-level value

Which issue(s) this PR is related to (optional, link to 3rd issue(s)):

Fixes #

Reference to #272

Special notes for your reviewer:

/cc @hezhizhen @supereagle

Release note:

NONE

[iawia002]

/cherrypick release-0.2

[caicloud-bot]

@iawia002: once the present PR merges, I will cherry-pick it on top of release-0.2 in a new PR and assign it to you.

In response to this:

/cherrypick release-0.2

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

[iawia002]

All comments addressed, PTAL @hezhizhen

[hezhizhen]

/lgtm
but I'm not sure if it's expected...

[iawia002]

but I'm not sure if it's expected...

What? Setting an empty default value for those non-basic types?

[iawia002]

If default values of non-basic types are not handled, the effect is as follows, the Swagger UI will not display the default values, that's all, I think it's better than returning errors directly during document generation.

So any more comments?

[hezhizhen]

If default values of non-basic types are not handled, the effect is as follows, the Swagger UI will not display the default values, that's all, I think it's better than returning errors directly during document generation.

So any more comments?

works for me.

[iawia002]

/approve

[caicloud-bot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: hezhizhen, iawia002

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [iawia002]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[caicloud-bot]

@iawia002: new pull request created: #334

In response to this:

/cherrypick release-0.2

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.