javadoc中的{@link }和{@linkplain }标簽

簡單記錄一下這兩個标簽的用法。

共同之處：在javadoc文檔中建立一個指向另一份文檔的超連結。

差別：

{@link }将超連結的“位址”當做其文本。如：

此實作繼承了{@link com.sinosig.saab.service.impl.BaseManagerImpl}，以複用其中的dao接口

将顯示為：

最後，此實作繼承了com.sinosig.saab.service.impl.BaseManagerImpl，以複用其中的dao接口

而{@linkplain }标簽除了設定超連結的“位址”之外，還可以設定其文本。格式是：

{@linkplain 位址 文本}，三個字段以空格隔開即可。如

使用方法與 {@linkplain com.sinosig.atip.common.simpledb.web.SimpleDBAction SimpleDBAction} 基本一緻

使用方法與 SimpleDBAction 基本一緻

總的來說，{@link }使用更簡單，{@linkplain }顯示更合理、漂亮。

本文轉自 斯然在天邊 51CTO部落格，原文連結：http://blog.51cto.com/winters1224/875466，如需轉載請自行聯系原作者