{"id":244,"date":"2023-01-26T11:44:59","date_gmt":"2023-01-26T02:44:59","guid":{"rendered":"https:\/\/hirabay.net\/?p=244"},"modified":"2023-02-13T23:11:56","modified_gmt":"2023-02-13T14:11:56","slug":"controller%e3%81%8b%e3%82%89swagger%e3%82%92%e8%87%aa%e5%8b%95%e7%94%9f%e6%88%90","status":"publish","type":"post","link":"https:\/\/hirabay.net\/?p=244","title":{"rendered":"\u3010springfox\u3011Controller\u304b\u3089swagger\u3092\u81ea\u52d5\u751f\u6210"},"content":{"rendered":"\n<p>swagger\u3092\u4f7f\u7528\u3057\u3066API\u306e\u4ed5\u69d8\u3092\u30c9\u30ad\u30e5\u30e1\u30f3\u30c8\u304b\u3057\u3066\u3044\u308b\u3068\u3001swagger\u306e\u30e1\u30f3\u30c6\u30ca\u30f3\u30b9\u304c\u3055\u308c\u306a\u304f\u306a\u308a\u5b9f\u88c5\u3068\u30c9\u30ad\u30e5\u30e1\u30f3\u30c8\u304c\u30c9\u30f3\u30c9\u30f3\u305a\u308c\u3066\u3044\u304f\u3001\u3001\u3001\u306a\u3093\u3066\u3053\u3068\u826f\u304f\u3042\u308a\u307e\u3059\u3088\u306d\u3002\u3002<\/p>\n\n\n\n<p>\u305d\u3093\u306a\u3068\u304d\u30b3\u30fc\u30c9\u30d9\u30fc\u30b9\u3067swagger\u3092\u81ea\u52d5\u751f\u6210\u3057\u3066\u304f\u308c\u308b<code>springfox<\/code>\u3092\u898b\u3064\u3051\u307e\u3057\u305f\uff01<\/p>\n\n\n\n<p>\u3053\u306e\u8a18\u4e8b\u3067\u306f\u3001\u3067\u304d\u308b\u3060\u3051swagger.yaml\u3092\u624b\u52d5\u3067\u66f8\u3044\u305f\u6642\u3068\u540c\u3058\u30af\u30aa\u30ea\u30c6\u30a3\u306b\u306a\u308b\u3088\u3046<br><code>springfox<\/code>\u306e\u4f7f\u3044\u65b9\u3092\u307e\u3068\u3081\u3066\u3044\u304d\u307e\u3059\uff01<\/p>\n\n\n\n<p>\u25bc\u30e1\u30f3\u30c6\u3055\u308c\u3066\u3044\u308b\u30e9\u30a4\u30d6\u30e9\u30ea\u3092\u4f7f\u3044\u305f\u3044\u5834\u5408\u306f\u3053\u3061\u3089\u3092\u3054\u89a7\u304f\u3060\u3055\u3044<\/p>\n\n\n<a class=\"linkto table\" href=\"https:\/\/hirabay.net\/?p=455\"><span class=\"tbcell tbimg\"><img loading=\"lazy\" decoding=\"async\" width=\"160\" height=\"160\" src=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/02\/SpringBoot-1-160x160.png\" class=\"attachment-thumb-160 size-thumb-160 wp-post-image\" alt=\"\" srcset=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/02\/SpringBoot-1-160x160.png 160w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/02\/SpringBoot-1-150x150.png 150w\" sizes=\"auto, (max-width: 160px) 100vw, 160px\"><\/span><span class=\"tbcell tbtext\"><time class=\"pubdate sng-link-time dfont\" itemprop=\"datePublished\" datetime=\"2023-02-13\">2023\u5e742\u670813\u65e5<\/time>\u3010\u9006\u5f15\u304d\u89e3\u8aac\u3011SpringDoc\u306e\u4f7f\u3044\u65b9<\/span><\/a>\n\n\n<div class=\"toc\"><br \/>\n<b>Warning<\/b>:  Undefined array key \"is_admin\" in <b>\/home\/c4179872\/public_html\/hirabay.net\/wp-content\/themes\/sango-theme\/library\/gutenberg\/dist\/classes\/Toc.php<\/b> on line <b>110<\/b><br \/>\n<br \/>\n<b>Warning<\/b>:  Undefined array key \"is_category_top\" in <b>\/home\/c4179872\/public_html\/hirabay.net\/wp-content\/themes\/sango-theme\/library\/gutenberg\/dist\/classes\/Toc.php<\/b> on line <b>115<\/b><br \/>\n<br \/>\n<b>Warning<\/b>:  Undefined array key \"is_top\" in <b>\/home\/c4179872\/public_html\/hirabay.net\/wp-content\/themes\/sango-theme\/library\/gutenberg\/dist\/classes\/Toc.php<\/b> on line <b>122<\/b><br \/>\n    <div id=\"toc_container\" class=\"sgb-toc--bullets js-smooth-scroll\">\n      <p class=\"toc_title\">\u76ee\u6b21 <\/p>\n      <ul class=\"toc_list\">\n  <li class=\"first\">\n    <a href=\"#i-0\">\u524d\u63d0<\/a>\n  <\/li>\n  <li>\n    <a href=\"#i-1\">\u30b5\u30f3\u30d7\u30ebAPI<\/a>\n  <\/li>\n  <li>\n    <a href=\"#i-2\">springfox\u5c0e\u5165<\/a>\n  <\/li>\n  <li class=\"last\">\n    <a href=\"#i-3\">\u8a73\u7d30\u306a\u8a2d\u5b9a<\/a>\n    <ul class=\"menu_level_1\">\n      <li class=\"first\">\n        <a href=\"#i-4\">\u30c8\u30c3\u30d7\u30da\u30fc\u30b8\u306e\u8a2d\u5b9a<\/a>\n      <\/li>\n      <li>\n        <a href=\"#i-5\">API\u306e\u30bf\u30a4\u30c8\u30eb<\/a>\n      <\/li>\n      <li>\n        <a href=\"#i-6\">\u30a8\u30f3\u30c9\u30dd\u30a4\u30f3\u30c8\u306e\u8aac\u660e\u3092\u5909\u3048\u308b<\/a>\n      <\/li>\n      <li>\n        <a href=\"#i-7\">Model\u306b\u8aac\u660e\u3084\u30b5\u30f3\u30d7\u30eb\u3092\u8ffd\u52a0\u3059\u308b<\/a>\n      <\/li>\n      <li>\n        <a href=\"#i-8\">\u5171\u901a\u306e\u30a8\u30e9\u30fc\u30ec\u30b9\u30dd\u30f3\u30b9\u3092\u8ffd\u52a0\u3059\u308b<\/a>\n      <\/li>\n      <li>\n        <a href=\"#i-9\">\u30a8\u30f3\u30c9\u30dd\u30a4\u30f3\u30c8\u3054\u3068\u306e\u30a8\u30e9\u30fc\u30ec\u30b9\u30dd\u30f3\u30b9\u3092\u8ffd\u52a0\u3059\u308b<\/a>\n      <\/li>\n      <li class=\"last\">\n        <a href=\"#i-10\">\u30af\u30a8\u30ea\u30d1\u30e9\u30e1\u30fc\u30bf\u306b\u8aac\u660e\u3084\u30b5\u30f3\u30d7\u30eb\u3092\u8ffd\u52a0\u3059\u308b<\/a>\n      <\/li>\n    <\/ul>\n  <\/li>\n<\/ul>\n\n      \n    <\/div><\/div><h2 class=\"wp-block-heading\" id=\"i-0\">\u524d\u63d0<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>\u30e9\u30a4\u30d6\u30e9\u30ea<\/th><th>\u30d0\u30fc\u30b8\u30e7\u30f3<\/th><\/tr><\/thead><tbody><tr><td>org.springframework.boot:spring-boot-starter-web<\/td><td>2.4.0<\/td><\/tr><tr><td>org.springframework.boot:spring-boot-starter-validation<\/td><td>2.4.0<\/td><\/tr><tr><td>io.springfox:springfox-boot-starter<\/td><td>3.0.0<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"i-1\">\u30b5\u30f3\u30d7\u30ebAPI<\/h2>\n\n\n\n<p>\u306a\u3093\u3068\u306a\u304f\u30e6\u30fc\u30b6\u30fc\u3092\u767b\u9332\u3059\u308b\u30a8\u30f3\u30c9\u30dd\u30a4\u30f3\u30c8\u3068\u30e6\u30fc\u30b6\u30fc\u3092\u691c\u7d22\u3059\u308b\u30a8\u30f3\u30c9\u30dd\u30a4\u30f3\u30c8\u3092\u7528\u610f\u3057\u307e\u3057\u305f<\/p>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism undefined-numbers lang-java\" data-file=\"SampleController.java\" data-lang=\"Java\"><code>@RestController\n@Validated\npublic class SampleController {\n\n    @PostMapping(value = \"\/sample\",\n            consumes = MediaType.APPLICATION_JSON_VALUE,\n            produces = MediaType.APPLICATION_JSON_VALUE\n    )\n    public void register(@RequestBody @Valid User request) {\n        return;\n    }\n\n    @GetMapping(value = \"\/sample\", produces = MediaType.APPLICATION_JSON_VALUE)\n    public User get(@Pattern(regexp = \"[0-9a-f-]{36}\") String id) {\n        return new User(\"1234567890\", \"hogehoge\", 30);\n    }\n\n    @Value\n    public static class User {\n        @NotNull\n        @Pattern(regexp = \"[0-9a-f-]{36}\")\n        private String id;\n        @NotNull\n        private String name;\n        @NotNull\n        @Min(1L)\n        @Max(100L)\n        private int age;\n    }\n}<\/code><\/pre><\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"i-2\">springfox\u5c0e\u5165<\/h2>\n\n\n\n<p>\u5c0e\u5165\u306f\u30e9\u30a4\u30d6\u30e9\u30ea\u3092\u5165\u308c\u3066Configuration\u30af\u30e9\u30b9\u3092\u5b9f\u88c5\u3059\u308b\u3060\u3051\uff01<\/p>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism undefined-numbers lang-groovy\" data-file=\"build.gradle\" data-lang=\"Groovy\"><code>dependencies {\n    ...\n    \/\/ springfox\u306e\u4f9d\u5b58\u3092\u8ffd\u52a0\u3059\u308b\n    implementation 'io.springfox:springfox-boot-starter:3.0.0'\n}<\/code><\/pre><\/div>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism undefined-numbers lang-java\" data-lang=\"Java\"><code>@Configuration\n@EnableSwagger2\npublic class SwaggerAutoConfiguration {\n}<\/code><\/pre><\/div>\n\n\n\n<p>\u30a2\u30d7\u30ea\u30b1\u30fc\u30b7\u30e7\u30f3\u3092\u8d77\u52d5\u3057\u3066\u3001<br><a rel=\"noreferrer noopener\" href=\"http:\/\/localhost:8080\/swagger-ui\/\" target=\"_blank\">http:\/\/localhost:8080\/swagger-ui\/<\/a><br>\u306b\u30a2\u30af\u30bb\u30b9\u3059\u308b\u3068Swagger\u304c\u8868\u793a\u3055\u308c\u307e\u3059\uff01<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"542\" src=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-6-1024x542.png\" alt=\"\" class=\"wp-image-245\" srcset=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-6-1024x542.png 1024w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-6-300x159.png 300w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-6-768x406.png 768w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-6-940x498.png 940w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-6.png 1400w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\"><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"671\" src=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-7-1024x671.png\" alt=\"\" class=\"wp-image-246\" srcset=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-7-1024x671.png 1024w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-7-300x197.png 300w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-7-768x503.png 768w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-7-940x616.png 940w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-7.png 1400w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\"><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"617\" src=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-8-1024x617.png\" alt=\"\" class=\"wp-image-247\" srcset=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-8-1024x617.png 1024w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-8-300x181.png 300w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-8-768x463.png 768w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-8-940x567.png 940w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-8.png 1400w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\"><\/figure>\n\n\n\n<p>\u3053\u308c\u3060\u3051\u3067\u3082\u7d50\u69cb\u3044\u3044\u611f\u3058\u3067\u3059\u306d\uff01<\/p>\n\n\n\n<p>\u3061\u306a\u307f\u306bValidation\u3082\u53cd\u6620\u3057\u3066\u304f\u308c\u3066\u307e\u3059\ud83d\ude0d<br>\u203b\u3053\u306e\u3042\u3068\u3082\u3046\u5c11\u3057\u30ea\u30c3\u30c1\u306b\u3067\u304d\u307e\u3059<\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-9.png\" alt=\"\" class=\"wp-image-248\" width=\"520\" height=\"278\" srcset=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-9.png 620w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-9-300x161.png 300w\" sizes=\"auto, (max-width: 520px) 100vw, 520px\"><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"i-3\">\u8a73\u7d30\u306a\u8a2d\u5b9a<\/h2>\n\n\n\n<p>\u3053\u3053\u304b\u3089\u306f\u8a2d\u5b9a\u3092\u8ffd\u52a0\u3057\u3066\u3002swagger\u3092\u5145\u5b9f\u3055\u305b\u3066\u3044\u304d\u307e\u3059\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"i-4\">\u30c8\u30c3\u30d7\u30da\u30fc\u30b8\u306e\u8a2d\u5b9a<\/h3>\n\n\n\n<p>\u3042\u308b\u7a0b\u5ea6\u307e\u3068\u3081\u3066\u8a2d\u5b9a\u3092\u5165\u308c\u3066\u307f\u307e\u3059<\/p>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism undefined-numbers lang-java\" data-lang=\"Java\"><code>@Configuration\n@EnableSwagger2\npublic class SwaggerAutoConfiguration {\n    @Bean\n    public Docket api() {\n        return new Docket(DocumentationType.SWAGGER_2)\n                .select()\n                .apis(RequestHandlerSelectors.basePackage(\"&lt;package&gt;\"))\n                .paths(PathSelectors.any())\n                .build()\n                \/\/ 200\u4ee5\u5916\u3067\u30c7\u30d5\u30a9\u30eb\u30c8\u3067\u7528\u610f\u3055\u308c\u3066\u3044\u308b\u30ec\u30b9\u30dd\u30f3\u30b9\u3092\u7121\u52b9\u306b\u3057\u307e\u3059\n                .useDefaultResponseMessages(false)\n                \/\/ \u30d7\u30ed\u30c8\u30b3\u30eb\u3092\u6307\u5b9a\u3057\u307e\u3059\n                .protocols(Collections.singleton(\"https\"))\n                .apiInfo(new ApiInfo(\n                        \/\/ \u30bf\u30a4\u30c8\u30eb\n                        \"springfox\u30b5\u30f3\u30d7\u30eb\",\n                        \/\/ \u8aac\u660e\n                        \"springfox\u306e\u30b5\u30f3\u30d7\u30eb\",\n                        \/\/ \u30c9\u30ad\u30e5\u30e1\u30f3\u30c8\u306e\u30d0\u30fc\u30b8\u30e7\u30f3\n                        \"1.0.0\",\n                        null,\n                        null,\n                        null,\n                        null,\n                        Collections.emptyList()\n                ));\n    }\n}<\/code><\/pre><\/div>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"472\" src=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-10-1024x472.png\" alt=\"\" class=\"wp-image-249\" srcset=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-10-1024x472.png 1024w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-10-300x138.png 300w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-10-768x354.png 768w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-10-940x433.png 940w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-10.png 1400w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\"><\/figure>\n\n\n\n<p>\u3053\u308c\u3067\u60c5\u5831\u304c\u3059\u3063\u304d\u308a\u3057\u307e\u3057\u305f\uff01<\/p>\n\n\n\n<p>\u30d0\u30ea\u30c7\u30fc\u30b7\u30e7\u30f3\u3082\u5c11\u3057\u8868\u73fe\u304c\u5897\u3048\u3066\u3044\u307e\u3059<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"730\" height=\"394\" src=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-11.png\" alt=\"\" class=\"wp-image-250\" srcset=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-11.png 730w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-11-300x162.png 300w\" sizes=\"auto, (max-width: 730px) 100vw, 730px\"><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"i-5\">API\u306e\u30bf\u30a4\u30c8\u30eb<\/h3>\n\n\n\n<p>\u30c7\u30d5\u30a9\u30eb\u30c8\u3060\u3068\u300csample-controller\u300d\u3068\u3001\u30b3\u30f3\u30c8\u30ed\u30fc\u30e9\u30fc\u306e\u30af\u30e9\u30b9\u540d\u304c\u4f7f\u308f\u308c\u3066\u3044\u308b\u306e\u3067\u3053\u308c\u3092\u5909\u66f4\u3057\u3066\u307f\u308b<br>\u2192&nbsp;<code>@Api<\/code>\u30a2\u30ce\u30c6\u30fc\u30b7\u30e7\u30f3\u3067<code>tags<\/code>\u3092\u6307\u5b9a\u3059\u308c\u3070OK<\/p>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism undefined-numbers lang-java\" data-lang=\"Java\"><code>@Api(tags = \"\u30b5\u30f3\u30d7\u30ebAPI\")\n@RestController\n@Validated\npublic class SampleController {\n    ...\n}<\/code><\/pre><\/div>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"i-6\">\u30a8\u30f3\u30c9\u30dd\u30a4\u30f3\u30c8\u306e\u8aac\u660e\u3092\u5909\u3048\u308b<\/h3>\n\n\n\n<p>\u30c7\u30d5\u30a9\u30eb\u30c8\u3060\u3068Controller\u30af\u30e9\u30b9\u306e\u30e1\u30bd\u30c3\u30c9\u540d\u304c\u4f7f\u308f\u308c\u3066\u3044\u305d\u3046\u306a\u306e\u3067\u3053\u308c\u3092\u5909\u66f4\u3057\u3066\u307f\u308b<br>\u2192&nbsp;<code>@ApiOperation<\/code>\u30a2\u30ce\u30c6\u30fc\u30b7\u30e7\u30f3\u3067<code>value<\/code>\u3092\u6307\u5b9a\u3059\u308c\u3070OK<\/p>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism undefined-numbers lang-java\" data-lang=\"Java\"><code>...\n    @ApiOperation(\"\u30e6\u30fc\u30b6\u30fc\u767b\u9332\")\n    @PostMapping(value = \"\/register\",\n            consumes = MediaType.APPLICATION_JSON_VALUE,\n            produces = MediaType.APPLICATION_JSON_VALUE\n    )\n    public void register(@RequestBody @Valid User request) {\n        return;\n    }\n\n    @ApiOperation(\"\u30e6\u30fc\u30b6\u30fc\u691c\u7d22\")\n    @GetMapping(value = \"\/get\", produces = MediaType.APPLICATION_JSON_VALUE)\n    public User get(@Pattern(regexp = \"[0-9a-f-]{36}\") String id) {\n        return new User(\"1234567890\", \"hogehoge\", 30L);\n    }\n...<\/code><\/pre><\/div>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"310\" src=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-12-1024x310.png\" alt=\"\" class=\"wp-image-251\" srcset=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-12-1024x310.png 1024w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-12-300x91.png 300w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-12-768x232.png 768w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-12-940x284.png 940w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-12.png 1058w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\"><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"i-7\">Model\u306b\u8aac\u660e\u3084\u30b5\u30f3\u30d7\u30eb\u3092\u8ffd\u52a0\u3059\u308b<\/h3>\n\n\n\n<p>Model\u30af\u30e9\u30b9\u306e\u5404\u30d5\u30a3\u30fc\u30eb\u30c9\u306b<code>@ApiModelProperty<\/code>\u3092\u4ed8\u4e0e\u3057\u307e\u3059<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>value: \u8aac\u660e<\/li>\n\n\n\n<li>required: \u5fc5\u9808\u304b\u3069\u3046\u304b\n<ul class=\"wp-block-list\">\n<li>\u30c7\u30d5\u30a9\u30eb\u30c8\u304cfalse\u3068\u306a\u3063\u3066\u3044\u3066<\/li>\n\n\n\n<li><code>@NotNull<\/code>\u3088\u308a\u3082\u512a\u5148\u3055\u308c\u3066\u3057\u307e\u3046\u306e\u3067\u660e\u793a\u7684\u306b\u6307\u5b9a\u304c\u5fc5\u8981<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>position: \u8868\u793a\u9806\u5e8f\n<ul class=\"wp-block-list\">\n<li>age\u306e\u4f4d\u7f6e\u304c\u304a\u304b\u3057\u3044\ud83d\ude07<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>example: \u5024\u306e\u30b5\u30f3\u30d7\u30eb<\/li>\n<\/ul>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism undefined-numbers lang-java\" data-lang=\"Java\"><code>    @Value\n    public static class User {\n        @ApiModelProperty(value = \"ID\", required = true, position = 1,\n                example = \"8cdd25ef-b8e4-4964-ab78-2ef5e16b54be\")\n        @NotNull\n        @Pattern(regexp = \"[0-9a-f-]{36}\")\n        private String id;\n\n        @ApiModelProperty(value = \"\u540d\u524d\", required = true, position = 2,\n                example = \"hogehoge\")\n        @NotNull\n        private String name;\n\n        @ApiModelProperty(value = \"\u5e74\u9f62\", required = true, position = 2,\n                example = \"30\")\n        @NotNull\n        @Min(1)\n        @Max(100)\n        private int age;\n    }<\/code><\/pre><\/div>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"592\" height=\"292\" src=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-13.png\" alt=\"\" class=\"wp-image-252\" srcset=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-13.png 592w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-13-300x148.png 300w\" sizes=\"auto, (max-width: 592px) 100vw, 592px\"><\/figure>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"836\" height=\"752\" src=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-14.png\" alt=\"\" class=\"wp-image-253\" srcset=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-14.png 836w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-14-300x270.png 300w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-14-768x691.png 768w\" sizes=\"auto, (max-width: 836px) 100vw, 836px\"><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"i-8\">\u5171\u901a\u306e\u30a8\u30e9\u30fc\u30ec\u30b9\u30dd\u30f3\u30b9\u3092\u8ffd\u52a0\u3059\u308b<\/h3>\n\n\n\n<p>\u4f5c\u6210\u3057\u305f<code>SwaggerAutoConfiguration<\/code>\u306b\u8ffd\u8a18\u3057\u307e\u3059\u3002<\/p>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism undefined-numbers lang-java\" data-lang=\"Java\"><code>.apiInfo(...)\n.globalResponses(HttpMethod.POST, Arrays.asList(\n    new ResponseBuilder()\n        .code(\"400\")\n        .description(\"Bad Request\")\n        .build()));<\/code><\/pre><\/div>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"535\" src=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-15-1024x535.png\" alt=\"\" class=\"wp-image-254\" srcset=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-15-1024x535.png 1024w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-15-300x157.png 300w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-15-768x402.png 768w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-15-940x491.png 940w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-15.png 1400w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\"><\/figure>\n\n\n\n<p>\u30dc\u30c7\u30a3\u306f\u6307\u5b9a\u3067\u304d\u306a\u3044\u2026\u304b\u306a\ud83d\ude07<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"i-9\">\u30a8\u30f3\u30c9\u30dd\u30a4\u30f3\u30c8\u3054\u3068\u306e\u30a8\u30e9\u30fc\u30ec\u30b9\u30dd\u30f3\u30b9\u3092\u8ffd\u52a0\u3059\u308b<\/h3>\n\n\n\n<p><code>@ApiResponses<\/code>\u3068<code>@ApiResponse<\/code>\u3092\u4f7f\u7528\u3057\u307e\u3059<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>code: \u30ec\u30b9\u30dd\u30f3\u30b9\u30b3\u30fc\u30c9<\/li>\n\n\n\n<li>message: \u30a8\u30e9\u30fc\u306e\u6982\u8981<\/li>\n\n\n\n<li>response: \u30ec\u30b9\u30dd\u30f3\u30b9\u306eModel\u30af\u30e9\u30b9<\/li>\n<\/ul>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism undefined-numbers lang-java\" data-lang=\"Java\"><code>    @ApiOperation(\"\u30e6\u30fc\u30b6\u30fc\u767b\u9332\")\n    @PostMapping(value = \"\/register\",\n            consumes = MediaType.APPLICATION_JSON_VALUE,\n            produces = MediaType.APPLICATION_JSON_VALUE\n    )\n    @ApiResponses(value = {\n            @ApiResponse(code = 200, message = \"\u6210\u529f\", response = Void.class),\n            @ApiResponse(code = 500, message = \"\u30b7\u30b9\u30c6\u30e0\u30a8\u30e9\u30fc\", response = ErrorResource.class)\n    })\n    public void register(@RequestBody @Valid User user) {\n        return;\n    }<\/code><\/pre><\/div>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"279\" src=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-16-1024x279.png\" alt=\"\" class=\"wp-image-255\" srcset=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-16-1024x279.png 1024w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-16-300x82.png 300w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-16-768x209.png 768w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-16-940x256.png 940w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-16.png 1400w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\"><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"i-10\">\u30af\u30a8\u30ea\u30d1\u30e9\u30e1\u30fc\u30bf\u306b\u8aac\u660e\u3084\u30b5\u30f3\u30d7\u30eb\u3092\u8ffd\u52a0\u3059\u308b<\/h3>\n\n\n\n<p><code>@ApiParam<\/code>\u30a2\u30ce\u30c6\u30fc\u30b7\u30e7\u30f3\u3092\u4f7f\u7528\u3057\u307e\u3059<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>name: \u30d1\u30e9\u30e1\u30fc\u30bf\u540d\n<ul class=\"wp-block-list\">\n<li>\u6307\u5b9a\u3057\u306a\u3044\u3068\u5f15\u6570\u306e\u540d\u524d\u3092\u305d\u306e\u307e\u307e\u4f7f\u3063\u3066\u304f\u308c\u308b\u306e\u3067\u3001\u51fa\u756a\u306a\u3044\u304b\u3082\uff1f<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>value: \u8aac\u660e<\/li>\n\n\n\n<li>required: \u5fc5\u9808\u304b\u3069\u3046\u304b<\/li>\n\n\n\n<li>example: \u4f8b<\/li>\n<\/ul>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism undefined-numbers lang-java\" data-lang=\"Java\"><code>    @ApiOperation(\"\u30e6\u30fc\u30b6\u30fc\u691c\u7d22\")\n    @GetMapping(value = \"\/get\", produces = MediaType.APPLICATION_JSON_VALUE)\n    public User get(\n            @ApiParam(value = \"\u30e6\u30fc\u30b6\u30fc\u306eID\", required = true, example = \"8cdd25ef-b8e4-4964-ab78-2ef5e16b54be\")\n            @Pattern(regexp = \"[0-9a-f-]{36}\") String id) {\n        return new User(\"1234567890\", \"hogehoge\", 30);\n    }<\/code><\/pre><\/div>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"479\" src=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-17-1024x479.png\" alt=\"\" class=\"wp-image-256\" srcset=\"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-17-1024x479.png 1024w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-17-300x140.png 300w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-17-768x359.png 768w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-17-940x440.png 940w, https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/image-17.png 1116w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\"><\/figure>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>swagger\u3092\u4f7f\u7528\u3057\u3066API\u306e\u4ed5\u69d8\u3092\u30c9\u30ad\u30e5\u30e1\u30f3\u30c8\u304b\u3057\u3066\u3044\u308b\u3068\u3001swagger\u306e\u30e1\u30f3\u30c6\u30ca\u30f3\u30b9\u304c\u3055\u308c\u306a\u304f\u306a\u308a\u5b9f\u88c5\u3068\u30c9\u30ad\u30e5\u30e1\u30f3\u30c8\u304c\u30c9\u30f3\u30c9\u30f3\u305a\u308c\u3066\u3044\u304f\u3001\u3001\u3001\u306a\u3093\u3066\u3053\u3068\u826f\u304f\u3042\u308a\u307e\u3059\u3088\u306d\u3002\u3002 \u305d\u3093\u306a\u3068\u304d\u30b3\u30fc\u30c9\u30d9\u30fc\u30b9\u3067swagger &#8230; <\/p>\n","protected":false},"author":1,"featured_media":257,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[6],"tags":[13,52,32],"class_list":{"0":"post-244","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","7":"category-6","8":"tag-springboot","9":"tag-springfox","10":"tag-32"},"jetpack_featured_media_url":"https:\/\/hirabay.net\/wp-content\/uploads\/2023\/01\/SpringBoot_springfox.png","_links":{"self":[{"href":"https:\/\/hirabay.net\/index.php?rest_route=\/wp\/v2\/posts\/244","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/hirabay.net\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/hirabay.net\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/hirabay.net\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/hirabay.net\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=244"}],"version-history":[{"count":3,"href":"https:\/\/hirabay.net\/index.php?rest_route=\/wp\/v2\/posts\/244\/revisions"}],"predecessor-version":[{"id":475,"href":"https:\/\/hirabay.net\/index.php?rest_route=\/wp\/v2\/posts\/244\/revisions\/475"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/hirabay.net\/index.php?rest_route=\/wp\/v2\/media\/257"}],"wp:attachment":[{"href":"https:\/\/hirabay.net\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=244"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/hirabay.net\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=244"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/hirabay.net\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=244"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}