Guava - Classe opzionale

Facoltativo è un oggetto immutabile utilizzato per contenere un oggetto non nullo. L'oggetto facoltativo viene utilizzato per rappresentare null con valore assente. Questa classe ha vari metodi di utilità per facilitare il codice a gestire i valori come disponibili o non disponibili invece di controllare i valori nulli.

Dichiarazione di classe

Di seguito è riportata la dichiarazione per com.google.common.base.Optional<T> classe -

@GwtCompatible(serializable = true)
public abstract class Optional<T>
   extends Object
      implements Serializable

Metodi di classe

Suor n	Metodo e descrizione
1	static <T> Optional<T> absent() Restituisce un'istanza facoltativa senza riferimento contenuto.
2	abstract Set<T> asSet() Restituisce un set singleton immutabile il cui unico elemento è l'istanza contenuta, se presente; un insieme immutabile vuoto altrimenti.
3	abstract boolean equals(Object object) Restituisce true se object è un'istanza facoltativa e i riferimenti contenuti sono uguali tra loro o entrambi sono assenti.
4	static <T> Optional<T> fromNullable(T nullableReference) Se nullableReference è diverso da null, restituisce un'istanza facoltativa contenente tale riferimento; altrimenti restituisce absent ().
5	abstract T get() Restituisce l'istanza contenuta, che deve essere presente.
6	abstract int hashCode() Restituisce un codice hash per questa istanza.
7	abstract boolean isPresent() Restituisce vero se questo contenitore contiene un'istanza (non nulla).
8	static <T> Optional<T> of(T reference) Restituisce un'istanza facoltativa contenente il riferimento non nullo specificato.
9	abstract Optional<T> or(Optional<? extends T> secondChoice) Restituisce questo Opzionale se ha un valore presente; secondChoice altrimenti.
10	abstract T or(Supplier<? extends T> supplier) Restituisce l'istanza contenuta se è presente; fornitore.get () altrimenti.
11	abstract T or(T defaultValue) Restituisce l'istanza contenuta se è presente; defaultValue altrimenti.
12	abstract T orNull() Restituisce l'istanza contenuta se è presente; altrimenti nullo.
13	static <T> Iterable<T> presentInstances(Iterable<? extends Optional<? extends T>> optionals) Restituisce il valore di ogni istanza presente dagli optionals forniti, in ordine, saltando le occorrenze di absent ().
14	abstract String toString() Restituisce una rappresentazione di stringa per questa istanza.
15	abstract <V> Optional<V> transform(Function<? super T,V> function) Se l'istanza è presente, viene trasformata con la Funzione data; in caso contrario, viene restituito absent ().

Metodi ereditati

Questa classe eredita i metodi dalla classe seguente:

java.lang.Object

Esempio di classe opzionale

Crea il seguente programma java usando qualsiasi editor di tua scelta, diciamo C:/> Guava.

GuavaTester.java

import com.google.common.base.Optional;

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

      Integer value1 =  null;
      Integer value2 =  new Integer(10);
      
      //Optional.fromNullable - allows passed parameter to be null.
      Optional<Integer> a = Optional.fromNullable(value1);
      
      //Optional.of - throws NullPointerException if passed parameter is null
      Optional<Integer> b = Optional.of(value2);		

      System.out.println(guavaTester.sum(a,b));
   }

   public Integer sum(Optional<Integer> a, Optional<Integer> b) {
      //Optional.isPresent - checks the value is present or not
      System.out.println("First parameter is present: " + a.isPresent());

      System.out.println("Second parameter is present: " + b.isPresent());

      //Optional.or - returns the value if present otherwise returns
      //the default value passed.
      Integer value1 = a.or(new Integer(0));	

      //Optional.get - gets the value, value should be present
      Integer value2 = b.get();

      return value1 + value2;
   }	
}

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.

First parameter is present: false
Second parameter is present: true
10