軟體套件 java.nio

定義作為資料容器的緩衝區，並提供其他 NIO 套件的概觀。

請參見：
描述

類別摘要

Buffer	一個用於特定基本型別資料的容器。
ByteBuffer	位元組緩衝區。
ByteOrder	位元組順序的型別安全列舉。
CharBuffer	字元緩衝區。
DoubleBuffer	double 緩衝區。
FloatBuffer	float 緩衝區。
IntBuffer	int 緩衝區。
LongBuffer	long 緩衝區。
MappedByteBuffer	直接位元組緩衝區，其內容是檔案的記憶體映射區域。
ShortBuffer	short 緩衝區。

異常摘要

BufferOverflowException	當相關 put 操作達到目標緩衝區限制時，拋出此未經檢查的異常。
BufferUnderflowException	當相關 get 操作達到源緩衝區限制時，拋出此未經檢查的異常。
InvalidMarkException	當試圖重置一個尚未定義其標記的緩衝區時，拋出此未檢查的異常。
ReadOnlyBufferException	當在只讀緩衝區上調用內容可變（content-mutation）的方法（例如 put 或 compact 方法）時，拋出此未經檢查的異常。

軟體套件 java.nio 的描述

定義作為資料容器的緩衝區，並提供其他 NIO 套件的概觀。

NIO API 的集中抽象為：

• 緩衝區，它們是資料容器；

• 字元集 及其相關解碼器 和編碼器，
  它們在位元組和 Unicode 字元之間進行轉換；

• 各種型別的通道，它們表示到能夠執行 IO 操作的
  實體的連接；以及選擇器 和選擇鍵，它們與
  可選擇通道 一起定義了多路的、無阻塞的
  I/O 設施。

java.nio 套件定義了緩衝區類別，這些類別用於所有 NIO API。java.nio.charset 套件中定義了字元集 API，java.nio.channels 套件中定義了通道和選擇器 API。每個子包都具有自己的服務提供者介面 (SPI) 子包，SPI 子套件的內容可用於擴展平臺的預設實作或建構替代實作。

緩衝區	描述
Buffer	位置，界限和容量； 清除，反轉，重繞和標記/重置
ByteBuffer	Get/put，壓縮，查看；分派，包裹
MappedByteBuffer	映射到檔案的位元組緩衝區
CharBuffer	Get/put，壓縮；分派，包裹
DoubleBuffer	' '
FloatBuffer	' '
IntBuffer	' '
LongBuffer	' '
ShortBuffer	' '
ByteOrder	位元組順序的型別安全的列舉

緩衝區 是一個固定資料量的指定基本型別的資料容器。除內容之外，緩衝區還具有位置 和界限，其中位置是要讀寫的下一個元素的索引，界限是第一個應該讀寫的元素的索引。基本 Buffer 類別定義了這些屬性以及清除、反轉 和重繞 方法，用以標記 當前位置，以及將當前位置重置 為前一個標記處。

每個非布林基本型別都有一個緩衝區類別。每個類別定義了一系列用於將資料移出或移入緩衝區的 get 和 put 方法，用於壓縮、複製 和切割 緩衝區的方法，以及用於分派 新緩衝區和將現有陣列包裹 到緩衝區中的靜態方法。

因為位元組緩衝區可以用作 I/O 操作的源緩衝區和目標緩衝區，所以可以對它們加以區分。它們還支持其他緩衝區類別所沒有的幾個特性：

• 可以將位元組緩衝區分派為一個直接 緩衝區，在這種情況下，Java 虛擬機器將最大限度地直接在緩衝區上執行本機 I/O 操作。

• 可以通過 mapping 將檔案區域直接包裹到記憶體中來創建位元組緩衝區，在這種情況下，可以使用 MappedByteBuffer 類別中定義的幾個其他檔案相關的操作。

• 位元組緩衝區提供了對其內容的存取（其內容作為任何非布林基本型別的異類別或同類別二進制資料序列），存取要麼是以 big-endian 位元組順序進行，要麼是以 little-endian 位元組順序進行。

除非另有說明，否則向此套件的任何類別或介面中的建構子或方法傳遞 null 變數，都會拋出 NullPointerException。

從以下版本開始：

1.4