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

(un)checked Exceptions, method signatures and @throws Javadoc

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Won't Fix
    • Icon: P4 P4
    • None
    • 5.0
    • xml
    • generic
    • generic

      (un)checked Exceptions, method signatures and @throws Javadoc should conform to Sun standards.

      Josh's Item 44 in "Effective Java" says:
      "Use the Javadoc @throws tag to document each unchecked exception that a method can throw, but do not use the throws keyword to include unchecked exceptions in the method declaration.... The documentation generated by the Javadoc @throws tag in the absence of the method header generated by the throws declaration provides a strong visual cue to help the programmer distinguish check exceptions from unchecked."
      ###@###.### 2004-09-07
      ###@###.### 2004-09-27
      This will be fixed (maybe) in 2.0.

            joehw Joe Wang
            jsuttorsunw Jeff Suttor (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: