Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes