classloader.html

j2se5-api-zh,java文档的中文版本

<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>name</CODE> - 资源名称
<DT><B>返回：</B><DD>资源的 <CODE><tt>URL</tt></CODE> 对象的枚举
<DT><B>抛出：</B>
<DD><CODE>java.io.IOException</CODE> - 如果发生 I/O 错误<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getSystemResource(java.lang.String)"><!-- --></A><H3>
getSystemResource</H3>
<PRE>
public static java.net.URL <B>getSystemResource</B>(<A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;name)</PRE>
<DL>
<DD>从用来加载类的搜索路径中查找具有指定名称的资源。此方法通过系统类加载器（参见 <A HREF="ClassLoader.html#getSystemClassLoader()"><CODE>getSystemClassLoader()</CODE></A>）来查找资源。</p>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>name</CODE> - 资源名称
<DT><B>返回：</B><DD>用于读取资源的 <CODE><tt>URL</tt></CODE> 对象，如果找不到资源，则返回 <tt>null</tt><DT><B>从以下版本开始：</B></DT>
  <DD>1.1</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getSystemResources(java.lang.String)"><!-- --></A><H3>
getSystemResources</H3>
<PRE>
public static <A HREF="../util/Enumeration.html" title="java.util 中的接口">Enumeration</A>&lt;java.net.URL&gt; <B>getSystemResources</B>(<A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;name)
                                                    throws java.io.IOException</PRE>
<DL>
<DD>从用来加载类的搜索路径中查找所有具有指定名称的资源。找到的资源作为 <CODE><tt>URL</tt></CODE> 对象的 <A HREF="../util/Enumeration.html" title="java.util 中的接口"><CODE><tt>Enumeration</tt></CODE></A> 返回。

<p> <A HREF="ClassLoader.html#getSystemResource(java.lang.String)"><CODE>getSystemResource(String)</CODE></A> 的文档中描述了搜索顺序。</p>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>name</CODE> - 资源名称
<DT><B>返回：</B><DD>资源 <CODE><tt>URL</tt></CODE> 对象的枚举
<DT><B>抛出：</B>
<DD><CODE>java.io.IOException</CODE> - 如果发生 I/O 错误<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getResourceAsStream(java.lang.String)"><!-- --></A><H3>
getResourceAsStream</H3>
<PRE>
public java.io.InputStream <B>getResourceAsStream</B>(<A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;name)</PRE>
<DL>
<DD>返回读取指定资源的输入流。

<p> <A HREF="ClassLoader.html#getResource(java.lang.String)"><CODE>getResource(String)</CODE></A> 的文档中描述了搜索顺序。</p>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>name</CODE> - 资源名称
<DT><B>返回：</B><DD>用于读取资源的输入流，如果无法找到资源，则返回 <tt>null</tt><DT><B>从以下版本开始：</B></DT>
  <DD>1.1</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getSystemResourceAsStream(java.lang.String)"><!-- --></A><H3>
getSystemResourceAsStream</H3>
<PRE>
public static java.io.InputStream <B>getSystemResourceAsStream</B>(<A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;name)</PRE>
<DL>
<DD>从用来加载类的搜索路径打开具有指定名称的资源，以读取该资源。此方法通过系统类加载器（参见 <A HREF="ClassLoader.html#getSystemClassLoader()"><CODE>getSystemClassLoader()</CODE></A>）来查找资源。</p>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>name</CODE> - 资源名称
<DT><B>返回：</B><DD>用于读取资源的输入流，如果无法找到资源，则返回 <tt>null</tt><DT><B>从以下版本开始：</B></DT>
  <DD>1.1</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getParent()"><!-- --></A><H3>
getParent</H3>
<PRE>
public final <A HREF="ClassLoader.html" title="java.lang 中的类">ClassLoader</A> <B>getParent</B>()</PRE>
<DL>
<DD>返回委托的父类加载器。一些实现可能使用 <tt>null</tt> 来表示引导类加载器。如果类加载器的父类加载器就是引导类加载器，则此方法将在这样的实现中返回 <tt>null</tt>。

<p> 如果存在安全管理器，且调用者的类加载器既不是 <tt>null</tt>，也不是此类加载器的祖先，那么此方法将使用 <A HREF="RuntimePermission.html#RuntimePermission(java.lang.String)"><CODE><tt>RuntimePermission(&quot;getClassLoader&quot;)</tt></CODE></A> 权限调用安全管理器的 <A HREF="SecurityManager.html#checkPermission(java.security.Permission)"><CODE><tt>checkPermission</tt></CODE></A> 方法，以检验是否允许访问该类的父类加载器。如果无此权限，则抛出 <tt>SecurityException</tt> 异常。  </p>
<P>
<DD><DL>

<DT><B>返回：</B><DD>父级 <tt>ClassLoader</tt>
<DT><B>抛出：</B>
<DD><CODE><A HREF="SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果存在安全管理器，并且其 <tt>checkPermission</tt> 方法不允许访问此类加载器的父类加载器。<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getSystemClassLoader()"><!-- --></A><H3>
getSystemClassLoader</H3>
<PRE>
public static <A HREF="ClassLoader.html" title="java.lang 中的类">ClassLoader</A> <B>getSystemClassLoader</B>()</PRE>
<DL>
<DD>返回委托的系统类加载器。该加载器是新的 <tt>ClassLoader</tt> 实例的默认委托父类加载器，通常是用来启动应用程序的类加载器。

<p> 在运行时启动序列的早期首先调用此方法，这时会创建系统类加载器并将其设置为调用 <tt>Thread</tt> 的上下文类加载器。

<p> 默认的系统类加载器是此类的一个与实现有关的实例。

<p> 如果在第一次调用此方法时定义系统属性 "<tt>java.system.class.loader</tt>"，那么该属性的值就是将作为系统类加载器返回的那个类的名称。该类是使用默认系统类加载器进行加载的，它必须定义一个公共的构造方法，此构造方法带有用作委托父类加载器的 <tt>ClassLoader</tt> 类型的单个参数。然后可以使用将默认系统类加载器用作参数的此构造方法创建一个实例。得到的类加载器被定义为系统类加载器。

<p> 如果存在安全管理器，且调用者的类加载器既不是 <tt>null</tt>，也不同于或不是系统类加载器的祖先，那么该方法将使用 <A HREF="RuntimePermission.html#RuntimePermission(java.lang.String)"><CODE><tt>RuntimePermission(&quot;getClassLoader&quot;)</tt></CODE></A> 权限调用安全管理器的 <A HREF="SecurityManager.html#checkPermission(java.security.Permission)"><CODE><tt>checkPermission</tt></CODE></A> 方法，以检验系统类加载器的访问权。如果无此权限，则抛出 <tt>SecurityException</tt> 异常。</p>
<P>
<DD><DL>

<DT><B>返回：</B><DD>委托的系统 <tt>ClassLoader</tt>，如果没有这样的类加载器，则返回 <tt>null</tt>
<DT><B>抛出：</B>
<DD><CODE><A HREF="SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果存在安全管理器，且其 <tt>checkPermission</tt> 方法不允许访问系统类加载器。
<DD><CODE><A HREF="IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果在构造由 "<tt>java.system.class.loader</tt>" 属性指定的类加载器期间进行递归调用。
<DD><CODE><A HREF="Error.html" title="java.lang 中的类">Error</A></CODE> - 如果定义了系统属性 "<tt>java.system.class.loader</tt>"，但是无法加载指定的类，提供者类没有定义所需的构造方法，或者在调用该构造方法时抛出异常。可以通过 <A HREF="Throwable.html#getCause()"><CODE>Throwable.getCause()</CODE></A> 方法找出导致该错误的基本原因。</DL>
</DD>
</DL>
<HR>

