Duplicate :
|
Name: sdR10048 Date: 03/30/2001 Javadoc for java.util.logging.Logger methods with reference type arguments does not describe expected reaction when null is passed in. As "Requirements for Writing Java API Specifications" says: (http://java.sun.com/j2se/javadoc/writingapispecs/index.html#method) Method Specification This section applies to Java methods and constructors. Each method and constructor specification must include: ..... 4.Null Argument Values - For each reference type argument, specify the behavior when null is passed in.See two examples. NOTE: If possible, document the general null argument behavior at the package or class level, such as causing a java.lang.NullPointerException to be thrown. Deviations from this behavior can then be documented at the method level. The easy way here could be to specify null reaction on class level. ======================================================================