{"id":10006517,"date":"2022-09-19T15:13:24","date_gmt":"2022-09-19T07:13:24","guid":{"rendered":"https:\/\/ityet.com\/?p=10006517"},"modified":"2022-09-19T15:13:24","modified_gmt":"2022-09-19T07:13:24","slug":"%e5%be%ae%e6%9c%8d%e5%8a%a1%e5%bc%80%e5%8f%91%e7%b3%bb%e5%88%97%ef%bc%9a%e5%88%a9%e7%94%a8-knife4j%ef%bc%8c%e7%94%9f%e6%88%90%e6%9c%80%e9%80%82%e5%90%88%e5%be%ae%e6%9c%8d%e5%8a%a1%e7%9a%84%e6%96%87","status":"publish","type":"post","link":"https:\/\/itmax.cn\/?p=10006517","title":{"rendered":"\u5fae\u670d\u52a1\u5f00\u53d1\u7cfb\u5217\uff1a\u5229\u7528 knife4j\uff0c\u751f\u6210\u6700\u9002\u5408\u5fae\u670d\u52a1\u7684\u6587\u6863"},"content":{"rendered":"

\u6e90\u7801\u5730\u5740<\/a><\/p>\n

swagger \u7684\u4f18\u7f3a\u70b9<\/h2>\n

\u603b\u7ed3\u4e00\u4e0b\u4f18\u70b9\uff1a<\/p>\n

    \n
  1. \u80fd\u591f\u5feb\u901f\u751f\u6210\u6587\u6863<\/li>\n
  2. \u6587\u6863\u80fd\u591f\u8ddf\u968f\u4ee3\u7801\u8fdb\u884c\u53d1\u5e03<\/li>\n
  3. \u5728\u7ebf\u8c03\u8bd5<\/li>\n
  4. \u80fd\u591f\u5feb\u901f\u5206\u4eab\u7ed9\u5176\u4ed6\u4eba\uff0c\u4fdd\u8bc1\u9ad8\u6548<\/li>\n
  5. \u4f7f\u7528\u7684\u4eba\u8db3\u591f\u591a<\/li>\n
  6. \u5468\u8fb9\u63d2\u4ef6\u8db3\u591f\u4e30\u5bcc<\/li>\n<\/ol>\n

    \u8fd9\u4e9b\u4f18\u70b9\u8ba9\u5f88\u591a\u4eba\u5bf9 swagger \u5341\u5206\u8ff7\u4fe1\uff0c\u5305\u62ec\u6211\u81ea\u5df1\uff0c\u4f46\u662f\u5b83\u7684\u5b58\u5728\u5e76\u4e0d\u662f\u90a3\u4e48\u5b8c\u7f8e\uff0c\u5728\u6211\u4f7f\u7528\u8fc7\u7a0b\u4e2d\uff0c\u6211\u8ba4\u4e3a\u6700\u5927\u7684\u95ee\u9898\u5c31\u4e71\u3002<\/p>\n

    \"https:\/\/cdn.nlark.com\/yuque\/0\/2021\/png\/2505339\/1623224761594-f31d46c1-c1a0-4a81-9fd2-d6a4382bc2b3.png#align=left&display=inline&height=365&margin=%5Bobject%20Object%5D&name=image.png&originHeight=1188&originWidth=1402&size=195559&status=done&style=shadow&width=431\"<\/p>\n

    \u4e0a\u56fe\u5c31\u662f\u4e00\u4e2a\u590d\u6742\u4e00\u4e9b\u7684\u65b9\u6cd5\uff0c\u4e24\u8005\u6ce8\u91ca\u7684\u6bd4\u8f83\uff0c\u5f88\u660e\u663e swagger \u66f4\u663e\u5f97\u5570\u55e6\u5f88\u591a\u3002<\/p>\n

    swagger \u867d\u7136\u4e00\u5b9a\u7a0b\u5ea6\u4e0a\u80fd\u591f\u8d77\u5230\u6ce8\u91ca\u52a0\u4e0a\u6587\u6863\u4e24\u8005\u5408\u5e76\u7684\u4f5c\u7528\uff0c\u4f46\u662f\u526f\u4f5c\u7528\u5c31\u662f\uff0c\u4e0e\u4ee3\u7801\u7ea0\u7f20\u5728\u4e00\u8d77\u3002<\/p>\n

    \u8fd9\u4e5f\u5c31\u662f\u8bf4\uff0cswagger \u5bf9\u4ee3\u7801\u7684\u4fb5\u5165\u7a0b\u5ea6\u8fc7\u5927\u3002<\/p>\n

    \u56e0\u6b64\uff0c\u5efa\u8bae\u6df1\u5ea6\u4f7f\u7528 swagger \u8f83\u591a\u7684\u5f00\u53d1\u4eba\u5458\uff0c\u614e\u91cd\u628a\u63e1\u5176\u4e2d\u7684\u590d\u6742\u5ea6\uff0c\u5c3d\u91cf\u505a\u5230\u7cbe\u7b80\u9ad8\u6548\uff0c\u4fdd\u8bc1\u4ee3\u7801\u7684\u53ef\u8bfb\u6027\u3002<\/p>\n

    \u76f8\u6bd4\u8f83\u6765\u8bf4\uff0capigcc<\/a> \u662f\u4e00\u6b3e\u5229\u7528 javadoc \u672c\u8eab\u7684\u6ce8\u91ca\u80fd\u529b\u63d0\u4f9b\u7684\u6587\u6863\u751f\u6210\u5de5\u5177\uff0c\u4f46\u662f\u7f3a\u70b9\u66f4\u4e3a\u660e\u663e\uff0cswagger \u7684\u4f18\u70b9\u5b83\u57fa\u672c\u4e0a\u90fd\u6ca1\u6709\u3002<\/p>\n

    \u6240\u4ee5\u76ee\u524d\u6765\u8bf4\uff0c\u51fa\u4e86 swagger \u4ee5\u5916\uff0c\u8fd8\u771f\u627e\u4e0d\u5230\u66f4\u52a0\u4f18\u79c0\u7684\u6587\u6863\u751f\u6210\u5de5\u5177\u3002<\/p>\n

    swagger \u5728 spring cloud gateway \u4e2d\u4f7f\u7528<\/h2>\n

    swagger \u5728\u5fae\u670d\u52a1\u67b6\u6784\u4e2d\u9047\u5230\u7684\u95ee\u9898\u5c31\u662f\uff0c\u8bbf\u95ee\u4e0d\u540c\u7684\u6a21\u5757\uff0c\u9700\u8981\u901a\u8fc7\u4e0d\u540c\u7684\u5730\u5740\uff0c\u6ca1\u6709\u901a\u8fc7\u7f51\u5173\u7edf\u4e00\u7ba1\u7406\u8d77\u6765\u3002<\/p>\n

    \u5bf9\u6b64\u53ef\u4ee5\u4f7f\u7528\uff0cknife4j<\/a> \u53ef\u4ee5\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\u3002<\/p>\n

    \u914d\u7f6e\u597d\u4e86\u4e4b\u540e\uff0c\u5728\u7cfb\u7edf\u4e2d\uff0c\u53ef\u4ee5\u76f4\u63a5\u901a\u8fc7 http:\/\/ip:port\/doc.html<\/code>\u00a0\u76f4\u63a5\u8bbf\u95ee\u5404\u4e2a\u7cfb\u7edf\u7684\u6587\u6863\u3002<\/p>\n

    \u5173\u952e\u7c7b\u5728 gateway:cn.gateway.core.swagger.SwaggerHandler<\/code> \u548c gateway:cn.gateway.core.swagger.SwaggerResourceConfig<\/code> \u4e2d\uff0c\u8fd9\u4e24\u4e2a\u7c7b\u662f\u56fa\u5b9a\u7684\u3002<\/p>\n

    \u5176\u4f59\u6a21\u5757\u901a\u8fc7\u4f9d\u8d56 framework:cn.framework.config.swagger.SwaggerConfiguration<\/code>\u00a0\u83b7\u5f97 swagger \u7684\u80fd\u529b\uff0c\u8be5\u7c7b\u53ef\u4ee5\u901a\u8fc7\u5224\u65ad\u662f\u5426\u4f9d\u8d56\u4e86 swagger \u7684\u6a21\u5757\uff0c\u6765\u51b3\u5b9a\u662f\u5426\u8fdb\u884c swagger \u7684\u914d\u7f6e\uff0c\u8be5\u7c7b\u80fd\u591f\u81ea\u52a8\u5224\u65ad\u5305\u8def\u5f84\uff0c\u626b\u63cf\u6240\u6709\u7684 swagger \u63a5\u53e3\uff0c\u65e0\u9700\u518d\u8fdb\u884c\u989d\u5916\u7684\u914d\u7f6e\u3002<\/p>\n

    \u6700\u5927\u5316\u5229\u7528 swagger<\/h2>\n

    \u76f8\u5f53\u4e00\u90e8\u5206\u5f00\u53d1\u4eba\u5458\uff0c\u4f7f\u7528 swagger \u65f6\uff0c\u90fd\u53ea\u7559\u4e86\u4e00\u4e2a\u5bf9\u4e8e\u63a5\u53e3\u7684\u63cf\u8ff0\uff0c\u4f46\u662f\u6ca1\u6709\u5229\u7528\u8d77\u6765\u5b83\u5bf9\u4e8e\u53c2\u6570\u63cf\u8ff0\u7684\u80fd\u529b\u3002<\/p>\n

    \u5bf9\u6b64\uff0c\u5efa\u8bae\u66f4\u591a\u7684\u4f7f\u7528 java \u5bf9\u8c61\u4f20\u9012\u53c2\u6570\uff0c\u7136\u540e\u5728\u5bf9\u8c61\u6210\u5458\u5b57\u6bb5\u4e0a\u4f7f\u7528\u6ce8\u89e3 ApiModelProperty<\/code>\uff0c\u8fd9\u6837\u80fd\u591f\u5e2e\u52a9\u4f60\u66f4\u597d\u7684\u5411\u524d\u7aef\u63cf\u8ff0\u4f60\u9700\u8981\u4ec0\u4e48\u53c2\u6570\u4ee5\u53ca\u53c2\u6570\u7684\u542b\u4e49\u3002<\/p>\n

    ApiModelProperty<\/code> \u662f\u53ef\u4ee5\u5d4c\u5957\u4f7f\u7528\u7684\u3002<\/p>\n

    \u8fd9\u79cd\u7528\u6cd5\u4f60\u7edd\u5bf9\u503c\u5f97\u4e00\u8bd5\uff0c\u5728\u6211\u5f00\u53d1\u7684\u8fc7\u7a0b\u4e2d\uff0c\u63d0\u4f9b\u4e86\u975e\u5e38\u7684\u591a\u7684\u5e2e\u52a9\uff0c\u907f\u514d\u4e86\u5927\u91cf\u7684\u4fee\u6539\u63a5\u53e3\u5de5\u4f5c\u91cf\uff0c\u540c\u4e8b\u4e5f\u51cf\u5c11\u4e86\u6c9f\u901a\u4e0a\u7684\u6b67\u4e49\u3002<\/p>\n

    https:\/\/segmentfault.com\/a\/1190000042510109<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

    \u6e90\u7801\u5730\u5740 swagger \u7684\u4f18\u7f3a\u70b9 \u603b\u7ed3\u4e00\u4e0b\u4f18\u70b9\uff1a \u80fd\u591f\u5feb\u901f\u751f\u6210\u6587\u6863 \u6587\u6863\u80fd\u591f\u8ddf\u968f\u4ee3\u7801\u8fdb\u884c\u53d1\u5e03 \u5728\u7ebf\u8c03\u8bd5 \u80fd\u591f […]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[],"tags":[],"class_list":["post-10006517","post","type-post","status-publish","format-standard","hentry"],"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/itmax.cn\/index.php?rest_route=\/wp\/v2\/posts\/10006517","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/itmax.cn\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/itmax.cn\/index.php?rest_route=\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/itmax.cn\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=10006517"}],"version-history":[{"count":0,"href":"https:\/\/itmax.cn\/index.php?rest_route=\/wp\/v2\/posts\/10006517\/revisions"}],"wp:attachment":[{"href":"https:\/\/itmax.cn\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=10006517"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/itmax.cn\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=10006517"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/itmax.cn\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=10006517"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}