JAVA에서 주석 처리 3가지 방법
//
/* */
/** */
(문서화주석)
문서화 주석
문서화 주석은 /**
로 시작해서 */
로 끝나는데 이 문서화 주석을 사용하면 javadoc 이라는 유틸을 사용하여 HTML문서로 저장이 가능하다
즉 프로그램의 문서화를 편하게 할 수 있다
javadoc에서 인식하는 태그는 아래와 같다
Tag | Desc |
---|---|
@author | 작성자 |
@deprecated | 클래스나 멤버가 사장되었는지 지정 |
{@docRoot} | 현문서의 루트 디렉토리 경로 지정 |
@exception | 메소드에서의 예외 확인 |
{@inheritDoc} | 사위 클래스로부터 주석을 상속 |
{@link} | 다른 주제에 관한 인랑니 링크 삽입 |
{@linkplain} | 다른 주제에 관한 인라인 링크 삽입: 링크가 평문 텍스트로 표시 |
@param | 메소드의 매개변수 문서화 |
@return | 메소드의 반환 값 문서화 |
@see | 다른 주제에 관한 링크 지정 |
@serial | 기본 직렬화 필드 문서화 |
@serialData | writeObject()나 writeExteral() 메소드로 기록한 데이터 문서화 |
@serialField | ObjectStreamField 컴포넌트 문서화 |
@since | 특별한 변경사항이 소개될때 릴리즈 기록 |
@throws | 메소드에서의 예외 확인 |
{@value} | static 필드여야 하는 상수값 표시 |
@version | 클래스의 버전 |