jdk-sandbox: comparison jdk/src/share/classes/java/lang/ClassLoader.java

equal deleted inserted replaced

-:fa61a37ed42b
+:c17100862d86
 *             &nbsp;.&nbsp;.&nbsp;.
 *         }
 *     }
 * </pre></blockquote>
 *
-* <h4> <a name="name">Binary names</a> </h4>
+* <h3> <a name="name">Binary names</a> </h3>
 *
 * <p> Any class name provided as a {@link String} parameter to methods in
 * <tt>ClassLoader</tt> must be a binary name as defined by
 * <cite>The Java&trade; Language Specification</cite>.
 *
 * Loads the class with the specified <a href="#name">binary name</a>.
 * This method searches for classes in the same manner as the {@link
 * #loadClass(String, boolean)} method.  It is invoked by the Java virtual
 * machine to resolve class references.  Invoking this method is equivalent
 * to invoking {@link #loadClass(String, boolean) <tt>loadClass(name,
-* false)</tt>}.  </p>
+* false)</tt>}.
 *
 * @param  name
 *         The <a href="#name">binary name</a> of the class
 *
 * @return  The resulting <tt>Class</tt> object
 * Returns the lock object for class loading operations.
 * For backward compatibility, the default implementation of this method
 * behaves as follows. If this ClassLoader object is registered as
 * parallel capable, the method returns a dedicated object associated
 * with the specified class name. Otherwise, the method returns this
