Javadoc 만들기 | Javadoc 태그 | @param 태그
@param
태그는 매개 변수에 대한 설명을 표시 할 때 사용한다.
@param parameter-name description
매개 변수에 대한 설명을 표시한다.
작성 위치 : 메소드
중복 작성 : 가능
츌력 형식 : 매개 변수명 및 설명
@author
태그가 중복으로 작성된 경우는 출력 될 때 각각의 저자가 쉼표(,)로 구분하여 한 줄에 모와서 출력된다.
메소드의 매개 변수명과 매개 변수에 대한 설명을 작성한다. 사용 방법는 다음과 같다.
/**
* 주석의 설명문
* @param width 폭
* @param height 높이
*/
```
설명 부분은 여러 줄에 걸쳐 작성 할 수 있다. 여러 줄에 걸쳐있는 것을 표현하는 방법은 특별한 작성법이 있는 것은 아니다.
```java
/**
* 댓글의 설명
* @param width 폭
* width 대한 설명 2번째 줄
* width 대한 설명 3번째 줄
* @param height 높이
*/
실습
간단한 예를 실습해 보도록 하겠다.
/**
* Javadoc 테스트용 클래스
*/
public class Sample11 {
/**
* 사이즈 설정
*
* @param width 폭<br>
* 단위는 센티미터
* @param height 높이
*/
public void setSize(int width, int height) {
}
}
위에 소스 코드를 “Sample11.java"라는 파일명으로 저장하고 저장된 디렉토리에서 다음과 같이 실행한다.
$ javadoc -d doc Sample11.java
생성된 “doc” 디렉토리에 있는 “Sample11.html” 파일을 브라우저로 확인해 보자.
여러 줄로 설명을 작성한 경우도 HTML 문서로 취급되는 것에 주의하자. 줄 바꿈 할 경우 <br>
등의 줄 바꿈에 대한 태그가 필요하다.