JDK-4432145 : java.util.logging.Logger methods: null reaction needed
  • Type: Bug
  • Component: docs
  • Sub-Component: guides
  • Affected Version: 1.4.0
  • Priority: P3
  • Status: Closed
  • Resolution: Duplicate
  • OS: solaris_7
  • CPU: sparc
  • Submitted: 2001-03-30
  • Updated: 2001-07-18
  • Resolved: 2001-07-18
Related Reports
Duplicate :  
Description

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.

======================================================================