jdk/src/share/classes/java/lang/ClassLoader.java
changeset 9266 121fb370f179
parent 8789 23f273e43be9
child 11117 b6e68b1344d4
equal deleted inserted replaced
9265:62d885310f4d 9266:121fb370f179
   158  * </pre></blockquote>
   158  * </pre></blockquote>
   159  *
   159  *
   160  * <h4> <a name="name">Binary names</a> </h4>
   160  * <h4> <a name="name">Binary names</a> </h4>
   161  *
   161  *
   162  * <p> Any class name provided as a {@link String} parameter to methods in
   162  * <p> Any class name provided as a {@link String} parameter to methods in
   163  * <tt>ClassLoader</tt> must be a binary name as defined by the <a
   163  * <tt>ClassLoader</tt> must be a binary name as defined by
   164  * href="http://java.sun.com/docs/books/jls/">Java Language Specification</a>.
   164  * <cite>The Java&trade; Language Specification</cite>.
   165  *
   165  *
   166  * <p> Examples of valid class names include:
   166  * <p> Examples of valid class names include:
   167  * <blockquote><pre>
   167  * <blockquote><pre>
   168  *   "java.lang.String"
   168  *   "java.lang.String"
   169  *   "javax.swing.JSpinner$DefaultEditor"
   169  *   "javax.swing.JSpinner$DefaultEditor"
   529      * href="#name">binary name</a> as its first argument, and is more secure.
   529      * href="#name">binary name</a> as its first argument, and is more secure.
   530      *
   530      *
   531      * @param  b
   531      * @param  b
   532      *         The bytes that make up the class data.  The bytes in positions
   532      *         The bytes that make up the class data.  The bytes in positions
   533      *         <tt>off</tt> through <tt>off+len-1</tt> should have the format
   533      *         <tt>off</tt> through <tt>off+len-1</tt> should have the format
   534      *         of a valid class file as defined by the <a
   534      *         of a valid class file as defined by
   535      *         href="http://java.sun.com/docs/books/vmspec/">Java Virtual
   535      *         <cite>The Java&trade; Virtual Machine Specification</cite>.
   536      *         Machine Specification</a>.
       
   537      *
   536      *
   538      * @param  off
   537      * @param  off
   539      *         The start offset in <tt>b</tt> of the class data
   538      *         The start offset in <tt>b</tt> of the class data
   540      *
   539      *
   541      * @param  len
   540      * @param  len
   595      *         <tt>null</tt> if not known
   594      *         <tt>null</tt> if not known
   596      *
   595      *
   597      * @param  b
   596      * @param  b
   598      *         The bytes that make up the class data.  The bytes in positions
   597      *         The bytes that make up the class data.  The bytes in positions
   599      *         <tt>off</tt> through <tt>off+len-1</tt> should have the format
   598      *         <tt>off</tt> through <tt>off+len-1</tt> should have the format
   600      *         of a valid class file as defined by the <a
   599      *         of a valid class file as defined by
   601      *         href="http://java.sun.com/docs/books/vmspec/">Java Virtual
   600      *         <cite>The Java&trade; Virtual Machine Specification</cite>.
   602      *         Machine Specification</a>.
       
   603      *
   601      *
   604      * @param  off
   602      * @param  off
   605      *         The start offset in <tt>b</tt> of the class data
   603      *         The start offset in <tt>b</tt> of the class data
   606      *
   604      *
   607      * @param  len
   605      * @param  len
   746      *         <tt>null</tt> if not known
   744      *         <tt>null</tt> if not known
   747      *
   745      *
   748      * @param  b
   746      * @param  b
   749      *         The bytes that make up the class data. The bytes in positions
   747      *         The bytes that make up the class data. The bytes in positions
   750      *         <tt>off</tt> through <tt>off+len-1</tt> should have the format
   748      *         <tt>off</tt> through <tt>off+len-1</tt> should have the format
   751      *         of a valid class file as defined by the <a
   749      *         of a valid class file as defined by
   752      *         href="http://java.sun.com/docs/books/vmspec/">Java Virtual
   750      *         <cite>The Java&trade; Virtual Machine Specification</cite>.
   753      *         Machine Specification</a>.
       
   754      *
   751      *
   755      * @param  off
   752      * @param  off
   756      *         The start offset in <tt>b</tt> of the class data
   753      *         The start offset in <tt>b</tt> of the class data
   757      *
   754      *
   758      * @param  len
   755      * @param  len
   836      *
   833      *
   837      * @param  b
   834      * @param  b
   838      *         The bytes that make up the class data. The bytes from positions
   835      *         The bytes that make up the class data. The bytes from positions
   839      *         <tt>b.position()</tt> through <tt>b.position() + b.limit() -1
   836      *         <tt>b.position()</tt> through <tt>b.position() + b.limit() -1
   840      *         </tt> should have the format of a valid class file as defined by
   837      *         </tt> should have the format of a valid class file as defined by
   841      *         the <a href="http://java.sun.com/docs/books/vmspec/">Java Virtual
   838      *         <cite>The Java&trade; Virtual Machine Specification</cite>.
   842      *         Machine Specification</a>.
       
   843      *
   839      *
   844      * @param  protectionDomain
   840      * @param  protectionDomain
   845      *         The ProtectionDomain of the class, or <tt>null</tt>.
   841      *         The ProtectionDomain of the class, or <tt>null</tt>.
   846      *
   842      *
   847      * @return  The <tt>Class</tt> object created from the data,
   843      * @return  The <tt>Class</tt> object created from the data,
   996 
   992 
   997     /**
   993     /**
   998      * Links the specified class.  This (misleadingly named) method may be
   994      * Links the specified class.  This (misleadingly named) method may be
   999      * used by a class loader to link a class.  If the class <tt>c</tt> has
   995      * used by a class loader to link a class.  If the class <tt>c</tt> has
  1000      * already been linked, then this method simply returns. Otherwise, the
   996      * already been linked, then this method simply returns. Otherwise, the
  1001      * class is linked as described in the "Execution" chapter of the <a
   997      * class is linked as described in the "Execution" chapter of
  1002      * href="http://java.sun.com/docs/books/jls/">Java Language
   998      * <cite>The Java&trade; Language Specification</cite>.
  1003      * Specification</a>.
       
  1004      * </p>
   999      * </p>
  1005      *
  1000      *
  1006      * @param  c
  1001      * @param  c
  1007      *         The class to link
  1002      *         The class to link
  1008      *
  1003      *
  2032      *
  2027      *
  2033      * @param  packageName
  2028      * @param  packageName
  2034      *         The name of the package whose package default assertion status
  2029      *         The name of the package whose package default assertion status
  2035      *         is to be set. A <tt>null</tt> value indicates the unnamed
  2030      *         is to be set. A <tt>null</tt> value indicates the unnamed
  2036      *         package that is "current"
  2031      *         package that is "current"
  2037      *         (<a href="http://java.sun.com/docs/books/jls/">Java Language
  2032      *         (see section 7.4.2 of
  2038      *         Specification</a>, section 7.4.2).
  2033      *         <cite>The Java&trade; Language Specification</cite>.)
  2039      *
  2034      *
  2040      * @param  enabled
  2035      * @param  enabled
  2041      *         <tt>true</tt> if classes loaded by this classloader and
  2036      *         <tt>true</tt> if classes loaded by this classloader and
  2042      *         belonging to the named package or any of its subpackages will
  2037      *         belonging to the named package or any of its subpackages will
  2043      *         have assertions enabled by default, <tt>false</tt> if they will
  2038      *         have assertions enabled by default, <tt>false</tt> if they will