Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

RequestParam#name() ignored #239

Closed
rtomsick opened this issue Jul 19, 2017 · 1 comment
Closed

RequestParam#name() ignored #239

rtomsick opened this issue Jul 19, 2017 · 1 comment
Milestone

Comments

@rtomsick
Copy link

Description

It appears that JSONDoc is ignoring the name attribute of the RequestParam annotation. The value attribute works as expected, despite the former being an alias for the latter.

Steps to reproduce

Attempt to generate documentation for a method like the following

@RequestMapping(value = "")
public void
authenticate(@RequestParam("username") String username, 
				@RequestParam("password") String password, 
				@RequestParam(required = false, name = "source") 
				String source)
throws IOException {/* ... */}

Expected outcome

The three query parameters ("username", "password", "source") are present in the resulting documentation.

Actual outcome

"source" is not present in the resulting documentation, instead the parameter is shown with no name, and the following error is present in a notice above the parameter descriptions: "- Missing documentation data: query parameter name"

Suggested resolution

Treat value and name as synonyms, since that is what Spring does.

@fabiomaffioletti
Copy link
Owner

Solved with #236

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants