Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

CodingErrorAction: prijava ili zamjena nevažećeg ulaza

CodingErrorAction određuje kako dekoder ili koder skupa znakova obrađuje pogreške kodiranja. REPORT prijavljuje pogrešku pozivatelju, dok REPLACE zamjenjuje neispravan dio konfiguriranom vrijednošću i nastavlja obradu. Pravila za neispravan ulaz i znakove koji se ne mogu preslikati postavljaju se zasebno.

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

Sintaksa

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

CodingErrorAction iz java.nio.charset definira pravila obrade pogrešaka za CharsetDecoder i CharsetEncoder. To je klasa s konstantama koje predstavljaju dostupne radnje, a ne deklaracija enum. Neispravan ulaz krši pravila kodiranja; pogreška znaka koji se ne može preslikati znači da se valjan niz ne može prikazati u izlazu. Ta se pravila postavljaju neovisno pomoću onMalformedInput(...) i onUnmappableCharacter(...).

CodingErrorAction.REPORT prijavljuje pogrešku: metode za postupnu obradu međuspremnika vraćaju odgovarajući CoderResult, dok metode decode(...) i encode(...) s jednim argumentom izbacuju odgovarajuću podklasu CharacterCodingException. Novi dekoderi i koderi prema zadanim postavkama koriste REPORT za obje kategorije pogrešaka. To ne znači da svaki API za pretvorbu teksta primjenjuje isto pravilo.

CodingErrorAction.REPLACE preskače neispravan ulaz, dodaje zamjensku vrijednost i nastavlja. Dekoder umeće tekst, a koder bajtove. Vrijednost promijenite pomoću replaceWith(...). Time se gube informacije; izvorni se sadržaj ne popravlja. Odaberite REPORT kada pogreške treba otkriti, a REPLACE samo ako je zamjena prihvatljiva. Primjer za Java SE 21 uspoređuje obje radnje na nevažećem UTF-8 bajtu i izričito postavlja ? kako bi izlaz bio čitljiv.

Primjeri

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)));
    }
}

Rezultat

REPORT: MalformedInputException
REPLACE: ?A

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori