course5.htm

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

<p>value要写入的字符串。</p>
<p class="title_2">说明</p>
<p>该方法实现了IDataStream.writeStringCharsAnsi方法。</p>
<p>DataStream.writeStringNull</p>
<p>向数据流中写入以null结尾的单一码字符串。</p>
<p class="title_2">语法</p>
<p>public void writeStringNull ( String value )</p>
<p class="title_2">参数</p>
<p>value要写入的字符串。</p>
<p class="title_2">说明</p>
<p>该方法实现了IDataStream.writeStringNull方法。</p>
<p>DataStream.writeStringNullAnsi</p>
<p>向数据流中写入以null结尾的ANSI字符串。</p>
<p class="title_2">语法</p>
<p>public void writeStringNullAnsi( String value )</p>
<p class="title_2">参数</p>
<p>value要写入的字符串。</p>
<p class="title_2">说明</p>
<p>该方法实现了IDataStream.writeStringNullAnsi方法。DataStream.writeUTF使用预定长UTF-8格式向数据流中写入字符串。</p>
<p class="title_2">语法</p>
<p>public void writeUTF( String value )</p>
<p class="title_2">参数</p>
<p>value</p>
<p>要写入的字符串。</p>
<p class="title_2">说明</p>
<p>该方法实现了IDataStream.writeUTF方法。</p>
<hr><p class="title_1"><a name="EOFException类">EOFException类</a></p>
<p>表示EOF(End-of-File)异常。</p>
<pre>IOException
  |
  +-- EOFException</pre>
<p>package com.ms.wfc.io</p>
<p>public class EOFException</p>
<p>extends IOException</p>
<p class="title_2">说明</p>
<p>当数据还没有完全读完就到了数据流的末尾时，IDataStream实现的read方法就产生该异常消息。</p>
<p class="title_2">构造器</p>
<p>EOFException.EOFException</p>
<p>创建一个EOFException对象。</p>
<p class="title_2">语法</p>
<p>public EOFException()public EOFException( String s )</p>
<p class="title_2">参数</p>
<p>s</p>
<p>当产生异常时要显示的文本信息。如果没有传递文本内容，就显示缺省的消息。</p>
<hr><p class="title_1"><a name="File类">File类</a></p>
<p>实现对文件的访问。</p>
<pre>DataStream
  |
  +-- File</pre>
