course5.htm

JAVA开发手册,查询JAVASDK的函数!

<p>检取与File对象关联的文件句柄。</p>
<p class="title_2">语法</p>
<p>public int getHandle ()返回值返回该File对象的文件句柄。</p>
<p class="title_2">说明</p>
<p>如果文件已经被关闭，就返回-1。</p>
<p>File.getLength</p>
<p>检取文件的字节数。</p>
<p class="title_2">语法</p>
<p>public long getLength()</p>
<p class="title_2">返回值</p>
<p>返回文件长度。</p>
<p class="title_2">异常</p>
<p>如果不能确定文件的末尾或文件已经被关闭，就产生WinIOException异常消息。</p>
<p>覆盖：DataStream.getLength</p>
<p>请参阅：IByteStream.getLength, setLength</p>
<p>File.getLogicalDrives</p>
<p>检取特定的逻辑驱动器。</p>
<p class="title_2">语法public static String[] getLogicalDrives()。</p>
<p class="title_2">返回值</p>
<p>返回逻辑驱动器。</p>
<p>File.getName</p>
<p>检取指定路径的名字和扩展名。</p>
<p class="title_2">语法</p>
<p>public static String getName ( String path )</p>
<p class="title_2">参数</p>
<p>path文件或目录的路径。</p>
<p class="title_2">返回值</p>
<p>返回指定路径的名字和扩展名。</p>
<p class="title_2">说明</p>
<p>结果包含path参数中最后一个反斜线或冒号后面的路径字符。如果path参数不包括任何反斜线或冒号，则结果就是一个完整的路径。如果path参数是null，则结果字符串也是null。</p>
<p>请参阅：getDirectory, getExtension, getRoot</p>
<p>File.getPosition检取文件当前的位置。</p>
<p class="title_2">语法</p>
<p>public long getPosition()。</p>
<p class="title_2">返回值</p>
<p>返回文档的当前位置。</p>
<p>异常</p>
<p>如果出现I/O错误或文件不允许定位操作，就产生WinIOException异常消息。</p>
<p>覆盖：DataStream.getPosition</p>
<p>请参阅：IByteStream.getPosition, setPosition</p>
<p>File.getRoot</p>
<p>检取指定路径的根目录。</p>
<p class="title_2">语法</p>
<p>public static String getRoot ( String path )</p>
<p class="title_2">参数</p>
<p>path</p>
<p>要测试的路径。</p>
<p class="title_2">返回值</p>
<p>如果路径中反斜线或冒号后面的字符中包括句号，就返回true；否则就返回false。</p>
<p>请参阅：changeExtension, getExtension</p>
<p>File.isDirectory</p>
<p>确定指定的路径是否指向一个目录。</p>
<p class="title_2">语法</p>
<p>public static boolean isDirectory ( String path )</p>
<p class="title_2">参数</p>
<p>path</p>
<p>要测试的路径。</p>
<p class="title_2">返回值</p>
<p>如果路径指向一个目录，就返回true；否则，就返回false。</p>
<p>请参阅：exists, isFile</p>
<p>File.isFile确定所指定的路径是否指向一个文件。</p>
<p class="title_2">语法</p>
<p>public static boolean isFile ( String path )</p>
<p class="title_2">参数</p>
<p>path要测试的路径。</p>
<p class="title_2">返回值</p>
<p>如果路径指向一个文件，就返回true；否则就返回false。</p>
<p>请参阅：exists, isDirectory</p>
<p>File.isRooted</p>
<p>确定指定的路径是否包含根目录。</p>
<p class="title_2">语法</p>
<p>public static boolean isRooted ( String path )</p>
<p class="title_2">参数</p>
<p>path要测试的路径。</p>
<p class="title_2">返回值</p>
<p>如果路径中包含根目录，就返回true；否则，就返回false。</p>
<p class="title_2">说明</p>
<p>如果路径中包含反斜线或驱动器符以及冒号，就认为其包含根目录。</p>
<p>请参阅：getRoot</p>
<p>File.lock</p>
<p>锁住文件中的一个区域。</p>
<p class="title_2">语法</p>
<p>public void lock ( long position, long length )</p>
<p class="title_2">参数</p>
<p>position</p>
<p>要锁住区域的开头部分。</p>
<p>length</p>
<p>要锁住的范围长度。</p>
<p>异常</p>
<p>如果出现错误或文件已经被关闭，就产生WinIOException异常消息。</p>
<p class="title_2">说明</p>
<p>锁住文件的一个区域将使得加锁进程自己独享该区域的访问。在加锁进程创建子进程时，文件锁并不继承。锁住文件的一个区域将使得其他进程不能对该区域进行读写操作。锁住范围如果超出文件的长度，这不算错误。文件中的文件锁不能相互覆盖。</p>
<p>请参阅：unlock</p>
<p>File.open</p>
<p>打开现有的文件进行读写操作。</p>
<p class="title_2">语法</p>
<p>public static File open (String path )</p>
<p class="title_2">参数</p>
<p>path</p>
<p>要打开文件的路径。</p>
<p class="title_2">返回值</p>
<p>返回该打开文件的File对象。异常如果出现错误，就产生WinIOException异常消息。</p>
<p class="title_2">说明</p>
<p>该方法使用FileMode.OPEN, FileAccess.READWRITE和FileShare.NONE标记能很方便地创建新文件。</p>
<p>请参阅：openRead, close</p>
<p>File.openRead</p>
<p>打开现有文件只进行读操作。</p>
<p class="title_2">语法</p>
<p>public static File openRead ( String path )</p>
<p class="title_2">参数</p>
<p>path要打开文件的路径。</p>
<p class="title_2">返回值</p>
<p>返回所打开文件的File对象。异常如果出现错误，就产生WinIOException异常消息。</p>
<p class="title_2">说明</p>
<p>该方法使用FileMode.OPEN, FileAccess.READ和FileShare.READ标记能很方便地创建新文件。</p>
<p>请参阅：open, closeFile.openStandardError打开标准的错误文件。</p>
<p class="title_2">语法</p>
<p>public static File openStandardError ()。</p>
<p class="title_2">返回值</p>
<p>返回标准错误文件的File对象。</p>
<p class="title_2">异常</p>
<p>如果出现错误，就产生WinIOException异常消息。</p>
<p>File.openStandardInput</p>
<p>打开标准的输入文件。</p>
<p class="title_2">语法</p>
<p>public static File openStandardInput ()。</p>
<p class="title_2">返回值</p>
<p>返回标准输入文件的File对象。</p>
<p class="title_2">异常</p>
<p>如果出现错误，就产生WinIOException异常消息。</p>
<p>File.openStandardOutput</p>
<p>打开标准的输出文件。</p>
<p class="title_2">语法</p>
<p>public static File openStandardOutput ()。</p>
<p class="title_2">返回值</p>
<p>返回标准输出文件的File对象。</p>
<p class="title_2">异常</p>
<p>如果出现错误，就产生WinIOException异常消息。</p>
<p>File.read</p>
<p>从文件中读取下一个字节。</p>
<p class="title_2">语法</p>
<p>public int read ()。</p>
<p class="title_2">返回值</p>
<p>从文件中返回下一个字节。</p>
<p>覆盖：DataStream.read</p>
<p>请参阅：IByteStream.read</p>
<p>File.readByte从文件中读取一个字节。</p>
<p class="title_2">语法</p>
<p>public byte readByte ()。</p>
<p class="title_2">返回值</p>
<p>从文件中返回一个字节。</p>
<p>覆盖：DataStream.readByte</p>
<p>请参阅：IDataStream.readByte</p>
<p>File.readChar</p>
<p>从文件中读取一个字符。</p>
<p class="title_2">语法</p>
<p>public char readChar ()。</p>
<p class="title_2">返回值</p>
<p>从文件中返回一个字符。</p>
<p>覆盖：DataStream.readChar</p>
<p>请参阅：IDataStream.readChar</p>
<p>File.readInt</p>
<p>从文件中读取一个整数。</p>
<p class="title_2">语法</p>
<p>public int readInt ()。</p>
<p class="title_2">返回值</p>
<p>从文件中返回一个整数。</p>
<p>覆盖：DataStream.readInt</p>
<p>请参阅：IDataStream.readInt</p>
<p>File.readLong从文件中读取一个长整数。</p>
<p class="title_2">语法</p>
<p>public long readLong ()。</p>
<p class="title_2">返回值</p>
<p>从文件中返回一个长整数。</p>
<p>覆盖：DataStream.readLong</p>
<p>请参阅：IDataStream.readLong</p>
<p>File.readShort</p>
<p>从文件中读取一个短整数。</p>
<p class="title_2">语法</p>
<p>public short readShort ()。</p>
<p class="title_2">返回值</p>
<p>从文件中返回一个短整数。</p>
<p>覆盖：DataStream.readShort</p>
<p>请参阅：IDataStream.readShort</p>
<p>File.removeDirectory</p>
<p>删除现有的空目录。</p>
<p class="title_2">语法</p>
<p>public static void removeDirectory ( String path )</p>
<p class="title_2">参数</p>
<p>path要删除的目录路径。</p>
<p>异常如果出现错误，就产生WinIOException异常消息。</p>
<p class="title_2">说明</p>
<p>该路径必须指向一个空目录，而且调用该方法的进程必须对该目录有访问权限。</p>
<p>请参阅：createDirectory</p>
<p>File.rename将现有文件或目录重新命名。</p>
<p class="title_2">语法</p>
<p>public static void rename ( String curPath, String newPath )</p>
<p class="title_2">参数</p>
<p>curPath</p>
<p>要重新命名的文件或目录的路径。</p>
<p>newPath</p>
<p>文件或目录新路径。</p>
<p>异常</p>
<p>如果出现错误，就产生WinIOException异常消息。</p>
<p class="title_2">说明</p>
<p>curPath参数必须指向一个现有的文件或目录。newPath参数指明新文件名或目录名。新的名字必须是不重复的（即不存在的）。新文件可以位于不同的文件系统或驱动器上。新目录则必须是位于同一驱动器上。</p>
<p>File.setAttributes设置文件的属性。</p>
<p class="title_2">语法</p>
<p>public static void setAttributes ( String path, int attribute )</p>
<p class="title_2">参数</p>
<p>path</p>
<p>要设置属性的文件路径。</p>
<p>attributes</p>
<p>文件的属性。</p>
<p>异常</p>
<p>如果出现错误，就产生WinIOException异常消息。</p>
<p class="title_2">说明</p>
<p>path参数必须指向现有的文件。attributes参数必须是在FileAttributes类中定义的属性标记的组合，这些标记包括：ARCHIVE, HIDDEN,OFFLINE, READONLY, SYSTEM和TEMPORARY。</p>
<p>请参阅：getAttributes</p>
<p>File.setCurrentDirectory</p>
<p>设置当前的目录。</p>
<p class="title_2">语法</p>
<p>public static void setCurrentDirectory ( String path )</p>
<p class="title_2">参数</p>
<p>path</p>
<p>当前新目录的路径。</p>
<p class="title_2">异常</p>
<p>如果出现错误，就产生WinIOException异常消息。</p>
<p class="title_2">说明</p>
<p>path参数必须指明当前新目录的路径。该参数可以是相对路径也可以是全路径。不管哪种情况，都将计算出全路径并作为当前的路径保存起来。</p>
<p>请参阅：getCurrentDirectory</p>
<p>File.setLength</p>
<p>将文件的长度设置为指定的值。</p>
<p class="title_2">语法</p>
<p>public void setLength ( long value )</p>
<p class="title_2">参数</p>
<p>value文件新的长度。</p>
<p class="title_2">异常</p>
<p>如果出现错误或者文件已经被关闭，就产生WinIOException异常消息。</p>
<p class="title_2">说明</p>
<p>如果该值比当前文件的长度小，文件就被截短。如果比当前文件的长度长，文件就被扩展，新老长度之间的文件内容未定义。</p>
<p>请参阅：IByteStream.setLength, getLength</p>
<p>File.setPosition</p>
<p>将文件的当前位置设置为指定的值。</p>
<p class="title_2">语法public void setPosition ( long value )</p>
<p class="title_2">参数</p>
<p>value</p>
<p>文件新的位置。</p>
<p>异常</p>
<p>如果出现错误或者文件已经被关闭，就产生WinIOException异常消息。</p>
<p class="title_2">说明</p>
<p>将文件当前位置设置得比文件本身还长并不算错。</p>
<p>请参阅：IByteStream.setPosition, getPosition</p>
<p>File.unlock</p>
<p>将文件中的区域解锁。</p>
<p class="title_2">语法</p>
<p>public void unlock ( long position, long length )</p>
<p class="title_2">参数</p>
<p>position</p>
<p>要解锁区域的开始部分。</p>
<p>length</p>
<p>要解锁区域的范围。</p>
<p>异常</p>
<p>如果出现错误或者文件已经被关闭，就产生WinIOException异常消息。</p>
<p class="title_2">说明</p>
<p>对一个区域解锁使得其他进程就可以访问该区域了。要解锁的区域必须严格对应已有的加锁区域。例如，两个毗邻的文件区域不能单独加锁然后作为一个区域进行解锁。过程应该解锁到锁住的区域即可，被解锁的文件不应该是被关闭。</p>
<p>请参阅：lock</p>
<p>File.write将一个字节写入文件。</p>
<p class="title_2">语法</p>
<p>public void write ( int value )</p>
<p class="title_2">参数</p>
<p>value</p>
<p>将整数值写入文件中。</p>
<p>覆盖：DataStream.write</p>
<p>请参阅：IByteStream.write</p>
<p>File.writeByte</p>
<p>将一个字节写