CKTIS / Java
De assert-instructie
De assert-instructie: De assert-instructie controleert een interne aanname en werpt bij mislukking AssertionError, eventueel met de waarde van de expressie na de dubbele punt.
Versie: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Syntax
assertDe assert-instructie controleert een interne aanname en werpt bij mislukking AssertionError, eventueel met de waarde van de expressie na de dubbele punt.
Gebruik assert voor invarianten die correcte code altijd moet respecteren tijdens tests die met -ea draaien.
Assertions staan standaard uit; gebruik ze nooit voor validatie van publieke API-argumenten en plaats er geen noodzakelijke neveneffecten in.
De berichtexpressie wordt alleen bij een onware conditie en actieve assertions geëvalueerd; status is per klasse, package of classloader instelbaar.
Main heeft assertions uit als main-enabled=false, maar Checked staat aan en haar assert geeft caught=negative:-1.
Voorbeelden
public class Main {
static class Checked { static void verify(int n){ assert n>=0:"negative:"+n; } }
public static void main(String[] args) throws Exception {
if(args.length==0){
System.out.println("main-enabled="+Main.class.desiredAssertionStatus());
String java=ProcessHandle.current().info().command().orElseThrow();
var child=new ProcessBuilder(java,"-ea","-cp",System.getProperty("java.class.path"),"Main","child").inheritIO().start();
if(child.waitFor()!=0) throw new IllegalStateException("child failed");
} else {
try { Checked.verify(-1); } catch(AssertionError ex) { System.out.println("caught="+ex.getMessage()); }
}
}
}
Resultaat
main-enabled=false caught=negative:-1
Main heeft assertions uit als main-enabled=false, maar Checked staat aan en haar assert geeft caught=negative:-1.