Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-4432145

java.util.logging.Logger methods: null reaction needed

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Duplicate
    • Icon: P3 P3
    • None
    • 1.4.0
    • docs
    • sparc
    • solaris_7



      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.

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

            shommel Scott Hommel (Inactive)
            dsvsunw Dsv Dsv (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: