jdk10 换成jdk8_JDK 10的摘要Javadoc标签
jdk10 換成jdk8
JDK 10通過發行JDK-8173425 引入了Javadoc標簽{@summary} (“ Javadoc需要一個新標簽來指定摘要。”)。 這個新標簽允許開發人員顯式指定Javadoc注釋的哪一部分出現在“摘要”中,而不是依靠Javadoc的默認處理來尋找一段時間和空格來劃定注釋的摘要部分的結尾。 JDK-8173425指出:“當前在javadoc中,元素的摘要(firstsentence)通過點空間規則或需要時使用BreakIterator來解密。” 它補充說,知道隱式選擇的摘要句子將是什么可能會令人困惑。
查看{@summary}的最簡單方法可能是通過Javadoc示例。 下一個代碼清單顯示了四種具有相似Javadoc注釋的方法,兩種使用顯式{@summary}標記,兩種依賴于隱式Javadoc摘要構造。
在Javadoc方法注釋中展示{@summary}
package dustin.examples.javadoc;/*** Demonstrate JDK 10 added summary support. Demonstrates* this by comparing similar methods' Javadoc comments with* and without use of new "@summary" tag.*/ public class Summary {/*** This method's first sentence is normally in the summary.* Here are some of its characteristics:* <ul>* <li>This method does great things.</li>* <li>This method does not really do anything.</li>* </ul>*/public void implicitSummary1(){}/*** This method's first sentence is normally in the summary.Here are some of its characteristics:* <ul>* <li>This method does great things.</li>* <li>This method does not really do anything.</li>* </ul>*/public void implicitSummary2(){}/*** {@summary This method's first sentence is normally in the summary.* Here are some of its characteristics:* <ul>* <li>This method does great things.</li>* <li>This method does not really do anything.</li>* </ul>}*/public void explicitSummary1(){}/*** {@summary This method's first sentence is normally in the summary.Here are some of its characteristics:* <ul>* <li>This method does great things.</li>* <li>This method does not really do anything.</li>* </ul>}*/public void explicitSummary2(){} }當針對此簡單類執行第一個JDK 10(18.3)Release Candidate(內部版本43)附帶的Javadoc工具時,在Web瀏覽器中,生成HTML的“ Method Summary ”部分如下所示。
將HTML輸出與上面的注釋Java代碼進行比較,演示了{@summary}如何允許對方法摘要中出現的內容進行顯式控制。
翻譯自: https://www.javacodegeeks.com/2018/02/jdk-10s-summary-javadoc-tag.html
jdk10 換成jdk8
總結
以上是生活随笔為你收集整理的jdk10 换成jdk8_JDK 10的摘要Javadoc标签的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: jbl耳机连接蓝牙方法(JBL蓝牙耳机连
- 下一篇: 类似cs扫描全能王的电脑软件(cs全能扫