{"id":13744,"date":"2019-10-20T05:20:02","date_gmt":"2019-10-20T03:20:02","guid":{"rendered":"http:\/\/blog.wenzlaff.de\/?p=13744"},"modified":"2019-10-19T18:34:25","modified_gmt":"2019-10-19T16:34:25","slug":"swagger-ui-in-5-minuten-auf-einen-raspberry-pi-einem-quarkus-projekt-hinzufuegen","status":"publish","type":"post","link":"http:\/\/blog.wenzlaff.de\/?p=13744","title":{"rendered":"Swagger-UI in 5 Minuten auf einen Raspberry Pi einem Quarkus Projekt hinzuf\u00fcgen!"},"content":{"rendered":"<p>F\u00fcr die Entwicklung von REST APIs ist die Swagger-UI sehr hilfreich.<\/p>\n<p><a href=\"http:\/\/blog.wenzlaff.de\/wp-content\/uploads\/2019\/10\/swagger-ui.png\"><img loading=\"lazy\" decoding=\"async\" src=\"http:\/\/blog.wenzlaff.de\/wp-content\/uploads\/2019\/10\/swagger-ui.png\" alt=\"\" width=\"2922\" height=\"2164\" class=\"aligncenter size-full wp-image-13745\" srcset=\"http:\/\/blog.wenzlaff.de\/wp-content\/uploads\/2019\/10\/swagger-ui.png 2922w, http:\/\/blog.wenzlaff.de\/wp-content\/uploads\/2019\/10\/swagger-ui-300x222.png 300w, http:\/\/blog.wenzlaff.de\/wp-content\/uploads\/2019\/10\/swagger-ui-768x569.png 768w, http:\/\/blog.wenzlaff.de\/wp-content\/uploads\/2019\/10\/swagger-ui-1024x758.png 1024w\" sizes=\"auto, (max-width: 767px) 89vw, (max-width: 1000px) 54vw, (max-width: 1071px) 543px, 580px\" \/><\/a><\/p>\n<p>Ok, dann wollen wir mal in einem <a href=\"http:\/\/blog.wenzlaff.de\/?p=13729\" rel=\"noopener noreferrer\" target=\"_blank\">Quarkus Projekt<\/a> eine Swagger-UI hinzuf\u00fcgen. Das geht mit einem Befehl, da Quarkus einen guten Plugin Mechanismus hat:<\/p>\n<p><strong>.\/mvnw quarkus:add-extension -Dextensions=&#8220;openapi&#8220;<\/strong><\/p>\n<p>Nach 27 Sekunden kommt das Build Success:<\/p>\n<pre class=\"lang:default decode:true \" >[INFO] --- quarkus-maven-plugin:0.24.0:add-extension (default-cli) @ info-kleinhirn ---\r\n\u2705 Adding extension io.quarkus:quarkus-smallrye-openapi\r\n[INFO] ------------------------------------------------------------------------\r\n[INFO] BUILD SUCCESS<\/pre>\n<p>So, das wars schon. Nun noch die Anwendung starten mit <!--more--><\/p>\n<p><strong>.\/mvnw compile quarkus:dev<\/strong><\/p>\n<p>im Log kommt dann:<\/p>\n<pre class=\"lang:default decode:true \" > INFO  [io.quarkus] (main) Installed features: [cdi, resteasy, smallrye-openapi, swagger-ui]<\/pre>\n<p>Also die swagger-ui ist installiert.<\/p>\n<p>Nun starten wir den Browser mit der Swagger-UI \u00fcber:<\/p>\n<p><strong>http:\/\/[PI-Adresse]\/swagger-ui<\/strong><\/p>\n<p><a href=\"http:\/\/blog.wenzlaff.de\/wp-content\/uploads\/2019\/10\/swagger-gui-1.png\"><img loading=\"lazy\" decoding=\"async\" src=\"http:\/\/blog.wenzlaff.de\/wp-content\/uploads\/2019\/10\/swagger-gui-1.png\" alt=\"\" width=\"2736\" height=\"1638\" class=\"aligncenter size-full wp-image-13746\" srcset=\"http:\/\/blog.wenzlaff.de\/wp-content\/uploads\/2019\/10\/swagger-gui-1.png 2736w, http:\/\/blog.wenzlaff.de\/wp-content\/uploads\/2019\/10\/swagger-gui-1-300x180.png 300w, http:\/\/blog.wenzlaff.de\/wp-content\/uploads\/2019\/10\/swagger-gui-1-768x460.png 768w, http:\/\/blog.wenzlaff.de\/wp-content\/uploads\/2019\/10\/swagger-gui-1-1024x613.png 1024w\" sizes=\"auto, (max-width: 767px) 89vw, (max-width: 1000px) 54vw, (max-width: 1071px) 543px, 580px\" \/><\/a><\/p>\n<p>Erste Ergebnisse:<\/p>\n<p><a href=\"http:\/\/blog.wenzlaff.de\/wp-content\/uploads\/2019\/10\/swagger-gui-2.png\"><img loading=\"lazy\" decoding=\"async\" src=\"http:\/\/blog.wenzlaff.de\/wp-content\/uploads\/2019\/10\/swagger-gui-2.png\" alt=\"\" width=\"3082\" height=\"2054\" class=\"aligncenter size-full wp-image-13747\" srcset=\"http:\/\/blog.wenzlaff.de\/wp-content\/uploads\/2019\/10\/swagger-gui-2.png 3082w, http:\/\/blog.wenzlaff.de\/wp-content\/uploads\/2019\/10\/swagger-gui-2-300x200.png 300w, http:\/\/blog.wenzlaff.de\/wp-content\/uploads\/2019\/10\/swagger-gui-2-768x512.png 768w, http:\/\/blog.wenzlaff.de\/wp-content\/uploads\/2019\/10\/swagger-gui-2-1024x682.png 1024w\" sizes=\"auto, (max-width: 767px) 89vw, (max-width: 1000px) 54vw, (max-width: 1071px) 543px, 580px\" \/><\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>F\u00fcr die Entwicklung von REST APIs ist die Swagger-UI sehr hilfreich. Ok, dann wollen wir mal in einem Quarkus Projekt eine Swagger-UI hinzuf\u00fcgen. Das geht mit einem Befehl, da Quarkus einen guten Plugin Mechanismus hat: .\/mvnw quarkus:add-extension -Dextensions=&#8220;openapi&#8220; Nach 27 Sekunden kommt das Build Success: [INFO] &#8212; quarkus-maven-plugin:0.24.0:add-extension (default-cli) @ info-kleinhirn &#8212; \u2705 Adding extension &hellip; <\/p>\n<p class=\"link-more\"><a href=\"http:\/\/blog.wenzlaff.de\/?p=13744\" class=\"more-link\"><span class=\"screen-reader-text\">\u201eSwagger-UI in 5 Minuten auf einen Raspberry Pi einem Quarkus Projekt hinzuf\u00fcgen!\u201c <\/span>weiterlesen<\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[220,5,79,3769,1023,2752],"tags":[2178,2182,3764,2487,3767,3768],"class_list":["post-13744","post","type-post","status-publish","format-standard","hentry","category-anleitung","category-java","category-programmierung","category-quarkus-framework","category-raspberry-pi","category-raspberry-pi-zero-w","tag-java","tag-programmierung","tag-quarkus","tag-rest","tag-swagger","tag-swagger-ui"],"_links":{"self":[{"href":"http:\/\/blog.wenzlaff.de\/index.php?rest_route=\/wp\/v2\/posts\/13744","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/blog.wenzlaff.de\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/blog.wenzlaff.de\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/blog.wenzlaff.de\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"http:\/\/blog.wenzlaff.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=13744"}],"version-history":[{"count":0,"href":"http:\/\/blog.wenzlaff.de\/index.php?rest_route=\/wp\/v2\/posts\/13744\/revisions"}],"wp:attachment":[{"href":"http:\/\/blog.wenzlaff.de\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=13744"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/blog.wenzlaff.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=13744"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/blog.wenzlaff.de\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=13744"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}