知识卡片

普通读书笔记卡 · 3464.a

文档页面须对齐清单路径

理解等级:中级

书中Swagger UI静态页面与JAX-RS生成的JSON/YAML清单分开装配。页面默认请求示例清单,需改为项目真实路径,并让资源@Path与Bean注册对应。

文档页能打开不代表清单能加载;排查时要分别核对静态资源、清单路由和扫描配置。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    原书出处

    参考来源

    - 位置:《高可用可伸缩微服务架构》第4章《Spring Boot/Spring Cloud实践》4.3.3节“基于Swagger的REST API集成”(源文件:OEBPS/Text/chapter009.xhtml;代码图:OEBPS/Images/252_2.jpg、253_1.jpg、253_2.jpg、254_1.jpg、254_2.jpg、255_1.jpg、255_2.jpg) - 结论依据:正文分别说明swagger-ui静态资源和swagger-jaxrs清单资源;原示例页面指向petstore,代码图用自定义`@Path`返回JSON/YAML并注册资源Bean。具体URL和版本仅为书中例子。 - 原始内容:这一块需要根据实际的RESTful接口URL定义规范来进行设置