作者：
http://blog.csdn.net/shuidisha/archive/2006/03/19/629397.aspx在JDK 1.4以前，Java的IO操作集中在java.io這個(gè)包中，是基于流的阻塞（blocking）API。對于大多數應用來(lái)說(shuō)，這樣的API使用很方便，然而，一些對性能要求較高的應用，尤其是服務(wù)端應用，往往需要一個(gè)更為有效的方式來(lái)處理IO。從JDK 1.4起，NIO API作為一個(gè)基于緩沖區，并能提供非阻塞(non-blocking)IO操作的API被引入。本文對其進(jìn)行深入的介紹。
NIO API主要集中在java.nio和它的subpackages中：
java.nio
定義了Buffer及其數據類(lèi)型相關(guān)的子類(lèi)。其中被java.nio.channels中的類(lèi)用來(lái)進(jìn)行IO操作的ByteBuffer的作用非常重要。
java.nio.channels
定義了一系列處理IO的Channel接口以及這些接口在文件系統和網(wǎng)絡(luò )通訊上的實(shí)現。通過(guò)Selector這個(gè)類(lèi)，還提供了進(jìn)行非阻塞IO操作的辦法。這個(gè)包可以說(shuō)是NIO API的核心。
java.nio.channels.spi
定義了可用來(lái)實(shí)現channel和selector API的抽象類(lèi)。
java.nio.charset
定義了處理字符編碼和解碼的類(lèi)。
java.nio.charset.spi
定義了可用來(lái)實(shí)現charset API的抽象類(lèi)。
java.nio.channels.spi和java.nio.charset.spi這兩個(gè)包主要被用來(lái)對現有NIO API進(jìn)行擴展，在實(shí)際的使用中，我們一般只和另外的3個(gè)包打交道。下面將對這3個(gè)包一一介紹。
Package java.nio
這個(gè)包主要定義了Buffer及其子類(lèi)。Buffer定義了一個(gè)線(xiàn)性存放primitive type數據的容器接口。對于除boolean以外的其他primitive type，都有一個(gè)相應的Buffer子類(lèi)，ByteBuffer是其中最重要的一個(gè)子類(lèi)。
下面這張UML類(lèi)圖描述了java.nio中的類(lèi)的關(guān)系：
Buffer
定義了一個(gè)可以線(xiàn)性存放primitive type數據的容器接口。Buffer主要包含了與類(lèi)型（byte, char…）無(wú)關(guān)的功能。值得注意的是Buffer及其子類(lèi)都不是線(xiàn)程安全的。
每個(gè)Buffer都有以下的屬性：
capacity
這個(gè)Buffer最多能放多少數據。capacity一般在buffer被創(chuàng )建的時(shí)候指定。
limit
在Buffer上進(jìn)行的讀寫(xiě)操作都不能越過(guò)這個(gè)下標。當寫(xiě)數據到buffer中時(shí)，limit一般和capacity相等，當讀數據時(shí)，limit代表buffer中有效數據的長(cháng)度。
position
讀/寫(xiě)操作的當前下標。當使用buffer的相對位置進(jìn)行讀/寫(xiě)操作時(shí)，讀/寫(xiě)會(huì )從這個(gè)下標進(jìn)行，并在操作完成后，buffer會(huì )更新下標的值。
mark
一個(gè)臨時(shí)存放的位置下標。調用mark()會(huì )將mark設為當前的position的值，以后調用reset()會(huì )將position屬性設置為mark的值。mark的值總是小于等于position的值，如果將position的值設的比mark小，當前的mark值會(huì )被拋棄掉。
這些屬性總是滿(mǎn)足以下條件：
0 <= mark <= position <= limit <= capacity
limit和position的值除了通過(guò)limit()和position()函數來(lái)設置，也可以通過(guò)下面這些函數來(lái)改變：
Buffer clear()
把position設為0，把limit設為capacity，一般在把數據寫(xiě)入Buffer前調用。
Buffer flip()
把limit設為當前position，把position設為0，一般在從Buffer讀出數據前調用。
Buffer rewind()
把position設為0，limit不變，一般在把數據重寫(xiě)入Buffer前調用。
Buffer對象有可能是只讀的，這時(shí)，任何對該對象的寫(xiě)操作都會(huì )觸發(fā)一個(gè)ReadOnlyBufferException。isReadOnly()方法可以用來(lái)判斷一個(gè)Buffer是否只讀。
ByteBuffer
在Buffer的子類(lèi)中，ByteBuffer是一個(gè)地位較為特殊的類(lèi)，因為在java.io.channels中定義的各種channel的IO操作基本上都是圍繞ByteBuffer展開(kāi)的。
ByteBuffer定義了4個(gè)static方法來(lái)做創(chuàng )建工作：
ByteBuffer allocate(int capacity)
創(chuàng )建一個(gè)指定capacity的ByteBuffer。
ByteBuffer allocateDirect(int capacity)
創(chuàng )建一個(gè)direct的ByteBuffer，這樣的ByteBuffer在參與IO操作時(shí)性能會(huì )更好（很有可能是在底層的實(shí)現使用了DMA技術(shù)），相應的，創(chuàng )建和回收direct的ByteBuffer的代價(jià)也會(huì )高一些。isDirect()方法可以檢查一個(gè)buffer是否是direct的。
ByteBuffer wrap(byte [] array)
ByteBuffer wrap(byte [] array, int offset, int length)
把一個(gè)byte數組或byte數組的一部分包裝成ByteBuffer。
ByteBuffer定義了一系列g(shù)et和put操作來(lái)從中讀寫(xiě)byte數據，如下面幾個(gè)：
byte get()
ByteBuffer get(byte [] dst)
byte get(int index)
ByteBuffer put(byte b)
ByteBuffer put(byte [] src)
ByteBuffer put(int index, byte b)
這些操作可分為絕對定位和相對定為兩種，相對定位的讀寫(xiě)操作依靠position來(lái)定位Buffer中的位置，并在操作完成后會(huì )更新position的值。
在其它類(lèi)型的buffer中，也定義了相同的函數來(lái)讀寫(xiě)數據，唯一不同的就是一些參數和返回值的類(lèi)型。
除了讀寫(xiě)byte類(lèi)型數據的函數，ByteBuffer的一個(gè)特別之處是它還定義了讀寫(xiě)其它primitive數據的方法，如：
int getInt()
從ByteBuffer中讀出一個(gè)int值。
ByteBuffer putInt(int value)
寫(xiě)入一個(gè)int值到ByteBuffer中。
讀寫(xiě)其它類(lèi)型的數據牽涉到字節序問(wèn)題，ByteBuffer會(huì )按其字節序（大字節序或小字節序）寫(xiě)入或讀出一個(gè)其它類(lèi)型的數據（int,long…）。字節序可以用order方法來(lái)取得和設置：
ByteOrder order()
返回ByteBuffer的字節序。
ByteBuffer order(ByteOrder bo)
設置ByteBuffer的字節序。
ByteBuffer另一個(gè)特別的地方是可以在它的基礎上得到其它類(lèi)型的buffer。如：
CharBuffer asCharBuffer()
為當前的ByteBuffer創(chuàng )建一個(gè)CharBuffer的視圖。在該視圖buffer中的讀寫(xiě)操作會(huì )按照ByteBuffer的字節序作用到ByteBuffer中的數據上。
用這類(lèi)方法創(chuàng )建出來(lái)的buffer會(huì )從ByteBuffer的position位置開(kāi)始到limit位置結束，可以看作是這段數據的視圖。視圖buffer的readOnly屬性和direct屬性與ByteBuffer的一致，而且也只有通過(guò)這種方法，才可以得到其他數據類(lèi)型的direct buffer。
ByteOrder
用來(lái)表示ByteBuffer字節序的類(lèi)，可將其看成java中的enum類(lèi)型。主要定義了下面幾個(gè)static方法和屬性：
ByteOrder BIG_ENDIAN
代表大字節序的ByteOrder。
ByteOrder LITTLE_ENDIAN
代表小字節序的ByteOrder。
ByteOrder nativeOrder()
返回當前硬件平臺的字節序。
MappedByteBuffer
ByteBuffer的子類(lèi)，是文件內容在內存中的映射。這個(gè)類(lèi)的實(shí)例需要通過(guò)FileChannel的map()方法來(lái)創(chuàng )建。
接下來(lái)看看一個(gè)使用ByteBuffer的例子，這個(gè)例子從標準輸入不停地讀入字符，當讀滿(mǎn)一行后，將收集的字符寫(xiě)到標準輸出：
public static void main(String [] args)
throws IOException
{
// 創(chuàng )建一個(gè)capacity為256的ByteBuffer
ByteBuffer buf = ByteBuffer.allocate(256);
while (true) {
// 從標準輸入流讀入一個(gè)字符
int c = System.in.read();
// 當讀到輸入流結束時(shí)，退出循環(huán)
if (c == -1)
break;
// 把讀入的字符寫(xiě)入ByteBuffer中
buf.put((byte) c);
// 當讀完一行時(shí)，輸出收集的字符
if (c == ‘\n‘) {
// 調用flip()使limit變?yōu)楫斍暗膒osition的值,position變?yōu)?,
// 為接下來(lái)從ByteBuffer讀取做準備
buf.flip();
// 構建一個(gè)byte數組
byte [] content = new byte[buf.limit()];
// 從ByteBuffer中讀取數據到byte數組中
buf.get(content);
// 把byte數組的內容寫(xiě)到標準輸出
System.out.print(new String(content));
// 調用clear()使position變?yōu)?,limit變?yōu)閏apacity的值，
// 為接下來(lái)寫(xiě)入數據到ByteBuffer中做準備
buf.clear();
}
}
}
Package java.nio.channels
這個(gè)包定義了Channel的概念，Channel表現了一個(gè)可以進(jìn)行IO操作的通道（比如，通過(guò)FileChannel，我們可以對文件進(jìn)行讀寫(xiě)操作）。java.nio.channels包含了文件系統和網(wǎng)絡(luò )通訊相關(guān)的channel類(lèi)。這個(gè)包通過(guò)Selector和SelectableChannel這兩個(gè)類(lèi)，還定義了一個(gè)進(jìn)行非阻塞（non-blocking）IO操作的API，這對需要高性能IO的應用非常重要。
下面這張UML類(lèi)圖描述了java.nio.channels中interface的關(guān)系：
Channel
Channel表現了一個(gè)可以進(jìn)行IO操作的通道，該interface定義了以下方法：
boolean isOpen()
該Channel是否是打開(kāi)的。
void close()
關(guān)閉這個(gè)Channel，相關(guān)的資源會(huì )被釋放。
ReadableByteChannel
定義了一個(gè)可從中讀取byte數據的channel interface。
int read(ByteBuffer dst)
從channel中讀取byte數據并寫(xiě)到ByteBuffer中。返回讀取的byte數。
WritableByteChannel
定義了一個(gè)可向其寫(xiě)byte數據的channel interface。
int write(ByteBuffer src)
從ByteBuffer中讀取byte數據并寫(xiě)到channel中。返回寫(xiě)出的byte數。
ByteChannel
ByteChannel并沒(méi)有定義新的方法，它的作用只是把ReadableByteChannel和WritableByteChannel合并在一起。
ScatteringByteChannel
繼承了ReadableByteChannel并提供了同時(shí)往幾個(gè)ByteBuffer中寫(xiě)數據的能力。
GatheringByteChannel
繼承了WritableByteChannel并提供了同時(shí)從幾個(gè)ByteBuffer中讀數據的能力。
InterruptibleChannel
用來(lái)表現一個(gè)可以被異步關(guān)閉的Channel。這表現在兩方面：
1． 當一個(gè)InterruptibleChannel的close()方法被調用時(shí)，其它block在這個(gè)InterruptibleChannel的IO操作上的線(xiàn)程會(huì )接收到一個(gè)AsynchronousCloseException。
2． 當一個(gè)線(xiàn)程block在InterruptibleChannel的IO操作上時(shí)，另一個(gè)線(xiàn)程調用該線(xiàn)程的interrupt()方法會(huì )導致channel被關(guān)閉，該線(xiàn)程收到一個(gè)ClosedByInterruptException，同時(shí)線(xiàn)程的interrupt狀態(tài)會(huì )被設置。
接下來(lái)的這張UML類(lèi)圖描述了java.nio.channels中類(lèi)的關(guān)系：
非阻塞IO
非阻塞IO的支持可以算是NIO API中最重要的功能，非阻塞IO允許應用程序同時(shí)監控多個(gè)channel以提高性能，這一功能是通過(guò)Selector，SelectableChannel和SelectionKey這3個(gè)類(lèi)來(lái)實(shí)現的。
SelectableChannel代表了可以支持非阻塞IO操作的channel，可以將其注冊在Selector上，這種注冊的關(guān)系由SelectionKey這個(gè)類(lèi)來(lái)表現（見(jiàn)UML圖）。Selector這個(gè)類(lèi)通過(guò)select()函數，給應用程序提供了一個(gè)可以同時(shí)監控多個(gè)IO channel的方法：
應用程序通過(guò)調用select()函數，讓Selector監控注冊在其上的多個(gè)SelectableChannel，當有channel的IO操作可以進(jìn)行時(shí)，select()方法就會(huì )返回以讓?xiě)贸绦驒z查channel的狀態(tài)，并作相應的處理。
下面是JDK 1.4中非阻塞IO的一個(gè)例子，這段code使用了非阻塞IO實(shí)現了一個(gè)time server：
private static void acceptConnections(int port) throws Exception {
// 打開(kāi)一個(gè)Selector
Selector acceptSelector =
SelectorProvider.provider().openSelector();
// 創(chuàng )建一個(gè)ServerSocketChannel，這是一個(gè)SelectableChannel的子類(lèi)
ServerSocketChannel ssc = ServerSocketChannel.open();
// 將其設為non-blocking狀態(tài)，這樣才能進(jìn)行非阻塞IO操作
ssc.configureBlocking(false);
// 給ServerSocketChannel對應的socket綁定IP和端口
InetAddress lh = InetAddress.getLocalHost();
InetSocketAddress isa = new InetSocketAddress(lh, port);
ssc.socket().bind(isa);
// 將ServerSocketChannel注冊到Selector上，返回對應的SelectionKey
SelectionKey acceptKey =
ssc.register(acceptSelector, SelectionKey.OP_ACCEPT);
int keysAdded = 0;
// 用select()函數來(lái)監控注冊在Selector上的SelectableChannel
// 返回值代表了有多少channel可以進(jìn)行IO操作 (ready for IO)
while ((keysAdded = acceptSelector.select()) > 0) {
// selectedKeys()返回一個(gè)SelectionKey的集合，
// 其中每個(gè)SelectionKey代表了一個(gè)可以進(jìn)行IO操作的channel。
// 一個(gè)ServerSocketChannel可以進(jìn)行IO操作意味著(zhù)有新的TCP連接連入了
Set readyKeys = acceptSelector.selectedKeys();
Iterator i = readyKeys.iterator();
while (i.hasNext()) {
SelectionKey sk = (SelectionKey) i.next();
// 需要將處理過(guò)的key從selectedKeys這個(gè)集合中刪除
i.remove();
// 從SelectionKey得到對應的channel
ServerSocketChannel nextReady =
(ServerSocketChannel) sk.channel();
// 接受新的TCP連接
Socket s = nextReady.accept().socket();
// 把當前的時(shí)間寫(xiě)到這個(gè)新的TCP連接中
PrintWriter out =
new PrintWriter(s.getOutputStream(), true);
Date now = new Date();
out.println(now);
// 關(guān)閉連接
out.close();
}
}
}
這是個(gè)純粹用于演示的例子，因為只有一個(gè)ServerSocketChannel需要監控，所以其實(shí)并不真的需要使用到非阻塞IO。不過(guò)正因為它的簡(jiǎn)單，可以很容易地看清楚非阻塞IO是如何工作的。
SelectableChannel
這個(gè)抽象類(lèi)是所有支持非阻塞IO操作的channel（如DatagramChannel、SocketChannel）的父類(lèi)。SelectableChannel可以注冊到一個(gè)或多個(gè)Selector上以進(jìn)行非阻塞IO操作。
SelectableChannel可以是blocking和non-blocking模式（所有channel創(chuàng )建的時(shí)候都是blocking模式），只有non-blocking的SelectableChannel才可以參與非阻塞IO操作。
SelectableChannel configureBlocking(boolean block)
設置blocking模式。
boolean isBlocking()
返回blocking模式。
通過(guò)register()方法，SelectableChannel可以注冊到Selector上。
int validOps()
返回一個(gè)bit mask，表示這個(gè)channel上支持的IO操作。當前在SelectionKey中，用靜態(tài)常量定義了4種IO操作的bit值：OP_ACCEPT，OP_CONNECT，OP_READ和OP_WRITE。
SelectionKey register(Selector sel, int ops)
將當前channel注冊到一個(gè)Selector上并返回對應的SelectionKey。在這以后，通過(guò)調用Selector的select()函數就可以監控這個(gè)channel。ops這個(gè)參數是一個(gè)bit mask，代表了需要監控的IO操作。
SelectionKey register(Selector sel, int ops, Object att)
這個(gè)函數和上一個(gè)的意義一樣，多出來(lái)的att參數會(huì )作為attachment被存放在返回的SelectionKey中，這在需要存放一些session state的時(shí)候非常有用。
boolean isRegistered()
該channel是否已注冊在一個(gè)或多個(gè)Selector上。
SelectableChannel還提供了得到對應SelectionKey的方法：
SelectionKey keyFor(Selector sel)
返回該channe在Selector上的注冊關(guān)系所對應的SelectionKey。若無(wú)注冊關(guān)系，返回null。
Selector
Selector可以同時(shí)監控多個(gè)SelectableChannel的IO狀況，是非阻塞IO的核心。
Selector open()
Selector的一個(gè)靜態(tài)方法，用于創(chuàng )建實(shí)例。
在一個(gè)Selector中，有3個(gè)SelectionKey的集合：
1． key set代表了所有注冊在這個(gè)Selector上的channel，這個(gè)集合可以通過(guò)keys()方法拿到。
2． Selected-key set代表了所有通過(guò)select()方法監測到可以進(jìn)行IO操作的channel，這個(gè)集合可以通過(guò)selectedKeys()拿到。
3． Cancelled-key set代表了已經(jīng)cancel了注冊關(guān)系的channel，在下一個(gè)select()操作中，這些channel對應的SelectionKey會(huì )從key set和cancelled-key set中移走。這個(gè)集合無(wú)法直接訪(fǎng)問(wèn)。
以下是select()相關(guān)方法的說(shuō)明：
int select()
監控所有注冊的channel，當其中有注冊的IO操作可以進(jìn)行時(shí)，該函數返回，并將對應的SelectionKey加入selected-key set。
int select(long timeout)
可以設置超時(shí)的select()操作。
int selectNow()
進(jìn)行一個(gè)立即返回的select()操作。
Selector wakeup()
使一個(gè)還未返回的select()操作立刻返回。
SelectionKey
代表了Selector和SelectableChannel的注冊關(guān)系。
Selector定義了4個(gè)靜態(tài)常量來(lái)表示4種IO操作，這些常量可以進(jìn)行位操作組合成一個(gè)bit mask。
int OP_ACCEPT
有新的網(wǎng)絡(luò )連接可以accept，ServerSocketChannel支持這一非阻塞IO。
int OP_CONNECT
代表連接已經(jīng)建立（或出錯），SocketChannel支持這一非阻塞IO。
int OP_READ
int OP_WRITE
代表了讀、寫(xiě)操作。
以下是其主要方法：
Object attachment()
返回SelectionKey的attachment，attachment可以在注冊channel的時(shí)候指定。
Object attach(Object ob)
設置SelectionKey的attachment。
SelectableChannel channel()
返回該SelectionKey對應的channel。
Selector selector()
返回該SelectionKey對應的Selector。
void cancel()
cancel這個(gè)SelectionKey所對應的注冊關(guān)系。
int interestOps()
返回代表需要Selector監控的IO操作的bit mask。
SelectionKey interestOps(int ops)
設置interestOps。
int readyOps()
返回一個(gè)bit mask，代表在相應channel上可以進(jìn)行的IO操作。
ServerSocketChannel
支持非阻塞操作，對應于java.net.ServerSocket這個(gè)類(lèi)，提供了TCP協(xié)議IO接口，支持OP_ACCEPT操作。
ServerSocket socket()
返回對應的ServerSocket對象。
SocketChannel accept()
接受一個(gè)連接，返回代表這個(gè)連接的SocketChannel對象。
SocketChannel
支持非阻塞操作，對應于java.net.Socket這個(gè)類(lèi)，提供了TCP協(xié)議IO接口，支持OP_CONNECT，OP_READ和OP_WRITE操作。這個(gè)類(lèi)還實(shí)現了ByteChannel，ScatteringByteChannel和GatheringByteChannel接口。
DatagramChannel和這個(gè)類(lèi)比較相似，其對應于java.net.DatagramSocket，提供了UDP協(xié)議IO接口。
Socket socket()
返回對應的Socket對象。
boolean connect(SocketAddress remote)
boolean finishConnect()
connect()進(jìn)行一個(gè)連接操作。如果當前SocketChannel是blocking模式，這個(gè)函數會(huì )等到連接操作完成或錯誤發(fā)生才返回。如果當前SocketChannel是non-blocking模式，函數在連接能立刻被建立時(shí)返回true，否則函數返回false，應用程序需要在以后用finishConnect()方法來(lái)完成連接操作。
Pipe
包含了一個(gè)讀和一個(gè)寫(xiě)的channel(Pipe.SourceChannel和Pipe.SinkChannel)，這對channel可以用于進(jìn)程中的通訊。
FileChannel
用于對文件的讀、寫(xiě)、映射、鎖定等操作。和映射操作相關(guān)的類(lèi)有FileChannel.MapMode，和鎖定操作相關(guān)的類(lèi)有FileLock。值得注意的是FileChannel并不支持非阻塞操作。
Channels
這個(gè)類(lèi)提供了一系列static方法來(lái)支持stream類(lèi)和channel類(lèi)之間的互操作。這些方法可以將channel類(lèi)包裝為stream類(lèi)，比如，將ReadableByteChannel包裝為InputStream或Reader；也可以將stream類(lèi)包裝為channel類(lèi)，比如，將OutputStream包裝為WritableByteChannel。
Package java.nio.charset
這個(gè)包定義了Charset及相應的encoder和decoder。下面這張UML類(lèi)圖描述了這個(gè)包中類(lèi)的關(guān)系，可以將其中Charset，CharsetDecoder和CharsetEncoder理解成一個(gè)Abstract Factory模式的實(shí)現：
Charset
代表了一個(gè)字符集，同時(shí)提供了factory method來(lái)構建相應的CharsetDecoder和CharsetEncoder。
Charset提供了以下static的方法：
SortedMap availableCharsets()
返回當前系統支持的所有Charset對象，用charset的名字作為set的key。
boolean isSupported(String charsetName)
判斷該名字對應的字符集是否被當前系統支持。
Charset forName(String charsetName)
返回該名字對應的Charset對象。
Charset中比較重要的方法有：
String name()
返回該字符集的規范名。
Set aliases()
返回該字符集的所有別名。
CharsetDecoder newDecoder()
創(chuàng )建一個(gè)對應于這個(gè)Charset的decoder。
CharsetEncoder newEncoder()
創(chuàng )建一個(gè)對應于這個(gè)Charset的encoder。
CharsetDecoder
將按某種字符集編碼的字節流解碼為unicode字符數據的引擎。
CharsetDecoder的輸入是ByteBuffer，輸出是CharBuffer。進(jìn)行decode操作時(shí)一般按如下步驟進(jìn)行：
1． 調用CharsetDecoder的reset()方法。（第一次使用時(shí)可不調用）
2． 調用decode()方法0到n次，將endOfInput參數設為false，告訴decoder有可能還有新的數據送入。
3． 調用decode()方法最后一次，將endOfInput參數設為true，告訴decoder所有數據都已經(jīng)送入。
4． 調用decoder的flush()方法。讓decoder有機會(huì )把一些內部狀態(tài)寫(xiě)到輸出的CharBuffer中。
CharsetDecoder reset()
重置decoder，并清除decoder中的一些內部狀態(tài)。
CoderResult decode(ByteBuffer in, CharBuffer out, boolean endOfInput)
從ByteBuffer類(lèi)型的輸入中decode盡可能多的字節，并將結果寫(xiě)到CharBuffer類(lèi)型的輸出中。根據decode的結果，可能返回3種CoderResult：CoderResult.UNDERFLOW表示已經(jīng)沒(méi)有輸入可以decode；CoderResult.OVERFLOW表示輸出已滿(mǎn)；其它的CoderResult表示decode過(guò)程中有錯誤發(fā)生。根據返回的結果，應用程序可以采取相應的措施，比如，增加輸入，清除輸出等等，然后再次調用decode()方法。
CoderResult flush(CharBuffer out)
有些decoder會(huì )在decode的過(guò)程中保留一些內部狀態(tài)，調用這個(gè)方法讓這些decoder有機會(huì )將這些內部狀態(tài)寫(xiě)到輸出的CharBuffer中。調用成功返回CoderResult.UNDERFLOW。如果輸出的空間不夠，該函數返回CoderResult.OVERFLOW，這時(shí)應用程序應該擴大輸出CharBuffer的空間，然后再次調用該方法。
CharBuffer decode(ByteBuffer in)
一個(gè)便捷的方法把ByteBuffer中的內容decode到一個(gè)新創(chuàng )建的CharBuffer中。在這個(gè)方法中包括了前面提到的4個(gè)步驟，所以不能和前3個(gè)函數一起使用。
decode過(guò)程中的錯誤有兩種：malformed-input CoderResult表示輸入中數據有誤；unmappable-character CoderResult表示輸入中有數據無(wú)法被解碼成unicode的字符。如何處理decode過(guò)程中的錯誤取決于decoder的設置。對于這兩種錯誤，decoder可以通過(guò)CodingErrorAction設置成：
1． 忽略錯誤
2． 報告錯誤。（這會(huì )導致錯誤發(fā)生時(shí)，decode()方法返回一個(gè)表示該錯誤的CoderResult。）
3． 替換錯誤，用decoder中的替換字串替換掉有錯誤的部分。
CodingErrorAction malformedInputAction()
返回malformed-input的出錯處理。
CharsetDecoder onMalformedInput(CodingErrorAction newAction)
設置malformed-input的出錯處理。
CodingErrorAction unmappableCharacterAction()
返回unmappable-character的出錯處理。
CharsetDecoder onUnmappableCharacter(CodingErrorAction newAction)
設置unmappable-character的出錯處理。
String replacement()
返回decoder的替換字串。
CharsetDecoder replaceWith(String newReplacement)
設置decoder的替換字串。
CharsetEncoder
將unicode字符數據編碼為特定字符集的字節流的引擎。其接口和CharsetDecoder相類(lèi)似。
CoderResult
描述encode/decode操作結果的類(lèi)。
CodeResult包含兩個(gè)static成員：
CoderResult OVERFLOW
表示輸出已滿(mǎn)
CoderResult UNDERFLOW
表示輸入已無(wú)數據可用。
其主要的成員函數有：
boolean isError()
boolean isMalformed()
boolean isUnmappable()
boolean isOverflow()
boolean isUnderflow()
用于判斷該CoderResult描述的錯誤。
int length()
返回錯誤的長(cháng)度，比如，無(wú)法被轉換成unicode的字節長(cháng)度。
void throwException()
拋出一個(gè)和這個(gè)CoderResult相對應的exception。
CodingErrorAction
表示encoder/decoder中錯誤處理方法的類(lèi)?？蓪⑵淇闯梢粋€(gè)enum類(lèi)型。有以下static屬性：
CodingErrorAction IGNORE
忽略錯誤。
CodingErrorAction REPLACE
用替換字串替換有錯誤的部分。
CodingErrorAction REPORT
報告錯誤，對于不同的函數，有可能是返回一個(gè)和錯誤有關(guān)的CoderResult，也有可能是拋出一個(gè)CharacterCodingException。
