Guawa - klasa warunków wstępnych

Warunki wstępne zapewniają statyczne metody sprawdzania, czy metoda lub konstruktor jest wywoływana z odpowiednim parametrem, czy nie. Sprawdza warunki wstępne. Jej metody zgłaszają wyjątek IllegalArgumentException w przypadku niepowodzenia.

Deklaracja klasy

Poniżej znajduje się deklaracja dla com.google.common.base.Preconditions klasa -

@GwtCompatible
public final class Preconditions
   extends Object

Metody klasowe

Sr.No	Metoda i opis
1	static void checkArgument(boolean expression) Zapewnia prawdziwość wyrażenia zawierającego jeden lub więcej parametrów metody wywołującej.
2	static void checkArgument(boolean expression, Object errorMessage) Zapewnia prawdziwość wyrażenia zawierającego jeden lub więcej parametrów metody wywołującej.
3	static void checkArgument(boolean expression, String errorMessageTemplate, Object. errorMessageArgs) Zapewnia prawdziwość wyrażenia zawierającego jeden lub więcej parametrów metody wywołującej.
4	static int checkElementIndex(int index, int size) Zapewnia, że indeks określa prawidłowy element w tablicy, liście lub w ciągu o rozmiarze.
5	static int checkElementIndex(int index, int size, String desc) Zapewnia, że indeks określa prawidłowy element w tablicy, liście lub w ciągu o rozmiarze.
6	static <T> T checkNotNull(T reference) Zapewnia, że odwołanie do obiektu przekazane jako parametr do metody wywołującej nie ma wartości null.
7	static <T> T checkNotNull(T reference, Object errorMessage) Zapewnia, że odwołanie do obiektu przekazane jako parametr do metody wywołującej nie ma wartości null.
8	static <T> T checkNotNull(T reference, String errorMessageTemplate, Object... errorMessageArgs) Zapewnia, że odwołanie do obiektu przekazane jako parametr do metody wywołującej nie ma wartości null.
9	static int checkPositionIndex(int index, int size) Zapewnia, że indeks określa prawidłową pozycję w tablicy, liście lub w ciągu o rozmiarze.
10	static int checkPositionIndex(int index, int size, String desc) Zapewnia, że indeks określa prawidłową pozycję w tablicy, liście lub w ciągu o rozmiarze.
11	static void checkPositionIndexes(int start, int end, int size) Zapewnia, że początek i koniec określają prawidłowe pozycje w tablicy, liście lub w ciągu o rozmiarze i są uporządkowane.
12	static void checkState(boolean expression) Zapewnia prawdziwość wyrażenia obejmującego stan instancji wywołującej, ale bez uwzględniania żadnych parametrów w metodzie wywołującej.
13	static void checkState(boolean expression, Object errorMessage) Zapewnia prawdziwość wyrażenia obejmującego stan instancji wywołującej, ale bez uwzględniania żadnych parametrów w metodzie wywołującej.
14	static void checkState(boolean expression, String errorMessageTemplate, Object... errorMessageArgs) Zapewnia prawdziwość wyrażenia obejmującego stan instancji wywołującej, ale bez uwzględniania żadnych parametrów w metodzie wywołującej.

Dziedziczone metody

Ta klasa dziedziczy metody z następującej klasy -

java.lang.Object

Przykład klasy warunków wstępnych

Utwórz następujący program java, używając dowolnego wybranego edytora, powiedzmy C:/> Guava.

GuavaTester.java

import com.google.common.base.Preconditions;

public class GuavaTester {

   public static void main(String args[]) {
      GuavaTester guavaTester = new GuavaTester();

      try {
         System.out.println(guavaTester.sqrt(-3.0));
      } catch(IllegalArgumentException e) {
         System.out.println(e.getMessage());
      }

      try {
         System.out.println(guavaTester.sum(null,3));
      } catch(NullPointerException e) {
         System.out.println(e.getMessage());
      }

      try {
         System.out.println(guavaTester.getValue(6));
      } catch(IndexOutOfBoundsException e) {
         System.out.println(e.getMessage());
      }
   }

   public double sqrt(double input) throws IllegalArgumentException {
      Preconditions.checkArgument(input > 0.0,
         "Illegal Argument passed: Negative value %s.", input);
      return Math.sqrt(input);
   }

   public int sum(Integer a, Integer b) {
      a = Preconditions.checkNotNull(a, "Illegal Argument passed: First parameter is Null.");
      b = Preconditions.checkNotNull(b, "Illegal Argument passed: Second parameter is Null.");

      return a+b;
   }

   public int getValue(int input) {
      int[] data = {1,2,3,4,5};
      Preconditions.checkElementIndex(input,data.length, "Illegal Argument passed: Invalid index.");
      return 0;
   }
}

Sprawdź wynik

Skompiluj klasę przy użyciu javac kompilator w następujący sposób -

C:\Guava>javac GuavaTester.java

Teraz uruchom GuavaTester, aby zobaczyć wynik.

C:\Guava>java GuavaTester

Zobacz wynik.

Illegal Argument passed: Negative value -3.0.
Illegal Argument passed: First parameter is Null.
Illegal Argument passed: Invalid index. (6) must be less than size (5)