refactor(using-streams): explicação sobre Optional

rinaldodev · rinaldodev · commit d25372582661 · 2019-07-26T21:38:49.000-03:00
Adicionando duas explicações adicionais sobre a utilização de Optional nas operações min, max, findAny e findFirst. Ref. Issue #23
diff --git a/book/05-java-streams/sections/01-using-streams.asc b/book/05-java-streams/sections/01-using-streams.asc
@@ -280,6 +280,8 @@ Count: 8
 ----
 +
 No caso das operações `max` e `min`, é necessário passar como argumento qual comparador será utilizado. Como os números possuem uma ordem natural, isto é, implementam a interface `Comparable`, é possível utilizar um comparador que usa essa ordem natural, que é o `Comparator.naturalOrder()`. Caso seja um tipo de objeto que não possui uma ordem natural, é necessário passar como argumento uma outra implementação de `Comparator`.
++
+As operações `max` e `min` retornam `Optional` pois, caso o _Stream_ esteja vazio, será um `Optional` vazio. Desde o Java 8, com a adição da classe `Optional`, isso tem sido preferido ao invés de retornar `null`, pois facilita a programação funcional. A operação `count` não precisa de um `Optional`, pois mesmo com um _Stream_ vazio irá retornar `0`.
 
 . É possível pegar o primeiro elemento do Stream utilizando a operação final `findFirst`, ou um elemento qualquer com `findAny`.
 +
@@ -297,6 +299,8 @@ Any: 7
 ----
 +
 Nesse caso, como o _Stream_ é sequencial e não paralelo, os dois resultados são iguais. Em _Streams_ paralelos, que serão apresentados em uma próxima seção, a operação `findAny` pode trazer resultados diferentes.
++
+Assim como as operações `max` e `min` apresentadas anteriormente, `findAny` e `findFirst` retornam um `Optional` vazio caso o _Stream_ esteja vazio.
 
 . É possível verificar se os elementos do _Stream_ atendem a alguma validação utilizando as operações finais `allMatch`, `anyMatch` e `noneMatch`.
 +

Original file line number	Diff line number	Diff line change
`@@ -280,6 +280,8 @@ Count: 8`
`280`	`280`	`----`
`281`	`281`	`+`
`282`	`282`	No caso das operações `max` e `min`, é necessário passar como argumento qual comparador será utilizado. Como os números possuem uma ordem natural, isto é, implementam a interface `Comparable`, é possível utilizar um comparador que usa essa ordem natural, que é o `Comparator.naturalOrder()`. Caso seja um tipo de objeto que não possui uma ordem natural, é necessário passar como argumento uma outra implementação de `Comparator`.
	`283`	`++`
	`284`	+As operações `max` e `min` retornam `Optional` pois, caso o _Stream_ esteja vazio, será um `Optional` vazio. Desde o Java 8, com a adição da classe `Optional`, isso tem sido preferido ao invés de retornar `null`, pois facilita a programação funcional. A operação `count` não precisa de um `Optional`, pois mesmo com um _Stream_ vazio irá retornar `0`.
`283`	`285`
`284`	`286`	. É possível pegar o primeiro elemento do Stream utilizando a operação final `findFirst`, ou um elemento qualquer com `findAny`.
`285`	`287`	`+`
`@@ -297,6 +299,8 @@ Any: 7`
`297`	`299`	`----`
`298`	`300`	`+`
`299`	`301`	Nesse caso, como o _Stream_ é sequencial e não paralelo, os dois resultados são iguais. Em _Streams_ paralelos, que serão apresentados em uma próxima seção, a operação `findAny` pode trazer resultados diferentes.
	`302`	`++`
	`303`	+Assim como as operações `max` e `min` apresentadas anteriormente, `findAny` e `findFirst` retornam um `Optional` vazio caso o _Stream_ esteja vazio.
`300`	`304`
`301`	`305`	. É possível verificar se os elementos do _Stream_ atendem a alguma validação utilizando as operações finais `allMatch`, `anyMatch` e `noneMatch`.
`302`	`306`	`+`