WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Die assert-Anweisung

Die assert-Anweisung: Die assert-Anweisung prüft eine interne Annahme und wirft bei Fehlschlag AssertionError, optional mit dem Wert des Ausdrucks nach dem Doppelpunkt.

Version: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Syntax

assert

Die assert-Anweisung prüft eine interne Annahme und wirft bei Fehlschlag AssertionError, optional mit dem Wert des Ausdrucks nach dem Doppelpunkt.

Nutze assert für Invarianten und Bedingungen, die korrekter Code in mit -ea gestarteten Tests stets erfüllen muss.

Assertions sind standardmäßig deaktiviert; nutze sie nie zur Validierung öffentlicher API-Argumente und lege keine erforderlichen Seiteneffekte hinein.

Der Nachrichtenausdruck wird nur bei falscher Bedingung und aktivierten Assertions ausgewertet; der Status ist je Klasse, Paket oder Class Loader konfigurierbar.

Main hat Assertions aus als main-enabled=false, Checked ist jedoch aktiviert und sein assert endet mit caught=negative:-1.

Beispiele

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

Ergebnis

main-enabled=false
caught=negative:-1

Main hat Assertions aus als main-enabled=false, Checked ist jedoch aktiviert und sein assert endet mit caught=negative:-1.

Quellen