สิ่งที่ต้องการ:
/**
* See {@linktourl http://google.com}
*/
สิ่งที่ต้องการ:
/**
* See {@linktourl http://google.com}
*/
คำตอบ:
สิ่งนี้จะสร้างหัวข้อ "ดูเพิ่มเติม" ที่มีลิงก์เช่น:
/**
* @see <a href="http://google.com">http://google.com</a>
*/
จะแสดงผลเป็น:
ดูเพิ่มเติมที่:
http://google.co.th
ในขณะนี้:
/**
* See <a href="http://google.com">http://google.com</a>
*/
จะสร้างลิงค์ในบรรทัด:
<a href="http://google.com" target="_top">http://google.com</a>.
เหตุผลในการเพิ่ม target = "_ top" เป็นเพราะไฟล์ javadoc html ที่สร้างขึ้นบางส่วนใช้ประโยชน์จากเฟรมและคุณอาจต้องการให้การนำทางมีผลต่อทั้งหน้ามากกว่าแค่เฟรมปัจจุบัน
นำมาจากสเป็ค javadoc
@see <a href="URL#value">label</a>
: URL#value
เพิ่มการเชื่อมโยงตามที่กำหนดโดย URL#value
เป็นญาติหรือ URL ที่แน่นอน เครื่องมือ Javadoc แยกความแตกต่างนี้จากกรณีอื่นโดยค้นหาสัญลักษณ์ที่น้อยกว่า ( <
) เป็นอักขระตัวแรก
ตัวอย่างเช่น : @see <a href="http://www.google.com">Google</a>
Javadocs ไม่มีเครื่องมือพิเศษสำหรับลิงก์ภายนอกดังนั้นคุณควรใช้ html มาตรฐาน:
See <a href="http://groversmill.com/">Grover's Mill</a> for a history of the
Martian invasion.
หรือ
@see <a href="http://groversmill.com/">Grover's Mill</a> for a history of
the Martian invasion.
อย่าใช้{@link ...}
หรือ{@linkplain ...}
เพราะสิ่งเหล่านี้ใช้สำหรับลิงก์ไปยัง javadocs ของคลาสและเมธอดอื่น ๆ
เพียงใช้ลิงค์ HTML ที่มีองค์ประกอบเช่น
<a href="URL#value">label</a>
ยากที่จะหาคำตอบที่ชัดเจนจากไซต์ Oracle ต่อไปนี้มาจากjavax.ws.rs.core.HttpHeaders.java
:
/**
* See {@link <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.1">HTTP/1.1 documentation</a>}.
*/
public static final String ACCEPT = "Accept";
/**
* See {@link <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.2">HTTP/1.1 documentation</a>}.
*/
public static final String ACCEPT_CHARSET = "Accept-Charset";
<a>
แท็ก html ด้วยความสำคัญ{@link ...}
คืออะไร
<a>
ไม่ได้พูดถึงรูปแบบนี้มันไม่ได้สร้างความแตกต่างจากดิบ
{@link package.class#member label}
@see
แท็กมาหลังจาก@param
/@return
แท็กและก่อนที่จะ@since
/@serial
/@deprecated
แท็ก