CKTIS / Java
NoSuchFieldException — veld niet gevonden
NoSuchFieldException is een gecontroleerde uitzondering die wordt opgegooid wanneer een zoekopdracht geen veld met de opgegeven naam vindt. Bij reflection is het zoekbereik van belang: getField zoekt openbare velden, terwijl getDeclaredField velden zoekt die rechtstreeks in het opgegeven type zijn gedeclareerd.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
public class NoSuchFieldException extends ReflectiveOperationException
new NoSuchFieldException()
new NoSuchFieldException("Field not found")
Class<?> type = Example.class;
type.getField("fieldName");
type.getDeclaredField("fieldName");NoSuchFieldException hoort bij java.lang en breidt ReflectiveOperationException uit. Het is een gecontroleerde uitzondering: als deze uit de methode kan ontsnappen, moet de code haar afvangen of met throws declareren. De constructors zijn NoSuchFieldException() en NoSuchFieldException(String s); de tweede accepteert een detailbericht.
Class.getField(String) zoekt alleen naar public-velden, inclusief overgeërfde velden. Class.getDeclaredField(String) zoekt naar velden die rechtstreeks in het opgegeven type zijn gedeclareerd, ongeacht de toegangsmodifier, maar niet naar overgeërfde velden. Beide methoden gooien NoSuchFieldException als ze binnen hun zoekbereik geen veld vinden. Dat betekent dus niet noodzakelijk dat het veld helemaal niet bestaat.
In het voorbeeld is balance private, dus getField("balance") gooit de uitzondering, terwijl getDeclaredField("balance") het veld vindt. Het vinden van een Field-object geeft op zichzelf geen toestemming om de veldwaarde te lezen of te wijzigen; het voorbeeld leest alleen de naam.
Controleer bij het opsporen van een fout de veldnaam, het onderzochte type en of je openbare of rechtstreeks gedeclareerde velden nodig hebt. Vang deze uitzondering af waar een ontbrekend veld zinvol kan worden afgehandeld; geef haar anders door.
Voorbeelden
public class Main {
static class Account {
private int balance;
}
public static void main(String[] args) throws NoSuchFieldException {
try {
Account.class.getField("balance");
System.out.println("Public field found");
} catch (NoSuchFieldException e) {
System.out.println("Public field not found");
}
System.out.println(
Account.class.getDeclaredField("balance").getName()
);
}
}Resultaat
Public field not found balance
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.