system.html

来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 1,156 行 · 第 1/5 页

<A HREF="RuntimePermission.html" title="java.lang 中的类"><CODE>RuntimePermission</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setOut(java.io.PrintStream)"><!-- --></A><H3>
setOut</H3>
<PRE>
public static void <B>setOut</B>(java.io.PrintStream&nbsp;out)</PRE>
<DL>
<DD>重新分配&ldquo;标准&rdquo;输出流。

<p>首先，如果有安全管理器，则通过 <code>RuntimePermission(&quot;setIO&quot;)</code> 权限调用其 <code>checkPermission</code> 方法，查看是否可以重新分配&ldquo;标准&rdquo;输出流。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>out</CODE> - 新的标准输出流
<DT><B>抛出：</B>
<DD><CODE><A HREF="SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果安全管理器存在并且其 <code>checkPermission</code> 方法不允许重新分配标准输出流。<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.1</DD>
<DT><B>另请参见：</B><DD><A HREF="SecurityManager.html#checkPermission(java.security.Permission)"><CODE>SecurityManager.checkPermission(java.security.Permission)</CODE></A>, 
<A HREF="RuntimePermission.html" title="java.lang 中的类"><CODE>RuntimePermission</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setErr(java.io.PrintStream)"><!-- --></A><H3>
setErr</H3>
<PRE>
public static void <B>setErr</B>(java.io.PrintStream&nbsp;err)</PRE>
<DL>
<DD>重新分配&ldquo;标准&rdquo;错误输出流。

<p>首先，如果有安全管理器，则通过 <code>RuntimePermission(&quot;setIO&quot;)</code> 权限调用其 <code>checkPermission</code> 方法，查看是否可以重新分配&ldquo;标准&rdquo;输出流。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>err</CODE> - 新的标准错误输出流
<DT><B>抛出：</B>
<DD><CODE><A HREF="SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果安全管理器存在并且其 <code>checkPermission</code> 方法不允许重新分配标准错误输出流。<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.1</DD>
<DT><B>另请参见：</B><DD><A HREF="SecurityManager.html#checkPermission(java.security.Permission)"><CODE>SecurityManager.checkPermission(java.security.Permission)</CODE></A>, 
<A HREF="RuntimePermission.html" title="java.lang 中的类"><CODE>RuntimePermission</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="inheritedChannel()"><!-- --></A><H3>
inheritedChannel</H3>
<PRE>
public static java.nio.channels.Channel <B>inheritedChannel</B>()
                                                  throws java.io.IOException</PRE>
<DL>
<DD>返回从创建此 Java 虚拟机的实体中继承的信道。

<p> 此方法返回通过调用系统级默认 <CODE>SelectorProvider</CODE> 对象的 <CODE>inheritedChannel</CODE> 方法获得的信道。 </p>

<p> 除了 <CODE>inheritedChannel</CODE> 中描述的面向网络的信道之外，此方法以后还可能返回其他种类的信道。
<P>
<DD><DL>

<DT><B>返回：</B><DD>继承的信道（如果有），否则返回 <tt>null</tt>。
<DT><B>抛出：</B>
<DD><CODE>java.io.IOException</CODE> - 如果发生 I/O 错误
<DD><CODE><A HREF="SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果安全管理器存在并且它不允许访问信道。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="setSecurityManager(java.lang.SecurityManager)"><!-- --></A><H3>
setSecurityManager</H3>
<PRE>
public static void <B>setSecurityManager</B>(<A HREF="SecurityManager.html" title="java.lang 中的类">SecurityManager</A>&nbsp;s)</PRE>
<DL>
<DD>设置系统安全性。

<p> 如果已经安装了安全管理器，则此方法首先通过 <code>RuntimePermission(&quot;setSecurityManager&quot;)</code> 权限调用安全管理器的 <code>checkPermission</code> 方法，以确保可以替换现有的安全管理器。这可能导致抛出一个 <code>SecurityException</code> 异常。

<p> 否则，将该参数作为当前安全管理器建立。如果参数为 <code>null</code> 并且还没有建立安全管理器，则不执行任何操作，并且该方法只是返回。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>s</CODE> - 安全管理器。
<DT><B>抛出：</B>
<DD><CODE><A HREF="SecurityException.html" title="java.lang 中的类">SecurityException</A></CODE> - 如果安全管理器已经设置并且其 <code>checkPermission</code> 方法不允许替换该设置。<DT><B>另请参见：</B><DD><A HREF="System.html#getSecurityManager()"><CODE>getSecurityManager()</CODE></A>, 
<A HREF="SecurityManager.html#checkPermission(java.security.Permission)"><CODE>SecurityManager.checkPermission(java.security.Permission)</CODE></A>, 
<A HREF="RuntimePermission.html" title="java.lang 中的类"><CODE>RuntimePermission</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getSecurityManager()"><!-- --></A><H3>
getSecurityManager</H3>
<PRE>
public static <A HREF="SecurityManager.html" title="java.lang 中的类">SecurityManager</A> <B>getSecurityManager</B>()</PRE>
<DL>
<DD>获得系统安全接口。
<P>
<DD><DL>

<DT><B>返回：</B><DD>如果已经为当前应用程序建立了安全管理器，则返回此安全管理器；否则，返回 <code>null</code>。<DT><B>另请参见：</B><DD><A HREF="System.html#setSecurityManager(java.lang.SecurityManager)"><CODE>setSecurityManager(java.lang.SecurityManager)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="currentTimeMillis()"><!-- --></A><H3>
currentTimeMillis</H3>
<PRE>
public static long <B>currentTimeMillis</B>()</PRE>
<DL>
<DD>返回以毫秒为单位的当前时间。注意，当返回值的时间单位是毫秒时，值的粒度取决于其下层的操作系统，可能会较大。例如，许多操作系统以几十毫秒为单位测量时间。

<p> 请参阅 <code>Date</code> 类的描述，了解可能发生在&ldquo;计算机时间&rdquo;和协调世界时（UTC）之间的细微差异的讨论。
<P>
<DD><DL>

<DT><B>返回：</B><DD>当前时间与协调世界时 1970 年 1 月 1 日午夜之间的时间差（以毫秒为单位测量）。<DT><B>另请参见：</B><DD><A HREF="../util/Date.html" title="java.util 中的类"><CODE>Date</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="nanoTime()"><!-- --></A><H3>
nanoTime</H3>
<PRE>
public static long <B>nanoTime</B>()</PRE>
<DL>
<DD>返回最准确的可用系统计时器的当前值，以毫微秒为单位。

<p>此方法只能用于测量已过的时间，与系统或钟表时间的其他任何时间概念无关。返回值表示从某一固定但任意的时间算起的毫微秒数（或许从以后算起，所以该值可能为负）。此方法提供毫微秒的精度，但不一定就是毫微秒的准确度。不能保证多长时间值会发生更改。取值范围超过约 292 年（2<sup>63</sup> 毫微秒）时，由于发生数值溢出，各连续调用之间的不同将无法准确计算已过的时间。

<p> 例如，测试某些代码执行的时间长度：
 <pre>
   long startTime = System.nanoTime();
   // ... the code being measured ...
   long estimatedTime = System.nanoTime() - startTime;
 </pre>
<P>
<DD><DL>

<DT><B>返回：</B><DD>系统计时器的当前值，以毫微秒为单位。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="arraycopy(java.lang.Object, int, java.lang.Object, int, int)"><!-- --></A><H3>
arraycopy</H3>
<PRE>
public static void <B>arraycopy</B>(<A HREF="Object.html" title="java.lang 中的类">Object</A>&nbsp;src,
                             int&nbsp;srcPos,
                             <A HREF="Object.html" title="java.lang 中的类">Object</A>&nbsp;dest,
                             int&nbsp;destPos,
                             int&nbsp;length)</PRE>
<DL>
<DD>从指定源数组中复制一个数组，复制从指定的位置开始，到目标数组的指定位置结束。从 <code>src</code> 引用的源数组到 <code>dest</code> 引用的目标数组，数组组件的一个子序列被复制下来。被复制的组件数等于 <code>length</code> 参数。源数组中位置在 <code>srcPos</code> 到 <code>srcPos+length-1</code> 之间的组件被分别复制到目标数组中的 <code>destPos</code> 到 <code>destPos+length-1</code> 位置。
 <p>
如果参数 <code>src</code> 和 <code>dest</code> 引用相同的数组对象，则复制的执行过程就好像首先将 <code>srcPos</code> 到 <code>srcPos+length-1</code> 位置的组件复制到一个带有 <code>length</code> 组件的临时数组，然后再将此临时数组的内容复制到目标数组的 <code>destPos</code> 到  <code>destPos+length-1</code> 位置一样。
 <p>
 如果 <code>dest</code> 为 <code>null</code>，则抛出 <code>NullPointerException</code> 异常。
 <p>
如果 <code>src</code> 为 <code>null</code>, 则抛出 <code>NullPointerException</code> 异常，并且不会修改目标数组。
 <p>
否则，只要下列任何情况为真，则抛出 <code>ArrayStoreException</code> 异常并且不会修改目标数组：
 <ul>
<li><code>src</code> 参数指的是非数组对象。
<li><code>dest</code> 参数指的是非数组对象。
<li><code>src</code> 参数和 <code>dest</code> 参数指的是那些其组件类型为不同基本类型的数组。
<li><code>src</code> 参数指的是具有基本组件类型的数组且 <code>dest</code> 参数指的是具有引用组件类型的数组。
 <li><code>src</code> 参数指的是具有引用组件类型的数组且 <code>dest</code> 参数指的是具有基本组件类型的数组。
 </ul>
 <p>
否则，只要下列任何情况为真，则抛出 <code>IndexOutOfBoundsException</code> 异常，并且不会修改目标数组：
 <ul>
<li><code>srcPos</code> 参数为负。
 <li><code>destPos</code> 参数为负。
 <li><code>length</code> 参数为负。
<li><code>srcPos+length</code> 大于 <code>src.length</code>，即源数组的长度。
<li><code>destPos+length</code> 大于 <code>dest.length</code>，即目标数组的长度。
 </ul>
 <p>
否则，如果源数组中 <code>srcPos</code> 到 <code>srcPos+length-1</code> 位置上的实际组件通过分配转换并不能转换成目标数组的组件类型，则抛出 <code>ArrayStoreException</code> 异常。在这种情况下，设 <b><i>k</i></b> 为满足 <code>src[srcPos+</code><i>k</i><code>]</code> 无法被转换为目标数组组件类型的小于 length 的最小非负整数；则当抛出异常时，从 <code>srcPos</code> 到 <code>srcPos+</code><i>k</i><code>-1</code> 位置上的源数组组件已经被复制到目标数组中的 <code>destPos</code> 到 <code>destPos+</code><i>k</I><code>-1</code> 位置，而目标数组中的其他位置不会被修改。（如上已经详细列明的限制，本段说明仅适用于两个数组中组件的类型都为引用类型的组件类型的情况。）
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>src</CODE> - 源数组。<DD><CODE>srcPos</CODE> - 源数组中的起始位置。<DD><CODE>dest</CODE> - 目标数组。<DD><CODE>destPos</CODE> - 目标数据中的起始位置。<DD><CODE>length</CODE> - 要复制的数组元素的数量。
<DT><B>抛出：</B>
<DD><CODE><A HREF="IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果复制会导致对数组范围以外的数据的访问。
<DD><CODE><A HREF="ArrayStoreException.html" title="java.lang 中的类">ArrayStoreException</A></CODE> - 如果因为类型不匹配而使得无法将 <code>src</code> 数组中的元素存储到 <code>dest</code> 数组中。
<DD><CODE><A HREF="NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果 <code>src</code> 或 <code>dest</code> 为 <code>null</code>。</DL>
</DD>
</DL>
<HR>

<A NAME="identityHashCode(java.lang.Object)"><!-- --></A><H3>
identityHashCode</H3>
<PRE>
public static int <B>identityHashCode</B>(<A HREF="Object.html" title="java.lang 中的类">Object</A>&nbsp;x)</PRE>
<DL>
<DD>返回给定对象的哈希代码，该代码与默认的方法 hashCode() 返回的代码一样，无论给定对象的类是否重写 hashCode()。null 引用的哈希代码为零。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>x</CODE> - 要计算其哈希代码的对象
<DT><B>返回：</B><DD>哈希代码<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.1</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getProperties()"><!-- --></A><H3>
getProperties</H3>
<PRE>
public static <A HREF="../util/Properties.html" title="java.util 中的类">Properties</A> <B>getProperties</B>()</PRE>
<DL>
<DD>确定当前的系统属性。
 <p>
首先，如果有安全管理器，则不带参数直接调用其 <code>checkPropertiesAccess</code> 方法。这可能导致一个安全性异常。
 <p>
将 <A HREF="System.html#getProperty(java.lang.String)"><CODE>getProperty(String)</CODE></A> 方法使用的当前系统属性集合作为 <code>Properties</code> 对象返回。如果没有当前系统属性集合，则先创建并初始化一个系统属性集合。这个系统属性集合总是包含以下键的值： 
 <table summary="Shows property keys and associated values">
 <tr><th>键</th>
     <th>相关值的描述</th></tr>
 <tr><td><code>java.version</code></td>
     <td>Java 运行时环境版本</td></tr>
 <tr><td><code>java.vendor</code></td>
     <td>Java 运行时环境供应商</td></tr
 <tr><td><code>java.vendor.url</code></td>
     <td>Java 供应商的 URL</td></tr>
 <tr><td><code>java.home</code></td>
    <td>Java 安装目录</td></tr>
 <tr><td><code>java.vm.specification.version</code></td>
     <td>Java 虚拟机规范版本</td></tr>
 <tr><td><code>java.vm.specification.vendor</code></td>