간만에 javadoc을 사용하여 산출물을 제출해야하는 상황이 되었습니다.

기존에 다른 프로젝트에서 사용하던 formatter가 있어 이를 활용하여 열심히 주석을 작성했습니다.

(다른 개발자 공유하여 같은 형식으로 작성함.)

어느정도 작성이 되어 eclipse에서 javadoc export 하였습니다.

그런데, 결과물이 아래와 같이 좀 이상하더군요.

1. 몇몇 tag가 추가된 주석이 사라지는 현상과

2. Spring Controller method의 @Param 등과 같이 메소드 아규먼트에 annotation이 추가된경우 javadoc html 이 깨지는 현상 ( 문서 밖으로 튕겨져 나감 )

1. 해결 : -tag옵션을 사용합니다. 

tag Description:a:"Description:" -tag Method:a:"Method:" -tag Copyright:a:"Copyright:" 

사용법 : -tag  tagname:Xaoptcmf:"taghead"
X (태그의 무효화)
a (모든 위치)
o (개요)
p (패키지)
t (형태 즉 클래스 및 인터페이스)
c (constructor　 　 )
m (메소드)
f (필드)

2. 일단은 spring sts에서 javadoc compile 하여 해결

  doclet 을 이용하면 될듯 하지만 시간상... 패스

그외 javadoc 활용법은 아래 링크 참조

https://m.blog.naver.com/PostView.nhn?blogId=idtong&logNo=130046468963&proxyReferer=https%3A%2F%2Fwww.google.com%2F

비단 Tomcat 의 catalina.out 뿐만 아니라 모든 생성되는 로그파일에도 적용이 가능한부분입니다.

대부분의 개발에서는 log4j, logback등의 설정을 이용해서 일자별 파일로그를 쌓긴 합니다만

이런 설정이 미적용된 시스템에서는 유용할듯 합니다.

linux의 /etc/logrotated.d/  디렉토리에 가면 시스템에서 관리하는 스케쥴러에 의해 로그를 관리하도록 설정이 가능합니다.

yum, syslog numad 같은 파일이 생성되어 있습니다.

이곳에 tomcat 로그용으로 하나 추가하도록 합니다. 설정은 아래것을 그대로 사용해도 무방할듯 합니다.

/]#cd /etc/logrotated.d

/]#cat > tomcat
 /data/was/tomcat8/logs/catalina.out{
  copytruncate
  daily
  rotate 30
  compress
  missingok
  notifempty
  delaycompress
  dateext
 }

(위에서 내용저장 후 빠져나오는 명령어는 Ctrl + d 입니다. 이후 수정은 vi로 해도 됩니다.)

잘 적용되는제 미리 테스트는 아래와 같이 합니다.

/]#logrotate -f /etc/logrotate.d/tomcat

아래와 같이 로그위치에 일자별 로그파일이 생성되어 있는지 확인합니다.

catalina.out.1 과 같은 형식으로 생성된 것은 dateext 옵션을 뺀 경우임.

그외 apache/logrotate를 활용하는 방법도 있는데, apache가 설치되어 있지 않아 위 방법을 적용.

in Unix : javap -verbose MyClass | grep "major"

in Windows : javap -verbose MyClass | findstr "major"

D:\src\com\test\service\>javap -verbose WorkTest | findstr "major"
Warning: Binary file WorkflowMessage contains com.test.service.WorkTest
  major version: 51

* Major version 참고

51 : jdk1.7

52 : jdk1.8