Skip to content

docs: Add package-level Javadoc for gateway core packages#4121

Open
shiguangtong wants to merge 1 commit intospring-cloud:mainfrom
shiguangtong:docs/add-package-javadoc
Open

docs: Add package-level Javadoc for gateway core packages#4121
shiguangtong wants to merge 1 commit intospring-cloud:mainfrom
shiguangtong:docs/add-package-javadoc

Conversation

@shiguangtong
Copy link
Copy Markdown

Description

This PR adds comprehensive package-level Javadoc documentation for three core Spring Cloud Gateway packages that were previously marked with TODO comments.

Changes

  • discovery package: Added documentation for service discovery integration, explaining DiscoveryClient usage and key components
  • event package: Added documentation for event-driven gateway lifecycle management, including how to listen to gateway events
  • filter package: Added documentation for request/response filter processing, categorizing filter types and listing common implementations

Motivation and Context

These documentation additions help developers understand the purpose and usage of each package in the Spring Cloud Gateway framework. They resolve the TODO comments that were previously in these files.

Type of Change

  • Bug fix
  • Documentation
  • New feature
  • Breaking change

Checklist

  • My code follows the code style of this project
  • I have updated the documentation accordingly
  • I have added Javadoc comments
  • My changes do not introduce new warnings

Stats

  • Files changed: 3
  • Lines added: 82
  • Lines removed: 7

- Add comprehensive Javadoc for org.springframework.cloud.gateway.discovery package
  describing service discovery integration capabilities
- Add Javadoc for org.springframework.cloud.gateway.event package
  documenting event-driven gateway lifecycle management
- Add Javadoc for org.springframework.cloud.gateway.filter package
  explaining filter types and common implementations

These additions improve code documentation and help developers understand
the purpose and usage of each package in the Spring Cloud Gateway framework.
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Revert this change

@ryanjbaxter
Copy link
Copy Markdown
Contributor

Please sign your commits so the DCO check passes

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

3 participants