CKTIS / Java
CharacterCodingException — erros de codificação e descodificação
CharacterCodingException é uma exceção verificada de java.nio.charset que estende IOException. Indica uma falha na conversão entre caracteres e bytes e fornece um tipo comum para capturar entradas malformadas e caracteres não mapeáveis.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
public class CharacterCodingException extends IOException
public CharacterCodingException()CharacterCodingException, de java.nio.charset, é uma exceção verificada que estende IOException. Diz respeito à codificação de caracteres em bytes e à descodificação de bytes em caracteres. Se um método chamado declarar esta exceção, é necessário capturá-la ou declarar um tipo adequado em throws. A classe disponibiliza o construtor público sem argumentos CharacterCodingException().
As suas subclasses diretas são MalformedInputException e UnmappableCharacterException. A primeira indica uma sequência de entrada inválida, como bytes UTF-8 malformados; a segunda, uma sequência válida que não pode ser convertida para a representação de destino. catch (CharacterCodingException e) captura ambos os tipos de falha. Não os confunda com UnsupportedCharsetException, que indica que o conjunto de caracteres pedido não é suportado.
Um novo CharsetDecoder assinala ambos os tipos de erro por predefinição; o exemplo define explicitamente CodingErrorAction.REPORT. A chamada com um argumento decode(ByteBuffer) lança então a subclasse de exceção adequada. Em contrapartida, a sobrecarga em fluxo decode(ByteBuffer, CharBuffer, boolean) devolve um CoderResult que tem de ser verificado. As opções REPLACE e IGNORE substituem ou descartam, respetivamente, os dados errados, pelo que alteram o tratamento dos erros e podem causar perda de informação.
Exemplos
import java.nio.ByteBuffer;
import java.nio.charset.CharacterCodingException;
import java.nio.charset.CodingErrorAction;
import java.nio.charset.StandardCharsets;
public class Main {
public static void main(String[] args) {
var decoder = StandardCharsets.UTF_8.newDecoder()
.onMalformedInput(CodingErrorAction.REPORT)
.onUnmappableCharacter(CodingErrorAction.REPORT);
byte[] bytes = {(byte) 0xC3, (byte) 0x28};
try {
decoder.decode(ByteBuffer.wrap(bytes));
System.out.println("Decoded successfully");
} catch (CharacterCodingException e) {
System.out.println(e.getClass().getSimpleName());
}
}
}Resultado
MalformedInputException
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.