개발하는 두더지

[Effective Java 규칙44] 모든 API 요소에 문서화 주석을 달아라Effective Java 2/E 책과 구글링을 통해 내용을 정리하고 개인적인 견해가 포함된 글입니다. 사용할 수 있는 API가 되려면 문서가 있어야 한다. 보통 API 문서를 만들기란 쉽지가 않다. 그러나 Javadoc 이라는 유틸리티를 통해서 API 문서 작업을 쉽게할 수 있다. Javadoc은 문서화 주석( documentation comment )라는 특별한 주석을 통해서 소스 코드로부터 API 문서를 자동으로 생성한다. 좋은 API 문서를 만들려면 API에 포함된 모든 클래스, 인터페이스, 생성자, 메서드, 그리고 필드 선언에 문서화 주석을 달아야 한다. 직렬화 가능 클래스라면 직렬화 형식도 써야한다. 메서드에 대한 ..

[Effective Java 규칙42] varargs는 신중히 사용하라Effective Java 2/E 책과 구글링을 통해 내용을 정리하고 개인적인 견해가 포함된 글입니다. 자바 1.5부터 가변 인자 메서드 ( variable arity method ) 라고 부르는 varargs 메서드가 추가되었다. 이 메서드는 인자를 0개 이상 받을 수 있다. 동작원리는 클라이언트에서 전달된 인자 수에 맞는 배열이 자동으로 생성되고, 모든 인자가 해당 배열에 대입된다. 그리고 해당 배열이 메서드에 인자로 전달된다. 아래는 varargs를 이용한 간단한 샘플이다.public class varargsTest { static int sum(int... args) { int sum = 0; for(int arg : args)..