สิ่งที่ต้องการ:
/**
* 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แท็ก