Java中的 CharsetDecoder malformedInputAction() 方法及示例

Java中的CharsetDecoder类是用于将字节序列解码为字符序列的工具类。在将字节序列解码成字符序列的过程中，可能会存在一些无法被解码成字符的字节序列。这时候就可以通过CharsetDecoder的malformedInputAction()方法处理这些无法正常解码的字节序列。

malformedInputAction()方法介绍

malformedInputAction()方法用于获取或者设置在解码器遇到无法解码的字节序列时所采取的动作。其方法的签名如下：

public final CharsetDecoder malformedInputAction(CodingErrorAction newAction)

在这个方法中，可以传入四个参数：

• CodingErrorAction.REPLACE：替换无法解码的字节序列为一个特定的字符（默认是'?'）。
• CodingErrorAction.IGNORE：忽略无法解码的字节序列。
• CodingErrorAction.REPORT：报告无法解码的字节序列，并且抛出MalformedInputException异常。
• 自定义的CodingErrorAction。

示例代码

下面是一个示例代码，用于演示如何使用CharsetDecoder的malformedInputAction()方法：

import java.nio.ByteBuffer;
import java.nio.charset.Charset;
import java.nio.charset.CharsetDecoder;
import java.nio.charset.CodingErrorAction;
import java.nio.charset.MalformedInputException;

public class CharsetDecoderDemo {
    public static void main(String[] args) {
        Charset charset = Charset.forName("UTF-8");
        CharsetDecoder decoder = charset.newDecoder();
        decoder.onMalformedInput(CodingErrorAction.REPLACE);
        decoder.onUnmappableCharacter(CodingErrorAction.IGNORE);

        ByteBuffer buffer = ByteBuffer.wrap(new byte[]{(byte) 0xc3, (byte) 0x28});
        try {
            System.out.println(decoder.decode(buffer));
        } catch (MalformedInputException e) {
            System.out.println("MalformedInputException:" + e.getMessage());
        }
    }
}

在上面的示例代码中，首先创建了一个UTF-8编码的Charset对象，然后调用newDecoder()方法创建了一个相应的CharsetDecoder对象。接着，使用onMalformedInput()方法设置当解码器遇到无法解码的字节序列时采取的行动：替换无法解码的字节序列为一个特定的字符。最后，将一个包含一个UTF-8编码的无法正常解码的字节序列（0xc3, 0x28）的ByteBuffer对象传入decode()方法进行解码，程序输出替换后的字符"�("。

如果将onMalformedInput()方法的参数换成CodingErrorAction.REPORT，运行上面的代码，程序将不再输出任何内容，而是抛出一个MalformedInputException异常，异常消息为“2”。

代码片段：

Charset charset = Charset.forName("UTF-8");
CharsetDecoder decoder = charset.newDecoder();
decoder.onMalformedInput(CodingErrorAction.REPLACE);
decoder.onUnmappableCharacter(CodingErrorAction.IGNORE);

ByteBuffer buffer = ByteBuffer.wrap(new byte[]{(byte) 0xc3, (byte) 0x28});
try {
    System.out.println(decoder.decode(buffer));
} catch (MalformedInputException e) {
    System.out.println("MalformedInputException:" + e.getMessage());
}