Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Instrukcja assert

Instrukcja assert: Instrukcja assert sprawdza założenie wewnętrzne i po niepowodzeniu rzuca AssertionError, opcjonalnie z wartością komunikatu po dwukropku.

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

Składnia

assert

Instrukcja assert sprawdza założenie wewnętrzne i po niepowodzeniu rzuca AssertionError, opcjonalnie z wartością komunikatu po dwukropku.

Używaj assert do niezmienników i warunków, które poprawny kod zawsze spełnia, podczas testów uruchamianych z -ea.

Asercje są domyślnie wyłączone, więc nie wolno używać ich do walidacji argumentów publicznego API ani umieszczać w nich wymaganych efektów ubocznych.

Wyrażenie komunikatu jest oceniane tylko po fałszywym warunku i przy włączonych asercjach; status można ustawiać per klasa, pakiet lub class loader.

Main ma asercje wyłączone jako main-enabled=false, lecz status klasy Checked jest włączony i jej assert kończy się caught=negative:-1.

Przykłady

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

Wynik

main-enabled=false
caught=negative:-1

Main ma asercje wyłączone jako main-enabled=false, lecz status klasy Checked jest włączony i jej assert kończy się caught=negative:-1.

Źródła