javax.imageio.stream
類別 FileImageInputStream

java.lang.Object
  javax.imageio.stream.ImageInputStreamImpl
      javax.imageio.stream.FileImageInputStream

所有已實作的介面：

DataInput, ImageInputStream

public class FileImageInputStream
extends ImageInputStreamImpl

從 File 或 RandomAccessFile 中獲取輸入的 ImageInputStream 的實作。假定檔案內容在物件的生存期內是穩定的。

欄位摘要

從類別 javax.imageio.stream.ImageInputStreamImpl 繼承的欄位

bitOffset, byteOrder, flushedPos, streamPos

建構子摘要

FileImageInputStream(File f)
建構一個將從給定 File 進行讀取的 FileImageInputStream。

FileImageInputStream(RandomAccessFile raf)
建構一個將從給定 RandomAccessFile 進行讀取的 FileImageInputStream。

方法摘要

void	close() 關閉串流。
protected void	finalize() 在垃圾回收前結束此物件。
long	length() 返回底層檔案的長度，如果其為未知，則返回 -1。
int	read() 從串流中讀取單個位元組，並以 int（0 到 255 之間）形式返回該位元組。
int	read(byte[] b, int off, int len) 從串流中讀取至多 len 個位元組，並將其存儲到 b 中（從 off 索引處開始）。
void	seek(long pos) 將當前串流位置設置為所需的位置。

從類別 javax.imageio.stream.ImageInputStreamImpl 繼承的方法

checkClosed, flush, flushBefore, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, isCached, isCachedFile, isCachedMemory, mark, read, readBit, readBits, readBoolean, readByte, readBytes, readChar, readDouble, readFloat, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readInt, readLine, readLong, readShort, readUnsignedByte, readUnsignedInt, readUnsignedShort, readUTF, reset, setBitOffset, setByteOrder, skipBytes, skipBytes

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

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

建構子詳細資訊

FileImageInputStream

public FileImageInputStream(File f)
                     throws FileNotFoundException,
                            IOException

建構一個將從給定 File 進行讀取的 FileImageInputStream。

在建構此物件和最後一次調用 read 方法之間的時間內，一定不能更改檔案內容。

參數：

f - 要從其進行讀取的 File。

拋出：

IllegalArgumentException - 如果 f 為 null。

SecurityException - 如果存在安全管理器，且不允許對檔案進行讀取存取。

FileNotFoundException - 如果 f 是目錄，或者由於任何其他原因不能打開以進行讀取。

IOException - 如果發生 I/O 錯誤。

FileImageInputStream

public FileImageInputStream(RandomAccessFile raf)

建構一個將從給定 RandomAccessFile 進行讀取的 FileImageInputStream。

在建構此物件和最後一次調用 read 方法之間的時間內，一定不能更改檔案內容。

參數：

raf - 要從其進行讀取的 RandomAccessFile。

拋出：

IllegalArgumentException - 如果 raf 為 null。

方法詳細資訊

read

public int read()
         throws IOException

從類別 ImageInputStreamImpl 複製的描述

從串流中讀取單個位元組，並以 int（0 到 255 之間）形式返回該位元組。 如果到達 EOF，則返回 -1。

子類別必須提供此方法的實作。子類別實作在退出前應該更新串流位置。

在發生讀取前，串流中的位偏移量必須被重置為 0。

指定者：

介面 ImageInputStream 中的 read

指定者：

類別 ImageInputStreamImpl 中的 read

返回：

串流中下一個位元組的值；如果到達 EOF，則返回 -1。

拋出：

IOException - 如果串流已經被關閉。

read

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

從類別 ImageInputStreamImpl 複製的描述

從串流中讀取至多 len 個位元組，並將其存儲到 b 中（從 off 索引處開始）。如果由於到達串流末尾而沒有讀取任何位元組，則返回 -1。

在發生讀取前，串流中的位偏移量必須被重置為 0。

子類別必須提供此方法的實作。子類別實作在退出前應該更新串流位置。

指定者：

介面 ImageInputStream 中的 read

指定者：

類別 ImageInputStreamImpl 中的 read

參數：

b - 用來接收寫入的位元組陣列。

off - b 中要寫入的起始位置。

len - 要讀取的最大位元組數。

返回：

實際讀取的位元組數；或者 -1，指示 EOF。

拋出：

IOException - 如果發生 I/O 錯誤。

length

public long length()

返回底層檔案的長度，如果其為未知，則返回 -1。

指定者：

介面 ImageInputStream 中的 length

覆寫：

類別 ImageInputStreamImpl 中的 length

返回：

以 long 形式返回檔案的長度，或者返回 -1。

seek

public void seek(long pos)
          throws IOException

從介面 ImageInputStream 複製的描述

將當前串流位置設置為所需的位置。下一次讀取將在此位置上進行。位偏移量被設置為 0。

如果 pos 小於刷新位置（由 getflushedPosition 返回），那麼將拋出 IndexOutOfBoundsException。

尋找檔案結束標記的後面是合法的，只有在該處執行讀取時才拋出 EOFException。

指定者：

介面 ImageInputStream 中的 seek

覆寫：

類別 ImageInputStreamImpl 中的 seek

參數：

pos - 一個 long，它包含所需的檔案指針位置。

拋出：

IOException - 如果發生任何 I/O 錯誤。

close

public void close()
           throws IOException

從介面 ImageInputStream 複製的描述

關閉串流。試圖存取已經關閉的串流將導致 IOException 或錯誤行為。調用此方法可允許實作此介面的類別釋放與串流關聯的資源，如記憶體、磁碟空間或檔案描述符。

指定者：

介面 ImageInputStream 中的 close

覆寫：

類別 ImageInputStreamImpl 中的 close

拋出：

IOException - 如果發生 I/O 錯誤。

finalize

protected void finalize()
                 throws Throwable

在垃圾回收前結束此物件。調用 close 方法來關閉所有開啟的輸入源。不應該從應用程序程式碼調用此方法。

覆寫：

類別 ImageInputStreamImpl 中的 finalize

拋出：

Throwable - 如果在父級類別終止過程中發生錯誤。