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

java.util.Properties: Javadoc should mention thread-safety

XMLWordPrintable

    • b86
    • x86
    • linux

      Name: nt126004 Date: 03/06/2002


      FULL PRODUCT VERSION :
      JDK 1.2 - 1.4

      FULL OPERATING SYSTEM VERSION :
      n/a (purely a documentation issue, but the bug form
      requires entering an OS)

      A DESCRIPTION OF THE PROBLEM :
      The documentation for java.util.Properties should
      mention whether or not the class is thread-safe,
      probably as part of the class description.

      The documentation for JDK1.1 specified
      Properties.load and Properties.store as synchronized,
      but the javadoc tool omits 'synchronized' from method
      signatures since 1.2.


      REGRESSION. Last worked in version 1.1.8

      STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
      1. read http://java.sun.com/j2se/1.4/docs/api/java/util/
      Properties.html

      This bug can be reproduced always.

      CUSTOMER WORKAROUND :
      Guess thread-safety from (a) looking at the
      documentation of JDK 1.1, (b) from the fact that
      java.util.Properties is a subclass of the thread-safe
      java.util.Hashtable.
      (Review ID: 139738)
      ======================================================================

            sherman Xueming Shen
            nthompsosunw Nathanael Thompson (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: