Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

L’istruzione assert

L’istruzione assert: L’istruzione assert verifica un’ipotesi interna e in caso di fallimento genera AssertionError, eventualmente con il valore dell’espressione dopo i due punti.

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

Sintassi

assert

L’istruzione assert verifica un’ipotesi interna e in caso di fallimento genera AssertionError, eventualmente con il valore dell’espressione dopo i due punti.

Usa assert per invarianti che il codice corretto deve sempre rispettare durante test avviati con -ea.

Le asserzioni sono disabilitate per default; non usarle per validare argomenti di API pubbliche né inserirvi effetti collaterali necessari.

L’espressione del messaggio è valutata solo con condizione falsa e asserzioni abilitate; lo stato si configura per classe, package o class loader.

Main ha le asserzioni disabilitate come main-enabled=false, ma Checked è abilitata e il suo assert dà caught=negative:-1.

Esempi

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

Risultato

main-enabled=false
caught=negative:-1

Main ha le asserzioni disabilitate come main-enabled=false, ma Checked è abilitata e il suo assert dà caught=negative:-1.

Fonti