티스토리 뷰

코드 스니펫 복사
JAVA 이야기

javadoc 사용법



javadoc는 자바 소스 파일에서 주석 부분을 HTML페이지로 작성해 주는 도구이다.

 

JDK 에서 제공되며 /** */ 안의 주석 내용을 HTML로 바꾸어 주는 역할을 한다.

 

/**
     8      * Sorts a Vector of objects.
     9      *
    10      * @param vec the vector
    11      * @param dir true for ascending order, false for descending
    12      * @exception SortArgumentException if vec is null
    13     

*/

 

위와 같은 형태로 작성한다.

 

/** */ 주석 안에서는 @ 태그을 사용하는 것이 가능하다

 

@ 태그 사용법은 다음과 같다.

 

@see  class_name                      : "See also"라는 항목을 만들어 해당 클래스와 연결해준다.
@see  class_name#method_name : "See also"라는 항목을 만들어 특정 메소드와 연결해준다.
@version  text                             : HTML 파일의 버전을 표시하는 항목을 만들어 준다.
@author  text                               : HTML 파일의 저자를 표시하는 항목을 만들어 준다.
@param  name  description           : 특정 메소드가 취하는 파라메터를 기술할 때 사용된다.
@return  description                     : 특정 메소드의 리턴값을 기술할 때 사용된다.
@exception  class_name              : 특정 메소드가 발생시킬 수 있는 예외상황을 기술할 때 사용된다.

공유하기 링크
TAG
댓글
댓글쓰기 폼
공지사항
Total
2,867,706
Today
95
Yesterday
649
«   2018/12   »
            1
2 3 4 5 6 7 8
9 10 11 12 13 14 15
16 17 18 19 20 21 22
23 24 25 26 27 28 29
30 31          
글 보관함