Reporter
Reporter (진단 메시지 보고 인터페이스)
진단(diagnostics)과 기타 메시지를 보고하기 위한 인터페이스입니다. 진단은 진단 종류와 메시지로 구성되며, 요소·문서 주석 트리 노드·파일 내 위치와 연결될 수 있습니다.
본문
Reporter는 독렛이 실행 중 만난 경고·오류·정보 메시지를 보고하는 데 사용하는 인터페이스입니다. 각 진단은 진단 종류(kind)와 메시지를 가지며, 선택적으로 관련된 요소(element), 문서 주석의 트리 노드, 또는 특정 파일의 임의 위치와 연결될 수 있습니다.
기타 메시지는 비공식적으로 "표준 출력(standard output)"과 "진단 출력(diagnostic output)"으로 구분되는 두 스트림 중 하나에 직접 쓸 수 있습니다. 여기서 표준 출력은 명령 실행의 기대 결과(예: --help 옵션으로 생성되는 명령줄 도움말)이고, 진단 출력은 실행 부수 효과로 발생하는 오류·경고 기타 출력을 가리킵니다.
진단이 정확히 어떻게 출력되는지는 지정되어 있지 않으며 둘러싼 맥락에 따라 달라집니다. 독렛은 이 인터페이스로 사용자에게 오류와 진행 정보를 전달합니다. StandardDoclet과 독렛 구현이 공통으로 의존하는 보고 채널입니다.