{"id":4622,"date":"2021-09-06T18:06:12","date_gmt":"2021-09-06T16:06:12","guid":{"rendered":"http:\/\/www.tutego.de\/blog\/javainsel\/?p=4622"},"modified":"2021-09-06T18:06:12","modified_gmt":"2021-09-06T16:06:12","slug":"code-snippets-in-java-api-doku-geplant-jep-413","status":"publish","type":"post","link":"https:\/\/www.tutego.de\/blog\/javainsel\/2021\/09\/code-snippets-in-java-api-doku-geplant-jep-413\/","title":{"rendered":"Code Snippets in Java API Doku geplant (JEP 413)"},"content":{"rendered":"

Interessantes Feature, was die Javadoc doch dicker machen k\u00f6nnte. Geplant:<\/p>\n

\/**\r\n * The following code shows how to use {@code Optional.isPresent}:\r\n * {@snippet :\r\n * if (v.isPresent()) {\r\n *     System.out.println(\"v: \" + v.get());\r\n * }\r\n * }\r\n *\/<\/code>\r\n\r\nInteressant wird das ganze durch Includes (wie bei Asciidoc):<\/pre>\n
\/**\r\n * The following code shows how to use {@code Optional.isPresent}:\r\n * {@snippet file=\"ShowOptional.java\" region=\"example\"}\r\n *\/<\/code><\/pre>\n
Dinge k\u00f6nnen zum Beispiel fett hervorgehoben werden:<\/pre>\n
\/**\r\n * A simple program.\r\n * {@snippet :\r\n * class HelloWorld {\r\n *     public static void main(String... args) {\r\n *         System.out.println(\"Hello World!\");      \/\/ @highlight substring=\"println\"\r\n *     }\r\n * }\r\n * }\r\n *\/<\/code><\/pre>\n
\r\nUnd Texte k\u00f6nnen ersetzt werden:<\/pre>\n
\/**\r\n * A simple program.\r\n * {@snippet :\r\n * class HelloWorld {\r\n *     public static void main(String... args) {\r\n *         System.out.println(\"Hello World!\");  \/\/ @replace regex='\".*\"' replacement=\"...\"\r\n *     }\r\n * }\r\n * }\r\n *\/<\/code><\/pre>\n
Ziemlich wild, w\u00fcrdet ihr so was nutzen f\u00fcr eure Javadoc? Ich nutzte bisher immer Testf\u00e4lle, um eine API zu zeigen und auch zu lernen.<\/p>\n
Zum Weiterlesen: https:\/\/openjdk.java.net\/jeps\/413<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
Interessantes Feature, was die Javadoc doch dicker machen k\u00f6nnte. Geplant: \/** * The following code shows how to use {@code Optional.isPresent}: * {@snippet : * if (v.isPresent()) { * System.out.println(„v: “ + v.get()); * } * } *\/ Interessant wird das ganze durch Includes (wie bei Asciidoc): \/** * The following code shows how to […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":"","_links_to":"","_links_to_target":""},"categories":[1],"tags":[],"class_list":["post-4622","post","type-post","status-publish","format-standard","hentry","category-allgemein"],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/posts\/4622","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/comments?post=4622"}],"version-history":[{"count":1,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/posts\/4622\/revisions"}],"predecessor-version":[{"id":4623,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/posts\/4622\/revisions\/4623"}],"wp:attachment":[{"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/media?parent=4622"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/categories?post=4622"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/tags?post=4622"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}