> For the complete documentation index, see [llms.txt](https://educacion.gitbook.io/programacion/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://educacion.gitbook.io/programacion/ud7-poo-avanzada/clases-da-api-de-java/optional.md).
# Optional
A clase Optional en Java foi introducida en **Java 8** como parte do paquete `java.util`:copy:. Esta clase proporciona un mecanismo elegante para representar valores opcionais, é dicir, valores que poden ou non estar presentes. É moi útil para evitar o uso de `null` e as temidas excepcións `NullPointerException`:copy:.
{% hint style="warning" %}
**Documentación oficial:** [**https://docs.oracle.com/javase/8/docs/api/java/util/Optional.html**](https://docs.oracle.com/javase/8/docs/api/java/util/Optional.html)
{% endhint %}
Hai varias formas de crear un obxecto `Optional`:copy::
* `Optional.empty()`:copy:: Crea un `Optional`:copy: que non contén ningún valor.
```java
Optional optionalVacio = Optional.empty();
```
* `Optional.of(T valor)`:copy:: Crea un `Optional`:copy: co valor especificado. Se o valor é `null`, lanzará unha excepción `NullPointerException`:copy:.
```java
Optional optionalConValor = Optional.of("Ola!");
```
* `Optional.ofNullable(T valor)`:copy:: Crea un `Optional`:copy: que pode conter un valor ou estar baleiro se o valor é `null`.
```java
Optional optionalNullable = Optional.ofNullable(null); // Optional vacío
Optional optionalNullableConValor = Optional.ofNullable("Ola!");
```
Os principais métodos principais de `Optional`:copy: son:
* **`isPresent()`**:copy:: Comproba se o valor está presente.
```java
Optional optional = Optional.of("Ola!");
System.out.println(optional.isPresent()); // true
```
* **`get()`**: Retorna o valor almacenado se está presente. Se está baleiro, lanza unha excepción `NoSuchElementException`:copy:.
```java
System.out.println(optional.get()); // "Ola!"
```
```java
public class App {
public static void main(String[] args) {
String [] cadenas = {"Agua", "Tierra", "Mar"};
Optional cad1 = App.buscarCadena("Mar",cadenas);
if (cad1.isPresent())
System.out.println(cad1.get());
else
System.out.println("Cadena no encontrada");
Optional cad2 = App.buscarCadena("Fuego",cadenas);
if (cad2.isPresent())
System.out.println(cad2.get());
else
System.out.println("Cadena no encontrada");
}
public static Optional buscarCadena(String cadena, String[] cadenas){
for (String s: cadenas){
if (s.equals(cadena))
return Optional.of(s);
}
return Optional.empty();
}
}
```
## Vantaxes de Optional vs Null
* **Optional fai explícita a posibilidade de ausencia de valor.** A primeira definición o que da a entender que sempre devolve un String, mentras que a segunda o que di e que pode devolver un String ou non.
```java
public static String buscarCadena(String cadena, String[] cadenas){...}
public static Optional buscarCadena(String cadena, String[] cadenas){...}
```
* **Evita NullPointersException.** Os métodos da clase facilitan a división es ramas de código nos que se xestiona o caso no que se atopa e non se atopa valor
* **Permite encadenar operaciones:** Facilita un estilo de programación similar o directamente funcional
```java
//Encadenando
if (buscarCadena("Mar",cadenas).isPresent())
....
//Funcional
buscarCadena("Mar",cadenas)
.ifPresent(s -> System.out.println(s.toUpperCase()));
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://educacion.gitbook.io/programacion/ud7-poo-avanzada/clases-da-api-de-java/optional.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.