<p>package com.ms.wfc.io</p>
<p>public class File</p>
<p>extends DataStream</p>
<p class="title_2">说明</p>
<p>提供文件的IDataStream界面，也提供了文件目录和面向路径的函数和方法。</p>
<p>可以使用类中的构造器创建一个File实例。或者使用create, open,openRead, openStandardError, openStandardInput或openStandardOutput静态方法。</p>
<p>有关文件所支持的输入/输出方法的完整列表，请参阅IByteStream和IDataStream界面。</p>
<p>File实现了对底层文件的直接访问，而不用缓冲区。如果你要进行大量的读写操作，可以在File对象前面放置一个BufferedStream对象来提高性能。</p>
<p>在对文件进行操作的过程中，如果操作系统产生错误，就使用WinIOException类汇报，提供了底层操作系统错误代码。</p>
<p class="title_2">构造器</p>
<p>File. File</p>
<p>给定新的或现有的文件，创建一个File对象。</p>
<p class="title_2">语法</p>
<p>public File ( String path, int mode, int access , int share )</p>
<p>pubic File ( int handle )</p>
<p>pubilc File ( int handle , boolean owned )</p>
<p class="title_2">参数</p>
<p>path</p>
<p>创建或打开文件的路径。</p>
<p>mode</p>
<p>打开文件的方法。可以是FileMode枚举类中的常量。</p>
<p>access</p>
<p>对文件的访问。可以是FileAccess枚举类中的常量。</p>
<p>share</p>
<p>文件打开时所支持的文件共享访问方式。可以是FileShare枚举类的常量。</p>
<p>handle</p>
<p>现有文件句柄。</p>
<p>owned</p>
<p>指明File对象是否拥有句柄。</p>
<p>异常</p>
<p>如果产生错误就产生WinIOException异常消息。</p>
<p class="title_2">说明</p>
<p>owned参数指明File对象是否拥有指定的句柄。当调用close方法或在垃圾回收过程中释放File对象时，文件没有拥有的句柄是不会自动关闭的。</p>
<p>所指明的handler参数是由外部管理的，当调用close方法或在垃圾回收过程中释放File对象时，文件没有拥有的句柄是不会自动关闭的。</p>
<p>根据指定的access, mode和share参数创建或打开目标文件。该文件一直是打开的，除非调用了close方法或者在垃圾回收过程中释放File对象时。在调用了close方法之后，对该文件的任何操作都将导致产生异常。</p>
<p>请参阅：close, create, open, openRead, openStandardError,openStandardInput, openStandardOutput</p>
<p class="title_2">方法</p>
<p>File.ChangeExtension</p>
<p>改变文件路径的扩展名。</p>
<p class="title_2">语法</p>
<p>final static String changeExtension ( String path, String extension )</p>
<p class="title_2">参数</p>
<p>path</p>
<p>要改变文件扩展名的路径。</p>
<p>extension</p>
<p>新的文件扩展名(前面有一个逗号)或者。</p>
<p>null</p>
<p>将删除扩展名。</p>
<p class="title_2">返回值</p>
<p>返回新文件扩展名的路径。</p>
<p class="title_2">说明</p>
<p>该方法返回与path参数相同的根目录、目录和基本名部分的文件路径，但文件扩展名改变为指定的扩展名。如果path参数是null,该函数就返回null。如果path参数不包含文件扩展名，新的扩展名就追加到路径的后面。如果extension参数是null，将删除path参数中的现有扩展名。</p>
<p>请参阅：getExtension, hasExtension</p>
<p>File.close</p>
<p>关闭该文件。</p>
<p class="title_2">语法</p>
<p>public void close ()</p>
<p class="title_2">说明</p>
<p>除非从现有的文件句柄创建了File对象，否则，底层文件句柄要使用Windows API函数CloseHandle来关闭。一旦关闭了句柄，再对文件进行操作就将产生错误。将导致产生IOException。要重新打开一个文件，就创建一个新的File对象。</p>
<p>覆盖：DataStream.close</p>
<p>请参阅：IByteStream.closeFile.combine将两个文件路径组合起来。</p>
<p class="title_2">语法</p>
<p>public static String combine ( String path1, String path2)</p>
<p class="title_2">参数</p>
<p>path1</p>
<p>第一个路径。</p>
<p>path2</p>
<p>第二个路径。</p>
<p class="title_2">返回值</p>
<p>返回组合的路径。</p>
<p class="title_2">说明</p>
<p>如果path2不包括根目录（例如，path1不是以反斜线或驱动器符开头），结果就是两个路径连接起来，如果需要的话之间就加上反斜线符。如果path2包括根目录，结果就是path2。如果path1或path2是null，结果就是非空字符串。如果path1和path2都是null，结果就是null。</p>
<p>File.copy</p>
<p>将现有文件拷贝到新文件中。</p>
<p class="title_2">语法</p>
<p>public static void copy ( String sourceFileName, StringdestFileName )</p>
<p class="title_2">参数</p>
<p>sourceFileName</p>
<p>要拷贝的文件名字。</p>
<p>destFileName</p>
<p>目标文件的名字。</p>
<p>异常</p>
<p>如果产生错误或目标文件已经存在，就产生WinIOException异常消息。</p>
<p class="title_2">说明</p>
<p>使用copyOver方法将允许覆盖已经有的文件。</p>
<p>File.copyOver</p>
<p>将现有的文件拷贝到新的或现有的文件中。</p>
<p class="title_2">语法</p>
<p>public static void copyOver ( String sourceFileName, StringdestFileName )</p>
<p class="title_2">参数</p>
<p>sourceFileName</p>
<p>要拷贝的文件名。</p>
<p>destFileName</p>
<p>目标文件名。</p>
<p>异常</p>
<p>如果出现错误，就产生WinIOException异常消息。</p>
<p class="title_2">说明</p>
<p>与copy方法不同的是，如果目标文件存在，该方法不会产生异常。</p>
<p>File.create</p>
<p>创建一个新文件。</p>
<p class="title_2">语法</p>
<p>public static File create( 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>如果指定的文件名已经存在，文件内容就截断为0。所返回的File对象也包含对新文件的读取操作。</p>
<p>请参阅：close</p>
<p>File.createDirectories</p>
<p>创建所指定路径下的所有目录。</p>
<p class="title_2">语法</p>
<p>pubilc static void createDirectories ( String path )</p>
<p class="title_2">参数</p>
<p>path要创建的目录路径。异常如果出现错误，就产生WinIOException异常消息。</p>
<p class="title_2">说明</p>
<p>与createDirectory方法不同的是，该方法将根据需要创建多个目录以确保所指定的路径是有效的。如果某些或全部的路径已经存在也不是错误。path参数指定的是目录路径，而不是文件路径。要确保文件路径中的所有目录都已经创建，可以使用构造器File.createDirectories( File.getDirectory(filePath))。</p>
<p>File.createDirectory</p>
<p>创建一个新的目录。</p>
<p class="title_2">语法</p>
<p>pubilc static void createDirectory ( String path )</p>
<p class="title_2">参数</p>
<p>path</p>
<p>要创建的目录路径。</p>
<p>异常</p>
<p>如果出现错误，就产生WinIOException异常消息。</p>
<p class="title_2">说明</p>
<p>除了最后的部分，特定的路径必须是指向现有的目录。路径最后的部分指明要创建的新目录名。如果该文件或目录名已经存在，就出现错误。</p>
<p>请参阅：createDirectories, removeDirectory</p>
<p>File.delete</p>
<p>删除一个文件。</p>
<p class="title_2">语法</p>
<p>public static void delete( String path )</p>
<p class="title_2">参数</p>
<p>path</p>
<p>要删除的文件路径。</p>
<p>异常</p>
<p>如果出现错误，就产生WinIOException异常消息。</p>
<p class="title_2">说明</p>
<p>路径所指定的文件被删除。如果指定的文件不存在，就产生错误。</p>
<p>File.exists</p>
<p>确定文件是否存在。</p>
<p class="title_2">语法</p>
<p>public static boolean exists( String path )</p>
<p class="title_2">参数</p>
<p>path</p>
<p>要测试文件的路径。</p>
<p class="title_2">返回值</p>
<p>如果路径所指定的文件存在，就返回true；否则，就返回false。</p>
<p>File.finalize</p>
<p>整理File对象，确保调用了close方法。</p>
<p class="title_2">语法</p>
<p>protected void finalize() throws Throwable</p>
<p>File.flush</p>
<p>清除文件的缓冲区，导致缓冲的数据都写入文件。</p>
<p class="title_2">语法</p>
<p>public void flush()</p>
<p>异常</p>
<p>如果出现错误或者文件已经被关闭就产生WinIOException异常消息。</p>
<p class="title_2">说明</p>
<p>该方法调用Windows API函数FlushFileBuffers。</p>
<p>覆盖：DataStream.flush</p>
<p>请参阅：com.ms.wfc.io.IByteStream.flush</p>
<p>File.getAttributes</p>
<p>检取指定文件或目录的属性。</p>
<p class="title_2">语法</p>
<p>public static int getAttributes ( String path )</p>
<p class="title_2">参数</p>
<p>path文件或目录的路径。</p>
<p class="title_2">返回值</p>
<p>返回文件或目录的属性。</p>
<p class="title_2">异常</p>
<p>如果出现错误，就产生WinIOException异常消息。</p>
<p class="title_2">说明。</p>
<p class="title_2">返回值</p>
<p>可以是下面标记的组合：ARCHIVE，COMPRESSED，DIRECTORY，HIDDEN，OFFLINE，READONLY，SYSTEM和TEMPORARY FileAttribute。</p>
<p>请参阅：setAttributes</p>
<p>File.getCurrentDirectory</p>
<p>检取当前的目录。</p>
<p class="title_2">语法</p>
<p>public static String getCurrentDirectory()。</p>
<p class="title_2">返回值</p>
<p>返回当前目录的决定路径。异常如果出现错误，就产生WinIOException异常消息。</p>
<p>请参阅：setCurrentDirectory</p>
<p>File.getDirectory</p>
<p>检取文件路径中的目录路径。</p>
<p class="title_2">语法</p>
<p>public static String getDirectory ( String path )</p>
<p class="title_2">参数</p>
<p>path</p>
<p>文件或目录的路径。</p>
<p class="title_2">返回值</p>
<p>返回指定路径中的目录路径。如果指定的路径包含根目录，就返回null。</p>
<p class="title_2">说明</p>
<p>该方法有效地删除了指定文件路径中最后的部分；例如，其返回文件路径中直到最后一个反斜线符的部分，但不包括最后的反斜线符。如果文件路径是null或文件路径包括根目录如反斜线,C:或\\server\share，就返回null。</p>
<p>请参阅：getExtension, getName, getRoot, isRooted</p>
<p>File.getExtension</p>
<p>检取指定路径的扩展名。</p>
<p class="title_2">语法</p>
<p>public static String getExtension ( String path )</p>
<p class="title_2">参数</p>
<p>path</p>
<p>文件或目录的路径。</p>
<p class="title_2">返回值</p>
<p>返回指定路径的扩展名，如果指定的路径是null或者不包括扩展名，就返回null。</p>
<p>请参阅：changeExtension , getDirectory, getName, getRoot,hasExtension</p>
<p>File.getFiles</p>
<p>检取与指定搜索路径匹配的文件名。</p>
<p class="title_2">语法</p>
<p>public static String[] getFiles ( String path )</p>
<p class="title_2">参数</p>
<p>path搜索的路径。</p>
<p class="title_2">返回值</p>
<p>返回与搜索路径匹配的文件名字符串矩阵。</p>
<p>File.getFullPath</p>
<p>将指定的路径扩展为全路径。</p>
<p class="title_2">语法</p>
<p>public static String getFullPath ( String path )</p>
<p class="title_2">参数</p>
<p>path</p>
<p>要扩展为全路径的路径。</p>
<p class="title_2">返回值全路径名。</p>
<p>异常</p>
<p>如果出现错误，就产生WinIOException异常消息。</p>
<p class="title_2">说明</p>
<p>最后的结果包括驱动器字符、冒号和根目录的相对路径。该方法并不验证结果是否有效以及其是否指向驱动器上的现有的文件或目录。</p>
<p>File.getHandle</p>