<A NAME="definePackage(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.net.URL)"><!-- --></A><H3>
definePackage</H3>
<PRE>
protected <A HREF="Package.html" title="java.lang 中的类">Package</A> <B>definePackage</B>(<A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;name,
                                <A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;specTitle,
                                <A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;specVersion,
                                <A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;specVendor,
                                <A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;implTitle,
                                <A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;implVersion,
                                <A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;implVendor,
                                java.net.URL&nbsp;sealBase)
                         throws <A HREF="IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></PRE>
<DL>
<DD>使用此 <tt>ClassLoader</tt> 中的名称来定义包。这允许类加载器定义用于它们的类的包。包必须在定义类之前创建，包名在类加载器中必须惟一，并且一旦创建就不能重新定义或更改。</p>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>name</CODE> - 包名<DD><CODE>specTitle</CODE> - 规范标题<DD><CODE>specVersion</CODE> - 规范版本<DD><CODE>specVendor</CODE> - 规范供应商<DD><CODE>implTitle</CODE> - 实现标题<DD><CODE>implVersion</CODE> - 实现版本<DD><CODE>implVendor</CODE> - 实现供应商<DD><CODE>sealBase</CODE> - 如果不为 <tt>null</tt>，那么将此包对于给定代码源 <CODE><tt>URL</tt></CODE> 对象是密封的。否则，不密封此包。
<DT><B>返回：</B><DD>新定义的 <tt>Package</tt> 对象
<DT><B>抛出：</B>
<DD><CODE><A HREF="IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果包名与此类加载器或其某个祖先中的现有包的名称重复<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getPackage(java.lang.String)"><!-- --></A><H3>
getPackage</H3>
<PRE>
protected <A HREF="Package.html" title="java.lang 中的类">Package</A> <B>getPackage</B>(<A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;name)</PRE>
<DL>
<DD>返回由此类加载器或其任何祖先所定义的 <tt>Package</tt>。</p>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>name</CODE> - 包名
<DT><B>返回：</B><DD>与给定名称相对应的 <tt>Package</tt>；如果没有这样的包，则返回 <tt>null</tt><DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getPackages()"><!-- --></A><H3>
getPackages</H3>
<PRE>
protected <A HREF="Package.html" title="java.lang 中的类">Package</A>[] <B>getPackages</B>()</PRE>
<DL>
<DD>返回此类加载器及其祖先所定义的所有 <tt>Package</tt>。</p>
<P>
<DD><DL>

<DT><B>返回：</B><DD>此 <tt>ClassLoader</tt> 定义的 <tt>Package</tt> 对象的数组<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="findLibrary(java.lang.String)"><!-- --></A><H3>
findLibrary</H3>
<PRE>
protected <A HREF="String.html" title="java.lang 中的类">String</A> <B>findLibrary</B>(<A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;libname)</PRE>
<DL>
<DD>返回本机库的绝对路径名。虚拟机 (VM) 调用此方法来查找那些属于利用此类加载器加载的类的本机库。如果此方法返回 <tt>null</tt>，则虚拟机沿指定为 "<tt>java.library.path</tt>" 属性的路径搜索该库。</p>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>libname</CODE> - 库名称
<DT><B>返回：</B><DD>本机库的绝对路径<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
<DT><B>另请参见：</B><DD><A HREF="System.html#loadLibrary(java.lang.String)"><CODE>System.loadLibrary(String)</CODE></A>, 
<A HREF="System.html#mapLibraryName(java.lang.String)"><CODE>System.mapLibraryName(String)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setDefaultAssertionStatus(boolean)"><!-- --></A><H3>
setDefaultAssertionStatus</H3>
<PRE>
public void <B>setDefaultAssertionStatus</B>(boolean&nbsp;enabled)</PRE>
<DL>
<DD>设置此类加载器的默认断言状态。此设置确定由此类加载器加载并在将来初始化的类在