JDK-8039527 : Broken links in ConcurrentMap javadoc
  • Type: Bug
  • Component: core-libs
  • Sub-Component: java.util
  • Affected Version: 8,9
  • Priority: P3
  • Status: Closed
  • Resolution: Fixed
  • Submitted: 2014-04-08
  • Updated: 2014-12-18
  • Resolved: 2014-04-10
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 8 JDK 9
8u20Fixed 9 b08Fixed
Description
java.util.concurrent.ConcurrentMap contains several broken links to Collection.html#optional-restrictions. See
  http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ConcurrentMap.html

The issue is caused by the use of '{@inheritDoc}' in many '@throws' definitions. ConcurrentMap's superType is Map, is in the java.util package. Map has documentation references to Collection.html, which is in the same package as Map, java.util, but since ConcurrentMap is not in java.util it needs different relative links.
Comments
David, this could be considered an issue with javadoc, but it is difficult to say if relative hrefs should be resolved against the subtypes package hierarchy. Anyway, broken links should be relatively easy to identify, and the fix here is straight forward.
09-04-2014
So the bug is actually in the java.util.Map class, as it specifies the links that become invalid when inherited. Arguably there may be a javadoc issue here too.
09-04-2014
The links with trailing comma is a copy-paste Jira mistake, i have fixed that. The bug is in fact about broken links in ConcurrentMap to the Collection class There are many such broken links there. Here are they: Parent url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/ConcurrentMap.html , Child url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html , Error at line 325 , column 3 , Message: URLError: <urlopen error [Errno 2] No such file or directory: '/var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html'> Parent url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/ConcurrentMap.html , Child url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html , Error at line 592 , column 11 , Message: URLError: <urlopen error [Errno 2] No such file or directory: '/var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html'> Parent url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/ConcurrentMap.html , Child url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html , Error at line 595 , column 11 , Message: URLError: <urlopen error [Errno 2] No such file or directory: '/var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html'> Parent url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/ConcurrentMap.html , Child url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html , Error at line 598 , column 11 , Message: URLError: <urlopen error [Errno 2] No such file or directory: '/var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html'> Parent url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/ConcurrentMap.html , Child url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html , Error at line 667 , column 11 , Message: URLError: <urlopen error [Errno 2] No such file or directory: '/var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html'> Parent url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/ConcurrentMap.html , Child url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html , Error at line 670 , column 11 , Message: URLError: <urlopen error [Errno 2] No such file or directory: '/var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html'> Parent url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/ConcurrentMap.html , Child url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html , Error at line 730 , column 11 , Message: URLError: <urlopen error [Errno 2] No such file or directory: '/var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html'> Parent url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/ConcurrentMap.html , Child url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html , Error at line 733 , column 11 , Message: URLError: <urlopen error [Errno 2] No such file or directory: '/var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html'> Parent url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/ConcurrentMap.html , Child url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html , Error at line 805 , column 11 , Message: URLError: <urlopen error [Errno 2] No such file or directory: '/var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html'> Parent url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/ConcurrentMap.html , Child url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html , Error at line 808 , column 11 , Message: URLError: <urlopen error [Errno 2] No such file or directory: '/var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html'> Parent url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/ConcurrentMap.html , Child url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html , Error at line 881 , column 11 , Message: URLError: <urlopen error [Errno 2] No such file or directory: '/var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html'> Parent url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/ConcurrentMap.html , Child url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html , Error at line 884 , column 11 , Message: URLError: <urlopen error [Errno 2] No such file or directory: '/var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html'> Parent url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/ConcurrentMap.html , Child url: file:///var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html , Error at line 328 , column 3 , Message: URLError: <urlopen error [Errno 2] No such file or directory: '/var/lib/hudson/jobs/JavadocBrokenLinks/workspace/docs/api/java/util/concurrent/Collection.html'>
09-04-2014