Skip to content

Align method descriptions for SslOptions getCiphers and getEnabledProtocols with '@returns' #46756

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

Closed

Conversation

ganjisriver
Copy link
Contributor

Description

This pull request aligns the Javadoc description of SslOptions.getCiphers() and SslOptions.getEnabledProtocols() with their @return tags.

Currently, the method descriptions state that they return an "empty set," while the @return tag correctly specifies that they return null. This change resolves the discrepancy by updating the description to explicitly state that the methods return null when no options are specified, which is consistent with the current implementation.

Before:

  • Return the ciphers that can be used or an empty set.
  • Return the protocols that should be enabled or an empty set.

After:

  • Return the ciphers that can be used or null.
  • Return the protocols that should be enabled or null.

ref. issue 46660

@spring-projects-issues spring-projects-issues added the status: waiting-for-triage An issue we've not yet triaged label Aug 10, 2025
@ganjisriver ganjisriver force-pushed the fix-ssloptions-document branch from b7d9704 to d502b3a Compare August 10, 2025 08:12
Signed-off-by: 강정훈 Kang Jeonghun <ganjisriver18@gmail.com>
@ganjisriver ganjisriver force-pushed the fix-ssloptions-document branch from d502b3a to 37892e8 Compare August 10, 2025 09:30
@snicoll snicoll added type: documentation A documentation update and removed status: waiting-for-triage An issue we've not yet triaged labels Aug 11, 2025
@snicoll snicoll added this to the 3.4.9 milestone Aug 11, 2025
@snicoll snicoll self-assigned this Aug 11, 2025
@snicoll snicoll changed the title Fix SslOptions getCiphers() and getEnabledProtocols() document Align method descriptions for SslOptions getCiphers and getEnabledProtocols with '@returns' Aug 11, 2025
snicoll pushed a commit that referenced this pull request Aug 11, 2025
See gh-46756

Signed-off-by: 강정훈 Kang Jeonghun <ganjisriver18@gmail.com>
@snicoll snicoll closed this in 6e292d0 Aug 11, 2025
@snicoll
Copy link
Member

snicoll commented Aug 11, 2025

@ganjisriver thank you for making your first contribution to Spring Boot.

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

Successfully merging this pull request may close these issues.

3 participants