KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

CodingErrorAction: ongeldige invoer melden of vervangen

CodingErrorAction bepaalt hoe een charsetdecoder of -encoder omgaat met coderingsfouten. REPORT maakt een fout bekend aan de aanroeper, terwijl REPLACE het foutieve deel vervangt door de ingestelde waarde en doorgaat met verwerken. Het beleid voor ongeldige invoer en niet-afbeeldbare tekens wordt afzonderlijk ingesteld.

Versie: Java SE 21; repository runtime, production runtime not attested

Syntax

coder.onMalformedInput(CodingErrorAction.REPORT);
coder.onUnmappableCharacter(CodingErrorAction.REPLACE);

CodingErrorAction in java.nio.charset definieert foutafhandelingsbeleid voor CharsetDecoder en CharsetEncoder. Het is een klasse met constanten voor de beschikbare acties, geen enum-declaratie. Ongeldige invoer voldoet niet aan de coderingsregels; een fout met een niet-afbeeldbaar teken betekent dat een geldige reeks niet in de uitvoer kan worden weergegeven. Stel dit beleid afzonderlijk in met onMalformedInput(...) en onUnmappableCharacter(...).

CodingErrorAction.REPORT meldt een fout: methoden voor incrementele bufferverwerking geven een passende CoderResult terug, terwijl de methoden met één argument decode(...) en encode(...) een passende subklasse van CharacterCodingException gooien. Nieuwe decoders en encoders gebruiken standaard REPORT voor beide foutcategorieën. Dat betekent niet dat elke API voor tekstconversie hetzelfde beleid gebruikt.

CodingErrorAction.REPLACE slaat de foutieve invoer over, voegt de vervangende waarde toe en gaat verder. Een decoder voegt tekst in; een encoder voegt bytes in. Wijzig de waarde met replaceWith(...). Dit leidt tot informatieverlies en herstelt het origineel niet. Kies REPORT als fouten moeten worden opgespoord en REPLACE alleen als vervanging aanvaardbaar is. Het voorbeeld voor Java SE 21 vergelijkt beide acties met een ongeldige UTF-8-byte en stelt expliciet ? in om de uitvoer leesbaar te maken.

Voorbeelden

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) throws CharacterCodingException {
        byte[] input = {(byte) 0xFF, 0x41};

        var strict = StandardCharsets.UTF_8.newDecoder()
                .onMalformedInput(CodingErrorAction.REPORT);
        try {
            strict.decode(ByteBuffer.wrap(input));
        } catch (CharacterCodingException e) {
            System.out.println("REPORT: " + e.getClass().getSimpleName());
        }

        var tolerant = StandardCharsets.UTF_8.newDecoder()
                .onMalformedInput(CodingErrorAction.REPLACE)
                .replaceWith("?");
        System.out.println("REPLACE: " + tolerant.decode(ByteBuffer.wrap(input)));
    }
}

Resultaat

REPORT: MalformedInputException
REPLACE: ?A

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen