oxsean opened a new pull request, #14924:
URL: https://github.com/apache/dubbo/pull/14924

   ## What is the purpose of the change?
   Add OpenAPI support for Triple REST protocol, enabling automatic OpenAPI 
documentation generation 
   for dubbo services. The implementation includes:
   - Dynamic OpenAPI spec generation from service metadata
   - Support for JSON/YAML formats
   - Configurable schema naming strategy
   - Document caching and merging
   - Group/Version/Tag filtering
   - Customizable documentation through annotations
   
   ## How to testing
   Automatically generates OpenAPI documentation for all Dubbo services with 
zero configuration:
   
   1. Access Swagger UI:
      ```
      http://host:port/dubbo/openapi
      ```
   
   1. Access OpenAPI Spec:
      ```
      http://host:port/dubbo/openapi/api-docs
      ```
   
   2. Supported formats:
      - JSON (default): `/dubbo/openapi/api-docs`
      - YAML: `/dubbo/openapi/api-docs.yaml` 
   
   3. Optional filters:
      - Group: `/dubbo/openapi/api-docs/{group}`
      - Version: `/dubbo/openapi/api-docs?version=1.0.0`
      - Tags: `/dubbo/openapi/api-docs?tag=user,order`
   
   ## Example 
   Start `dubbo-demo/dubbo-demo-spring-boot/dubbo-demo-spring-boot-servlet`
   then access:
   ```
   http://localhost:8082/dubbo/openapi
   ```
   
   ## Show case
   
![image](https://github.com/user-attachments/assets/11e21a1b-f4db-41d8-ab85-d7cddc06b2e0)
   
![image](https://github.com/user-attachments/assets/bee18813-00b7-48c8-95b8-7c0f52669545)
   
![image](https://github.com/user-attachments/assets/689c1121-8d89-4180-844c-7a38277f7143)
   
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to