-* ClassLoader object. </p>
+* ClassLoader object.
 *
 * @param  className
 *         The name of the to-be-loaded class
 *
 * @return the lock for class loading operations
 * Finds the class with the specified <a href="#name">binary name</a>.
 * This method should be overridden by class loader implementations that
 * follow the delegation model for loading classes, and will be invoked by
 * the {@link #loadClass <tt>loadClass</tt>} method after checking the
 * parent class loader for the requested class.  The default implementation
-* throws a <tt>ClassNotFoundException</tt>.  </p>
+* throws a <tt>ClassNotFoundException</tt>.
 *
 * @param  name
 *         The <a href="#name">binary name</a> of the class
 *
 * @return  The resulting <tt>Class</tt> object
 * <p> An invocation of this method of the form
 * <i>cl</i><tt>.defineClass(</tt><i>name</i><tt>,</tt>
 * <i>bBuffer</i><tt>,</tt> <i>pd</i><tt>)</tt> yields exactly the same
 * result as the statements
 *
-* <blockquote><tt>
+*<p> <tt>
 * ...<br>
-* byte[] temp = new byte[</tt><i>bBuffer</i><tt>.{@link
+* byte[] temp = new byte[bBuffer.{@link
 * java.nio.ByteBuffer#remaining remaining}()];<br>
-*     </tt><i>bBuffer</i><tt>.{@link java.nio.ByteBuffer#get(byte[])
+*     bBuffer.{@link java.nio.ByteBuffer#get(byte[])
 * get}(temp);<br>
 *     return {@link #defineClass(String, byte[], int, int, ProtectionDomain)
-* </tt><i>cl</i><tt>.defineClass}(</tt><i>name</i><tt>, temp, 0,
+* cl.defineClass}(name, temp, 0,
-* temp.length, </tt><i>pd</i><tt>);<br>
+* temp.length, pd);<br>
-* </tt></blockquote>
+* </tt></p>
 *
 * @param  name
 *         The expected <a href="#name">binary name</a>. of the class, or
 *         <tt>null</tt> if not known
 *
 * Links the specified class.  This (misleadingly named) method may be
 * used by a class loader to link a class.  If the class <tt>c</tt> has
 * already been linked, then this method simply returns. Otherwise, the
 * class is linked as described in the "Execution" chapter of
 * <cite>The Java&trade; Language Specification</cite>.
-* </p>
 *
 * @param  c
 *         The class to link
 *
 * @throws  NullPointerException
 /**
 * Returns the class with the given <a href="#name">binary name</a> if this
 * loader has been recorded by the Java virtual machine as an initiating
 * loader of a class with that <a href="#name">binary name</a>.  Otherwise
-* <tt>null</tt> is returned.  </p>
+* <tt>null</tt> is returned.
 *
 * @param  name
 *         The <a href="#name">binary name</a> of the class
 *
 * @return  The <tt>Class</tt> object, or <tt>null</tt> if the class has
 private native final Class<?> findLoadedClass0(String name);
 /**
 * Sets the signers of a class.  This should be invoked after defining a
-* class.  </p>
+* class.
 *
 * @param  c
 *         The <tt>Class</tt> object
 *
 * @param  signers
 return new CompoundEnumeration<>(tmp);
 }
 /**
 * Finds the resource with the given name. Class loader implementations
-* should override this method to specify where to find resources.  </p>
+* should override this method to specify where to find resources.
 *
 * @param  name
 *         The resource name
 *
 * @return  A <tt>URL</tt> object for reading the resource, or
 /**
 * Returns an enumeration of {@link java.net.URL <tt>URL</tt>} objects
 * representing all the resources with the given name. Class loader
 * implementations should override this method to specify where to load
-* resources from.  </p>
+* resources from.
 *
 * @param  name
 *         The resource name
 *
 * @return  An enumeration of {@link java.net.URL <tt>URL</tt>} objects for
 protected Enumeration<URL> findResources(String name) throws IOException {
 return java.util.Collections.emptyEnumeration();
 }
 /**
-* Registers the caller as parallel capable.</p>
+* Registers the caller as parallel capable.
 * The registration succeeds if and only if all of the following
-* conditions are met: <br>
+* conditions are met:
-* 1. no instance of the caller has been created</p>
+* <ol>
-* 2. all of the super classes (except class Object) of the caller are
+* <li> no instance of the caller has been created</li>
-* registered as parallel capable</p>
+* <li> all of the super classes (except class Object) of the caller are
-* Note that once a class loader is registered as parallel capable, there
+* registered as parallel capable</li>
-* is no way to change it back. </p>
+* </ol>
+* <p>Note that once a class loader is registered as parallel capable, there
+* is no way to change it back.</p>
 *
 * @return  true if the caller is successfully registered as
 *          parallel capable and false if otherwise.
 *
 * @since   1.7
 }
 /**
 * Find a resource of the specified name from the search path used to load
 * classes.  This method locates the resource through the system class
-* loader (see {@link #getSystemClassLoader()}).  </p>
+* loader (see {@link #getSystemClassLoader()}).
 *
 * @param  name
 *         The resource name
 *
 * @return  A {@link java.net.URL <tt>URL</tt>} object for reading the
 }
 /**
 * Open for reading, a resource of the specified name from the search path
 * used to load classes.  This method locates the resource through the
-* system class loader (see {@link #getSystemClassLoader()}).  </p>
+* system class loader (see {@link #getSystemClassLoader()}).
 *
 * @param  name
 *         The resource name
 *
 * @return  An input stream for reading the resource, or <tt>null</tt>
 /**
 * Defines a package by name in this <tt>ClassLoader</tt>.  This allows
 * class loaders to define the packages for their classes. Packages must
 * be created before the class is defined, and package names must be
 * unique within a class loader and cannot be redefined or changed once
-* created.  </p>
+* created.
 *
 * @param  name
 *         The package name
 *
 * @param  specTitle
 }
 }
 /**
 * Returns a <tt>Package</tt> that has been defined by this class loader
-* or any of its ancestors.  </p>
+* or any of its ancestors.
 *
 * @param  name
 *         The package name
 *
 * @return  The <tt>Package</tt> corresponding to the given name, or
 return pkg;
 }
 /**
 * Returns all of the <tt>Packages</tt> defined by this class loader and
-* its ancestors.  </p>
+* its ancestors.
 *
 * @return  The array of <tt>Package</tt> objects defined by this
 *          <tt>ClassLoader</tt>
 *
 * @since  1.2
 /**
 * Returns the absolute path name of a native library.  The VM invokes this
 * method to locate the native libraries that belong to classes loaded with
 * this class loader. If this method returns <tt>null</tt>, the VM
 * searches the library along the path specified as the
-* "<tt>java.library.path</tt>" property.  </p>
+* "<tt>java.library.path</tt>" property.
 *
 * @param  libname
 *         The library name
 *
 * @return  The absolute path of the native library
 * Sets the default assertion status for this class loader.  This setting
 * determines whether classes loaded by this class loader and initialized
 * in the future will have assertions enabled or disabled by default.
 * This setting may be overridden on a per-package or per-class basis by
 * invoking {@link #setPackageAssertionStatus(String, boolean)} or {@link
-* #setClassAssertionStatus(String, boolean)}.  </p>
+* #setClassAssertionStatus(String, boolean)}.
 *
 * @param  enabled
 *         <tt>true</tt> if classes loaded by this class loader will
 *         henceforth have assertions enabled by default, <tt>false</tt>
 *         if they will have assertions disabled by default.
 * Sets the default assertion status for this class loader to
 * <tt>false</tt> and discards any package defaults or class assertion
 * status settings associated with the class loader.  This method is
 * provided so that class loaders can be made to ignore any command line or
 * persistent assertion status settings and "start with a clean slate."
-* </p>
 *
 * @since  1.4
 */
 public void clearAssertionStatus() {
 /*

changeset 18776	c17100862d86
parent 18156	edb590d448c5
child 20782	2711da7ccd30
child 20831	96cf18811858