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

@since/@throws missing in overridden methods.

XMLWordPrintable

      See current javadoc for java.security.Provider, which has no /** */ code.

      ---begin---
          @Override
          public synchronized Object getOrDefault(Object key, Object defaultValue) {
              checkInitialized();
              return super.getOrDefault(key, defaultValue);
          }
      ---end---

      which outputs:

      ---begin---
      public Object getOrDefault(Object key,
                                 Object defaultValue)

      Description copied from interface: Map
      Returns the value to which the specified key is mapped, or defaultValue if this map contains no mapping for the key.

      Specified by:
          getOrDefault in interface Map<Object,Object>
      Overrides:
          getOrDefault in class Hashtable<Object,Object>
      Parameters:
          key - the key whose associated value is to be returned
          defaultValue - the default mapping of the key
      Returns:
          the value to which the specified key is mapped, or defaultValue if this map contains no mapping for the key
      ---end---

      Note that @since/@throws are missing (there may be more) Users have no idea that this is a new method in Map unless they drill down.

      If this was intentional, why?

            prappo Pavel Rappo
            wetmore Bradford Wetmore
            Votes:
            0 Vote for this issue
            Watchers:
            5 Start watching this issue

              Created:
              Updated:
              Resolved: