Guava - Precondizioni Classe

Le precondizioni forniscono metodi statici per verificare che un metodo o un costruttore venga richiamato con il parametro appropriato o meno. Controlla le pre-condizioni. I suoi metodi generano IllegalArgumentException in caso di errore.

Dichiarazione di classe

Di seguito è riportata la dichiarazione per com.google.common.base.Preconditions classe -

@GwtCompatible
public final class Preconditions
   extends Object

Metodi di classe

Suor n	Metodo e descrizione
1	static void checkArgument(boolean expression) Assicura la veridicità di un'espressione che coinvolge uno o più parametri per il metodo chiamante.
2	static void checkArgument(boolean expression, Object errorMessage) Assicura la veridicità di un'espressione che coinvolge uno o più parametri per il metodo chiamante.
3	static void checkArgument(boolean expression, String errorMessageTemplate, Object. errorMessageArgs) Assicura la veridicità di un'espressione che coinvolge uno o più parametri per il metodo chiamante.
4	static int checkElementIndex(int index, int size) Assicura che index specifichi un elemento valido in un array, in un elenco o in una stringa di dimensioni.
5	static int checkElementIndex(int index, int size, String desc) Assicura che index specifichi un elemento valido in un array, in un elenco o in una stringa di dimensioni.
6	static <T> T checkNotNull(T reference) Assicura che un riferimento a un oggetto passato come parametro al metodo chiamante non sia nullo.
7	static <T> T checkNotNull(T reference, Object errorMessage) Assicura che un riferimento a un oggetto passato come parametro al metodo chiamante non sia nullo.
8	static <T> T checkNotNull(T reference, String errorMessageTemplate, Object... errorMessageArgs) Assicura che un riferimento a un oggetto passato come parametro al metodo chiamante non sia nullo.
9	static int checkPositionIndex(int index, int size) Assicura che index specifichi una posizione valida in un array, in un elenco o in una stringa di dimensioni.
10	static int checkPositionIndex(int index, int size, String desc) Assicura che index specifichi una posizione valida in un array, in un elenco o in una stringa di dimensioni.
11	static void checkPositionIndexes(int start, int end, int size) Assicura che l'inizio e la fine specifichino posizioni valide in un array, in un elenco o in una stringa di dimensioni e siano in ordine.
12	static void checkState(boolean expression) Assicura la verità di un'espressione che coinvolge lo stato dell'istanza chiamante, ma non coinvolge alcun parametro per il metodo chiamante.
13	static void checkState(boolean expression, Object errorMessage) Assicura la verità di un'espressione che coinvolge lo stato dell'istanza chiamante, ma non coinvolge alcun parametro per il metodo chiamante.
14	static void checkState(boolean expression, String errorMessageTemplate, Object... errorMessageArgs) Assicura la verità di un'espressione che coinvolge lo stato dell'istanza chiamante, ma non coinvolge alcun parametro per il metodo chiamante.

Metodi ereditati

Questa classe eredita i metodi dalla classe seguente:

java.lang.Object

Esempio di classe delle precondizioni

Crea il seguente programma java usando qualsiasi editor di tua scelta, diciamo 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;
   }
}

Verifica il risultato

Compila la classe usando javac compilatore come segue -

C:\Guava>javac GuavaTester.java

Ora esegui il GuavaTester per vedere il risultato.

C:\Guava>java GuavaTester

Guarda il risultato.

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)