Details
-
Bug
-
Resolution: Fixed
-
P4
-
None
-
None
Description
The spec for ClassLoader.getParent
https://docs.oracle.com/javase/9/docs/api/java/lang/ClassLoader.html#getParent--
says """Returns the parent class loader for delegation.""" and this makes perfect sense since "for delegation" explains in what sense the returned value is a parent. But that phrase also appears in the spec for
https://docs.oracle.com/javase/9/docs/api/java/lang/ClassLoader.html#getSystemClassLoader--
"""Returns the system class loader for delegation."""
Here this is much less clear. Why not """Returns the system class loader.""" and later also explain that the returned class loader is the default parent for delegation.
It also appears in the spec for
https://docs.oracle.com/javase/9/docs/api/java/lang/ClassLoader.html#getPlatformClassLoader--
"""Returns the platform class loader for delegation."""
and here I have no idea what "for delegation" might mean, except that perhaps this classloader is expected to appear in every delegation chain?
But it's mostly obvious that if you don't delegate to the platform class loader, you will have a hard time starting a real world app. So just """Returns the platform class loader."""
https://docs.oracle.com/javase/9/docs/api/java/lang/ClassLoader.html#getParent--
says """Returns the parent class loader for delegation.""" and this makes perfect sense since "for delegation" explains in what sense the returned value is a parent. But that phrase also appears in the spec for
https://docs.oracle.com/javase/9/docs/api/java/lang/ClassLoader.html#getSystemClassLoader--
"""Returns the system class loader for delegation."""
Here this is much less clear. Why not """Returns the system class loader.""" and later also explain that the returned class loader is the default parent for delegation.
It also appears in the spec for
https://docs.oracle.com/javase/9/docs/api/java/lang/ClassLoader.html#getPlatformClassLoader--
"""Returns the platform class loader for delegation."""
and here I have no idea what "for delegation" might mean, except that perhaps this classloader is expected to appear in every delegation chain?
But it's mostly obvious that if you don't delegate to the platform class loader, you will have a hard time starting a real world app. So just """Returns the platform class loader."""
Attachments
Issue Links
- csr for
-
JDK-8191740 Remove "for delegation" in ClassLoader spec
-
- Closed
-