Skip to content

Commit 7f1ce11

Browse files
brunoborgesbrunoborges
authored
Merge pull request #85 from javaevolved/i18n/pt-br-content-translations
Complete pt-BR content translations
2 parents 5e9b22c + d436a2b commit 7f1ce11

File tree

109 files changed

+2225
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

109 files changed

+2225
-0
lines changed

‎translations/content/pt-BR/collections/collectors-teeing.yaml‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
title: Collectors.teeing()
2+
oldApproach: Duas passagens
3+
modernApproach: teeing()
4+
summary: Compute duas agregações em uma única passagem pelo stream.
5+
explanation: Collectors.teeing() envia cada elemento para dois coletores downstream
6+
e combina os resultados. Isso evita percorrer os dados duas vezes ou usar um acumulador
7+
mutável.
8+
whyModernWins:
9+
- icon: "⚡"
10+
title: Passagem única
11+
desc: Processe o stream uma vez em vez de duas.
12+
- icon: "🧩"
13+
title: Componível
14+
desc: Combine quaisquer dois coletores com uma função de mesclagem.
15+
- icon: "🔒"
16+
title: Resultado imutável
17+
desc: Combine diretamente em um record ou objeto de valor.
18+
support:
19+
description: Amplamente disponível desde o JDK 12 (março de 2019)

‎translations/content/pt-BR/collections/copying-collections-immutably.yaml‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
title: Cópia imutável de coleções
2+
oldApproach: Cópia manual + encapsulamento
3+
modernApproach: List.copyOf()
4+
summary: Crie uma cópia imutável de qualquer coleção em uma única chamada.
5+
explanation: List.copyOf(), Set.copyOf() e Map.copyOf() criam snapshots imutáveis
6+
de coleções existentes. Se a origem já for uma coleção imutável, nenhuma cópia é
7+
feita.
8+
whyModernWins:
9+
- icon: "⚡"
10+
title: Cópia inteligente
11+
desc: Pula a cópia se a origem já for imutável.
12+
- icon: "📏"
13+
title: Uma chamada
14+
desc: Sem construção manual de ArrayList + encapsulamento.
15+
- icon: "🛡️"
16+
title: Cópia defensiva
17+
desc: Alterações na coleção original não afetam a cópia.
18+
support:
19+
description: Amplamente disponível desde o JDK 10 (março de 2018)

‎translations/content/pt-BR/collections/immutable-map-creation.yaml‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
title: Criação de mapas imutáveis
2+
oldApproach: Padrão Builder de Map
3+
modernApproach: Map.of()
4+
summary: Crie mapas imutáveis inline sem precisar de um builder.
5+
explanation: Map.of() aceita pares chave-valor inline e retorna um mapa imutável.
6+
Para mais de 10 entradas, use Map.ofEntries() com pares Map.entry().
7+
whyModernWins:
8+
- icon: "📏"
9+
title: Criação inline
10+
desc: Sem necessidade de um mapa mutável temporário.
11+
- icon: "🔒"
12+
title: Resultado imutável
13+
desc: O mapa não pode ser modificado após a criação.
14+
- icon: "🚫"
15+
title: Sem chaves/valores nulos
16+
desc: Entradas nulas são rejeitadas imediatamente.
17+
support:
18+
description: Amplamente disponível desde o JDK 9 (setembro de 2017)

‎translations/content/pt-BR/collections/immutable-set-creation.yaml‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
title: Criação de conjuntos imutáveis
2+
oldApproach: Encapsulamento verboso
3+
modernApproach: Set.of()
4+
summary: Crie conjuntos imutáveis com uma única chamada de método fábrica.
5+
explanation: Set.of() cria um conjunto verdadeiramente imutável que rejeita nulos e
6+
elementos duplicados no momento da criação. Chega de encapsular conjuntos mutáveis.
7+
whyModernWins:
8+
- icon: "📏"
9+
title: Conciso
10+
desc: Uma linha em vez de três chamadas aninhadas.
11+
- icon: "🚫"
12+
title: Detecta duplicatas
13+
desc: Lança exceção se você passar elementos duplicados acidentalmente.
14+
- icon: "🔒"
15+
title: Imutável
16+
desc: Nenhuma adição ou remoção é possível após a criação.
17+
support:
18+
description: Amplamente disponível desde o JDK 9 (setembro de 2017)

‎translations/content/pt-BR/collections/map-entry-factory.yaml‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
title: Fábrica Map.entry()
2+
oldApproach: SimpleEntry
3+
modernApproach: Map.entry()
4+
summary: Crie entradas de mapa com um método fábrica limpo.
5+
explanation: Map.entry() substitui o construtor verboso AbstractMap.SimpleEntry. Ele
6+
retorna uma entrada imutável, ideal para Map.ofEntries() e operações com streams.
7+
whyModernWins:
8+
- icon: "📏"
9+
title: Conciso
10+
desc: Uma linha em vez de três, com intenção mais clara.
11+
- icon: "🔒"
12+
title: Imutável
13+
desc: A entrada retornada não pode ser modificada.
14+
- icon: "🧩"
15+
title: Componível
16+
desc: Funciona perfeitamente com Map.ofEntries() para mapas grandes.
17+
support:
18+
description: Amplamente disponível desde o JDK 9 (setembro de 2017)

