IO-FileOutputStream

java.io

類 FileOutputStream

java.lang.Object

┗java.io.OutputStream

  ┗java.io.FileOutputStream

全部已實現的接口：

Closeable, Flushable

 

public class FileOutputStream extends OutputStream

文件輸出流是用於將數據寫入 File 或 FileDescriptor 的輸出流。文件是否可用或可否能夠被建立取決於基礎平臺。特別是某些平臺一次只容許一個 FileOutputStream（或其餘文件寫入對象）打開文件進行寫入。在這種狀況下，若是所涉及的文件已經打開，則此類中的構造方法將失敗。

 

FileOutputStream 用於寫入諸如圖像數據之類的原始字節的流。要寫入字符流，請考慮使用 FileWriter。

 

構造方法摘要

FileOutputStream(File file)

          建立一個向指定 File 對象表示的文件中寫入數據的文件輸出流。

FileOutputStream(File file, boolean append)

          建立一個向指定 File 對象表示的文件中寫入數據的文件輸出流。

FileOutputStream(String name)

          建立一個向具備指定名稱的文件中寫入數據的輸出文件流。

FileOutputStream(String name, boolean append)

          建立一個向具備指定 name 的文件中寫入數據的輸出文件流。

FileOutputStream(FileDescriptor fdObj)

          建立一個向指定文件描述符處寫入數據的輸出文件流，該文件描述符表示一個到文件系統中的某個實際文件的現有鏈接。

 

方法摘要

void close()

          關閉此文件輸出流並釋放與此流有關的全部系統資源。

protected  void finalize()

          清理到文件的鏈接，並確保在再也不引用此文件輸出流時調用此流的 close 方法。

FileChannel getChannel()

          返回與此文件輸出流有關的惟一 FileChannel 對象。

FileDescriptor getFD()

          返回與此流有關的文件描述符。

void write(byte[] b)

          將 b.length 個字節從指定 byte 數組寫入此文件輸出流中。

void write(byte[] b, int off, int len)

          將指定 byte 數組中從偏移量 off 開始的 len 個字節寫入此文件輸出流。

void write(int b)

          將指定字節寫入此文件輸出流。

 

從類 java.io.OutputStream 繼承的方法

flush

 

從類 java.lang.Object 繼承的方法

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

構造方法詳細信息

 

FileOutputStream

public FileOutputStream(String name) throws FileNotFoundException

建立一個向具備指定名稱的文件中寫入數據的輸出文件流。

建立一個新 FileDescriptor 對象來表示此文件鏈接。

首先，若是有安全管理器，則用 name 做爲參數調用 checkWrite 方法。

若是該文件存在，但它是一個目錄，而不是一個常規文件；或者該文件不存在，但沒法建立它；抑或由於其餘某些緣由而沒法打開它，則拋出 FileNotFoundException。

參數：

name - 與系統有關的文件名

拋出：

FileNotFoundException - 若是文件存在，但它是一個目錄，而不是一個常規文件；或者該文件不存在，但沒法建立它；抑或由於其餘某些緣由而沒法打開它

SecurityException - 若是存在安全管理器，且其 checkWrite 方法拒絕對文件進行寫入訪問。

 

FileOutputStream

public FileOutputStream(String name,boolean append) throws FileNotFoundException

建立一個向具備指定 name 的文件中寫入數據的輸出文件流。

若是第二個參數爲 true，則將字節寫入文件末尾處，而不是寫入文件開始處。

建立一個新 FileDescriptor 對象來表示此文件鏈接。

首先，若是有安全管理器，則用 name 做爲參數調用 checkWrite 方法。

若是該文件存在，但它是一個目錄，而不是一個常規文件；或者該文件不存在，但沒法建立它；抑或由於其餘某些緣由而沒法打開它，則拋出 FileNotFoundException。

參數：

name - 與系統有關的文件名

append - 若是爲 true，則將字節寫入文件末尾處，而不是寫入文件開始處

拋出：

FileNotFoundException - 若是該文件存在，但它是一個目錄，而不是一個常規文件；或者該文件不存在，但沒法建立它；抑或由於其餘某些緣由而沒法打開它。

SecurityException - 若是存在安全管理器，且其 checkWrite 方法拒絕對文件進行寫入訪問。

 

FileOutputStream

public FileOutputStream(File file) throws FileNotFoundException

建立一個向指定 File 對象表示的文件中寫入數據的文件輸出流。建立一個新 FileDescriptor 對象來表示此文件鏈接。

首先，若是有安全管理器，則用 file 參數表示的路徑做爲參數來調用 checkWrite 方法。

