{"id":67,"date":"2024-08-05T12:02:20","date_gmt":"2024-08-05T04:02:20","guid":{"rendered":"https:\/\/note.ui11.cc\/?p=67"},"modified":"2024-08-05T13:47:23","modified_gmt":"2024-08-05T05:47:23","slug":"swagger","status":"publish","type":"post","link":"https:\/\/note.ui11.cc\/index.php\/2024\/08\/05\/swagger\/","title":{"rendered":"swagger"},"content":{"rendered":"\n
\"\"<\/div><\/figure>\n\n\n\n
\u9759\u6001\u8d44\u6e90\u6620\u5c04<\/summary>\n

\u9759\u6001\u8d44\u6e90\u6620\u5c04\uff08Static Resource Mapping\uff09\u662f\u6307\u5728Web\u670d\u52a1\u5668\u6216Web\u5e94\u7528\u6846\u67b6\u4e2d\uff0c\u5c06\u7279\u5b9a\u7684URL\u8def\u5f84\u6620\u5c04\u5230\u670d\u52a1\u5668\u4e0a\u7684\u9759\u6001\u8d44\u6e90\uff08\u5982HTML\u6587\u4ef6\u3001CSS\u6837\u5f0f\u8868\u3001JavaScript\u6587\u4ef6\u3001\u56fe\u7247\u7b49\uff09\u7684\u8fc7\u7a0b\u3002\u8fd9\u79cd\u6620\u5c04\u5141\u8bb8Web\u670d\u52a1\u5668\u76f4\u63a5\u63d0\u4f9b\u8fd9\u4e9b\u9759\u6001\u6587\u4ef6\uff0c\u800c\u4e0d\u9700\u8981\u901a\u8fc7\u5e94\u7528\u670d\u52a1\u5668\u7684\u4e1a\u52a1\u903b\u8f91\u5904\u7406\u3002<\/p>\n\n\n\n

\u9759\u6001\u8d44\u6e90\u6620\u5c04\u7684\u4e3b\u8981\u76ee\u7684\u662f\u63d0\u9ad8Web\u5e94\u7528\u7684\u6027\u80fd\u548c\u54cd\u5e94\u901f\u5ea6\u3002\u7531\u4e8e\u9759\u6001\u8d44\u6e90\u901a\u5e38\u4e0d\u9700\u8981\u670d\u52a1\u5668\u7aef\u7684\u52a8\u6001\u5904\u7406\uff0c\u76f4\u63a5\u63d0\u4f9b\u8fd9\u4e9b\u8d44\u6e90\u53ef\u4ee5\u51cf\u5c11\u670d\u52a1\u5668\u7684\u8ba1\u7b97\u8d1f\u62c5\uff0c\u52a0\u5feb\u8d44\u6e90\u7684\u52a0\u8f7d\u65f6\u95f4\u3002<\/p>\n\n\n\n

\u5728\u4e0d\u540c\u7684Web\u670d\u52a1\u5668\u548c\u6846\u67b6\u4e2d\uff0c\u9759\u6001\u8d44\u6e90\u6620\u5c04\u7684\u5b9e\u73b0\u65b9\u5f0f\u53ef\u80fd\u6709\u6240\u4e0d\u540c\u3002\u4f8b\u5982\uff1a<\/p>\n\n\n\n

    \n
  • \u5728Apache\u6216Nginx\u8fd9\u6837\u7684Web\u670d\u52a1\u5668\u4e2d\uff0c\u53ef\u4ee5\u901a\u8fc7\u914d\u7f6e\u6587\u4ef6\uff08\u5982Apache\u7684.htaccess<\/code>\u6587\u4ef6\u6216Nginx\u7684\u914d\u7f6e\u6587\u4ef6\uff09\u6765\u8bbe\u7f6e\u9759\u6001\u8d44\u6e90\u7684\u6620\u5c04\u89c4\u5219\u3002<\/li>\n\n\n\n
  • \u5728Java\u7684Spring\u6846\u67b6\u4e2d\uff0c\u53ef\u4ee5\u4f7f\u7528@RequestMapping<\/code>\u6216@GetMapping<\/code>\u7b49\u6ce8\u89e3\u6765\u6620\u5c04\u9759\u6001\u8d44\u6e90\u7684\u8def\u5f84\u3002<\/li>\n\n\n\n
  • \u5728Node.js\u7684Express\u6846\u67b6\u4e2d\uff0c\u53ef\u4ee5\u4f7f\u7528express.static<\/code>\u4e2d\u95f4\u4ef6\u6765\u63d0\u4f9b\u9759\u6001\u6587\u4ef6\u670d\u52a1\u3002<\/li>\n<\/ul>\n\n\n\n

    \u9759\u6001\u8d44\u6e90\u6620\u5c04\u7684\u4e00\u4e2a\u7b80\u5355\u793a\u4f8b\uff1a\/\/ \u5728Spring\u6846\u67b6\u4e2d\uff0c\u4f7f\u7528\u9759\u6001\u8d44\u6e90\u6620\u5c04 @Configuration public class WebConfig implements WebMvcConfigurer { @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(\"\/static\/**\") .addResourceLocations(\"\/static\/\"); } }<\/code>\u5728\u8fd9\u4e2a\u4f8b\u5b50\u4e2d\uff0c\u6240\u6709\u4ee5\/static\/\u5f00\u5934\u7684URL\u8bf7\u6c42\u90fd\u4f1a\u6620\u5c04\u5230\u670d\u52a1\u5668\u4e0a\u7684\/static\/\u76ee\u5f55\uff0c\u4ece\u800c\u76f4\u63a5\u63d0\u4f9b\u8be5\u76ee\u5f55\u4e0b\u7684\u9759\u6001\u8d44\u6e90<\/p>\n\n\n\n

    <\/p>\n<\/details>\n\n\n\n

    \u4f7f\u7528knife4j\u6846\u67b6\u662f\u9700\u8981\u6ce8\u610f<\/p>\n\n\n\n

    1\uff1a\u5305\u540d\u4e0d\u8981\u586b\u9519<\/p>\n\n\n\n

    \"\"<\/div><\/figure>\n\n\n\n

    2\uff1a\u8bbe\u7f6e\u9759\u6001\u8d44\u6e90\u65f6\uff0c\u8def\u5f84\u4e0d\u8981\u641e\u9519<\/p>\n\n\n\n

    \"\"<\/div><\/figure>\n\n\n\n

    \u901a\u8fc7Swagger\u5c31\u53ef\u4ee5\u751f\u6210\u63a5\u53e3\u6587\u6863\uff0c\u90a3\u4e48\u6211\u4eec\u5c31\u4e0d\u9700\u8981Yapi\u4e86\uff1f<\/p>\n\n\n\n

    \"\"<\/div><\/figure>\n\n\n\n
    Swagger\u5e38\u7528\u6ce8\u89e3<\/summary>\n

    @API<\/p>\n\n\n\n

    \"\"<\/div><\/figure>\n\n\n\n

    @ApiOperation<\/p>\n\n\n\n

    \"\"<\/div><\/figure>\n\n\n\n
    \"\"<\/div><\/figure>\n\n\n\n

    property:\u5c5e\u6027<\/p>\n\n\n\n

    @ApiModelProperty<\/p>\n\n\n\n

    \"\"<\/div><\/figure>\n\n\n\n

    @ApiModel<\/p>\n\n\n\n

    \"\"<\/div><\/figure>\n\n\n<\/details>\n\n\n\n

    <\/p>\n\n\n\n

    <\/p>\n\n\n\n

    <\/p>\n\n\n\n

    <\/p>\n\n\n\n

    <\/p>\n\n\n\n

    <\/p>\n","protected":false},"excerpt":{"rendered":"

    \u4f7f\u7528knife4j\u6846\u67b6\u662f\u9700\u8981\u6ce8\u610f 1\uff1a\u5305\u540d\u4e0d\u8981\u586b\u9519 2\uff1a\u8bbe\u7f6e\u9759\u6001\u8d44\u6e90\u65f6\uff0c\u8def\u5f84\u4e0d\u8981\u641e\u9519 \u901a\u8fc7Swagger\u5c31\u53ef\u4ee5 […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4],"tags":[],"class_list":["post-67","post","type-post","status-publish","format-standard","hentry","category-4"],"_links":{"self":[{"href":"https:\/\/note.ui11.cc\/index.php\/wp-json\/wp\/v2\/posts\/67","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/note.ui11.cc\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/note.ui11.cc\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/note.ui11.cc\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/note.ui11.cc\/index.php\/wp-json\/wp\/v2\/comments?post=67"}],"version-history":[{"count":7,"href":"https:\/\/note.ui11.cc\/index.php\/wp-json\/wp\/v2\/posts\/67\/revisions"}],"predecessor-version":[{"id":96,"href":"https:\/\/note.ui11.cc\/index.php\/wp-json\/wp\/v2\/posts\/67\/revisions\/96"}],"wp:attachment":[{"href":"https:\/\/note.ui11.cc\/index.php\/wp-json\/wp\/v2\/media?parent=67"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/note.ui11.cc\/index.php\/wp-json\/wp\/v2\/categories?post=67"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/note.ui11.cc\/index.php\/wp-json\/wp\/v2\/tags?post=67"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}