‎translations/content/pt-BR/collections/reverse-list-iteration.yaml‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
title: Iteração reversa de listas
2+
oldApproach: ListIterator manual
3+
modernApproach: reversed()
4+
summary: Itere sobre uma lista em ordem reversa com um for-each limpo.
5+
explanation: O método reversed() de SequencedCollection retorna uma visão em ordem
6+
inversa da lista. Essa visão é apoiada pela lista original, então nenhuma cópia é
7+
feita. A sintaxe do for aprimorado torna a iteração reversa tão legível quanto a
8+
iteração direta.
9+
whyModernWins:
10+
- icon: "📖"
11+
title: Sintaxe natural
12+
desc: For-each aprimorado em vez de ListIterator verboso.
13+
- icon: "⚡"
14+
title: Sem cópia
15+
desc: "reversed() retorna uma visão — sem overhead de desempenho."
16+
- icon: "🧩"
17+
title: API consistente
18+
desc: Funciona uniformemente em List, Deque e SortedSet.
19+
support:
20+
description: Amplamente disponível desde o JDK 21 LTS (setembro de 2023)

‎translations/content/pt-BR/collections/sequenced-collections.yaml‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
title: Coleções sequenciadas
2+
oldApproach: Aritmética de índice
3+
modernApproach: getFirst/getLast
4+
summary: Acesse o primeiro e o último elemento e obtenha visões reversas com métodos
5+
de API limpos.
6+
explanation: SequencedCollection adiciona getFirst(), getLast(), reversed(), addFirst()
7+
e addLast() a List, Deque, SortedSet e LinkedHashSet. Chega de aritmética com size()-1
8+
ou iteração reversa manual.
9+
whyModernWins:
10+
- icon: "📖"
11+
title: Autodocumentado
12+
desc: getLast() é mais claro que get(size()-1).
13+
- icon: "🔄"
14+
title: Visão reversa
15+
desc: "reversed() fornece uma visão — sem necessidade de cópia."
16+
- icon: "🧩"
17+
title: API uniforme
18+
desc: Funciona da mesma forma em List, Deque e SortedSet.
19+
support:
20+
description: Amplamente disponível desde o JDK 21 LTS (setembro de 2023)

‎translations/content/pt-BR/collections/stream-toarray-typed.yaml‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
title: toArray tipado com streams
2+
oldApproach: Cópia manual de array
3+
modernApproach: toArray(generator)
4+
summary: Converta streams em arrays tipados com uma referência de método.
5+
explanation: "O método toArray(IntFunction) cria um array com tipo correto a partir\
6+
\ de um stream. O gerador (String[]::new) indica ao stream qual tipo de array criar."
7+
whyModernWins:
8+
- icon: "🎯"
9+
title: Tipo seguro
10+
desc: "Sem cast de Object[] — o tipo do array está correto."
11+
- icon: "🔗"
12+
title: Encadeável
13+
desc: Funciona no final de qualquer pipeline de stream.
14+
- icon: "📏"
15+
title: Conciso
16+
desc: Uma expressão substitui o loop manual.
17+
support:
18+
description: Amplamente disponível desde o JDK 8 (março de 2014)

‎translations/content/pt-BR/collections/unmodifiable-collectors.yaml‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
title: Coletores não modificáveis
2+
oldApproach: collectingAndThen
3+
modernApproach: stream.toList()
4+
summary: Colete diretamente para uma lista não modificável com stream.toList().
5+
explanation: O Java 10 adicionou toUnmodifiableList(), toUnmodifiableSet() e toUnmodifiableMap()
6+
para substituir o encapsulamento verboso com collectingAndThen. Para listas especificamente,
7+
o stream.toList() do Java 16 oferece uma alternativa ainda mais simples — sem chamada
8+
a collect(). Use toUnmodifiableSet() e toUnmodifiableMap() para outros tipos de
9+
coleção.
10+
whyModernWins:
11+
- icon: "📏"
12+
title: O mais curto
13+
desc: stream.toList() não precisa de collect() nem de import de Collectors.
14+
- icon: "🔒"
15+
title: Imutável
16+
desc: "O resultado não pode ser modificado — sem mutações acidentais."
17+
- icon: "📖"
18+
title: Legível
19+
desc: Lê-se naturalmente como o passo final de qualquer pipeline de stream.
20+
support:
21+
description: Amplamente disponível desde o JDK 16 (março de 2021)

‎translations/content/pt-BR/concurrency/completablefuture-chaining.yaml‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
title: Encadeamento com CompletableFuture
2+
oldApproach: Future.get() bloqueante
3+
modernApproach: CompletableFuture
4+
summary: Encadeie operações assíncronas sem bloquear, usando CompletableFuture.
5+
explanation: CompletableFuture permite pipelines assíncronos sem bloqueio. Encadeie
6+
operações com thenApply, thenCompose e thenAccept. Trate erros com exceptionally().
7+
Combine múltiplos futures com allOf/anyOf.
8+
whyModernWins:
9+
- icon: "🔗"
10+
title: Encadeável
11+
desc: Componha etapas assíncronas em um pipeline legível.
12+
- icon: "🚫"
13+
title: Sem bloqueio
14+
desc: Nenhuma thread fica ociosa esperando resultados.
15+
- icon: "🛡️"
16+
title: Tratamento de erros
17+
desc: exceptionally() e handle() para recuperação limpa de erros.
18+
support:
19+
description: Amplamente disponível desde o JDK 8 (março de 2014)

0 commit comments

Comments
 (0)