若是該文件存在，但它是一個目錄，而不是一個常規文件；或者該文件不存在，但沒法建立它；抑或由於其餘某些緣由而沒法打開，則拋出 FileNotFoundException。 

參數：

file - 爲了進行寫入而打開的文件。

拋出：

FileNotFoundException - 若是該文件存在，但它是一個目錄，而不是一個常規文件；或者該文件不存在，但沒法建立它；抑或由於其餘某些緣由而沒法打開。

SecurityException - 若是存在安全管理器，且其 checkWrite 方法拒絕對文件進行寫入訪問。

 

FileOutputStream

public FileOutputStream(File file, boolean append) throws FileNotFoundException

建立一個向指定 File 對象表示的文件中寫入數據的文件輸出流。若是第二個參數爲 true，則將字節寫入文件末尾處，而不是寫入文件開始處。建立一個新 FileDescriptor 對象來表示此文件鏈接。

首先，若是有安全管理器，則用 file 參數表示的路徑做爲參數來調用 checkWrite 方法。

若是該文件存在，但它是一個目錄，而不是一個常規文件；或者該文件不存在，但沒法建立它；抑或由於其餘某些緣由而沒法打開它，則拋出 FileNotFoundException。

參數：

file - 爲了進行寫入而打開的文件。

append - 若是爲 true，則將字節寫入文件末尾處，而不是寫入文件開始處

拋出：

FileNotFoundException - 若是該文件存在，但它是一個目錄，而不是一個常規文件；或者該文件不存在，但沒法建立它；抑或由於其餘某些緣由而沒法打開它

SecurityException - 若是存在安全管理器，且其 checkWrite 方法拒絕對文件進行寫入訪問。

 

FileOutputStream

public FileOutputStream(FileDescriptor fdObj)

建立一個向指定文件描述符處寫入數據的輸出文件流，該文件描述符表示一個到文件系統中的某個實際文件的現有鏈接。

首先，若是有安全管理器，則用文件描述符 fdObj 參數做爲參數來調用 checkRead 方法。

參數：

fdObj - 爲進行寫入而打開的文件描述符

拋出：

SecurityException - 若是存在安全管理器，且其 checkWrite 方法拒絕對文件描述符進行寫入訪問。

 

方法詳細信息

 

write

public void write(int b) throws IOException

將指定字節寫入此文件輸出流。實現 OutputStream 的 write 方法。

指定者：

類 OutputStream 中的 write

參數：

b - 要寫入的字節。

拋出：

IOException - 若是發生 I/O 錯誤。

 

write

public void write(byte[] b) throws IOException

將 b.length 個字節從指定 byte 數組寫入此文件輸出流中。

 

覆蓋：

類 OutputStream 中的 write

參數：

b - 數據。

拋出：

IOException - 若是發生 I/O 錯誤。

 

write

public void write(byte[] b, int off, int len) throws IOException

將指定 byte 數組中從偏移量 off 開始的 len 個字節寫入此文件輸出流。

 

覆蓋：

類 OutputStream 中的 write

參數：

b - 數據。

off - 數據中的起始偏移量。

len - 要寫入的字節數。

拋出：

IOException - 若是發生 I/O 錯誤。

 

close

public void close() throws IOException

關閉此文件輸出流並釋放與此流有關的全部系統資源。此文件輸出流不能再用於寫入字節。

若是此流有一個與之關聯的通道，則關閉該通道。

 

 

指定者：

接口 Closeable 中的 close

覆蓋：

類 OutputStream 中的 close

拋出：

IOException - 若是發生 I/O 錯誤。

 

getFD

public final FileDescriptor getFD() throws IOException

返回與此流有關的文件描述符。

 

返回：

表示到文件系統中的某個文件的鏈接的 FileDescriptor 對象，該文件系統正被此 FileOutputStream 對象使用。

拋出：

IOException - 若是發生 I/O 錯誤。

 

getChannel

public FileChannel getChannel()

返回與此文件輸出流有關的惟一 FileChannel 對象。

 

所返回通道的初始 java.nio.channels.FileChannel#position()position 將等於到目前爲止從文件中讀取的字節數，除非此流處於掛起模式，在這種狀況下，它將等於文件的大小。將字節寫入此流中會使通道的位置相應地增長。顯式地或經過寫入來更改通道的位置會更改此流的文件位置。

 

 

返回：

與此文件輸出流有關的文件通道

 

finalize

protected void finalize() throws IOException

清理到文件的鏈接，並確保在再也不引用此文件輸出流時調用此流的 close 方法。

 

覆蓋：

類 Object 中的 finalize

拋出：

IOException - 若是發生 I/O 錯誤。