本文介紹了新的javadoc注解@apiNote的處理方法,對大家解決問題具有一定的參考價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)吧!
問題描述
我在LongStream類文檔中發(fā)現(xiàn)了一個新的未記錄的javadoc標(biāo)記。Javadoc標(biāo)記@apiNote似乎用于詳細(xì)說明方法,但沒有關(guān)于該標(biāo)記的文檔或發(fā)行說明。
它的真正目的是什么?其文檔在哪里?
在Reduce method documentation
中可以找到使用@apiNote編譯的javadoc示例
推薦答案
如果不是標(biāo)準(zhǔn)的,我會說他們現(xiàn)在是官方的。請參見JDK-8068562。正如Nicolai上面指出的,他的博客文章New Javadoc Tags @apiNote, @implSpec and @implNote給出了一個很好的概述。它們是supported by Netbeans、supported by IntelliJ和supported by Eclipse。它們在Efficient Java第三版中進(jìn)行了討論和推薦。它們在整個核心Java庫源代碼中使用。
這篇關(guān)于新的javadoc注解@apiNote的文章就介紹到這了,希望我們推薦的答案對大家有所幫助,