feat(file-io): 🎸 recursive access, translated

Refers: #9

Author: rcmoutinho

book/07-file-io/sections/03-recursive-access.asc

@@ -1,189 +1,188 @@
 :java-package: src/org/j6toj8/fileio
 :section-java-package: ../../../{java-package}
 
-=== DirectoryStream e FileVisitor
+=== DirectoryStream and FileVisitor
 
 .Objetivo
 --------------------------------------------------
 Recursively access a directory tree by using the DirectoryStream and FileVisitor interfaces
--
-Acessar recursivamente uma árvore de diretório usando as interfaces DirectoryStream e FileVisitor
 --------------------------------------------------
 
-Nestão seção serão apresentadas duas classes para percorrer diretórios: `DirectoryStream` e `FileVisitor`.
+In this section we will present two classes for traversing directories: `DirectoryStream` and `FileVisitor`.
 
-. É possível checar vários atributos de um `Path` utilizando a classe `Files`.
+. You can check various attributes of a `Path` using the `Files` class.
 +
 [source,java,indent=0]
 .{java-package}/recursiveaccess/Recursive_DirectoryStream.java
 ----
 include::{section-java-package}/recursiveaccess/Recursive_DirectoryStream.java[tag=code]
 ----
 +
-.Saída no console
+.console output
 [source,console]
 ----
-Path: /home/rinaldo/arquivos
-/home/rinaldo/arquivos/arquivo1.txt
-/home/rinaldo/arquivos/arquivo3.txt
-/home/rinaldo/arquivos/subpasta1
-/home/rinaldo/arquivos/arquivo2.txt
-/home/rinaldo/arquivos/arquivo1.txt
-/home/rinaldo/arquivos/arquivo3.txt
-/home/rinaldo/arquivos/subpasta1
-/home/rinaldo/arquivos/arquivo2.txt
+Path: /home/rinaldo/files
+/home/rinaldo/files/file1.txt
+/home/rinaldo/files/file3.txt
+/home/rinaldo/files/subfolder1
+/home/rinaldo/files/file2.txt
+/home/rinaldo/files/file1.txt
+/home/rinaldo/files/file3.txt
+/home/rinaldo/files/subfolder1
+/home/rinaldo/files/file2.txt
 ----
 +
-Perceba que a instância de `DirectoryStream`:
+Note that the instance of `DirectoryStream`:
 +
-* Pode ser utilizada com try-with-resources.
-* Pode ser iterada com a sintaxe de for-each.
-* Pode ser iterada com o método `forEach` que recebe uma expressão lambda.
-* Lança exceção caso o arquivo não exista.
-* Não lista os subdiretórios de forma recursiva, mas sim apenas o primeiro nível.
-* Não tem relação com a API de _Streams_ do Java 8.
+* Can be used with try-with-resources.
+* Can be iterated with for-each syntax.
+* Can be iterated with the `forEach` method that receives a lambda expression.
+* Throws exception if the file does not exist.
+* Do not list subdirectories recursively, but only the first level.
+* Not related to the Java 8 _Streams_ API.
 
-. É possível acessar toda uma árvore de diretórios utilizando um `FileVisitor`.
+. You can access an entire directory tree using a `FileVisitor`.
 +
 [source,java,indent=0]
 .{java-package}/recursiveaccess/Recursive_SimpleFileVisitor.java
 ----
 include::{section-java-package}/recursiveaccess/Recursive_SimpleFileVisitor.java[tag=code]
 ----
 +
-.Saída no console
+.console output
 [source,console]
 ----
-Path: /home/rinaldo/arquivos
-Arquivo visitado: /home/rinaldo/arquivos/arquivo1.txt. Tamanho: 2
-Arquivo visitado: /home/rinaldo/arquivos/arquivo3.txt. Tamanho: 10
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/subpasta12/arquivo122.txt. Tamanho: 10
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/subpasta12/arquivo121.txt. Tamanho: 10
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/arquivo11.txt. Tamanho: 10
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/arquivo12.txt. Tamanho: 2
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/arquivo13.txt. Tamanho: 2
-Arquivo visitado: /home/rinaldo/arquivos/arquivo2.txt. Tamanho: 2
+Path: /home/rinaldo/files
+Visited file: /home/rinaldo/files/file1.txt. Size: 2
+Visited file: /home/rinaldo/files/file3.txt. Size: 10
+Visited file: /home/rinaldo/files/subfolder1/subfolder12/file122.txt. Size: 10
+Visited file: /home/rinaldo/files/subfolder1/subfolder12/file121.txt. Size: 10
+Visited file: /home/rinaldo/files/subfolder1/file11.txt. Size: 10
+Visited file: /home/rinaldo/files/subfolder1/file12.txt. Size: 2
+Visited file: /home/rinaldo/files/subfolder1/file13.txt. Size: 2
+Visited file: /home/rinaldo/files/file2.txt. Size: 2
 ----
 +
-Perceba que todos os arquivos do diretório e subdiretórios foram visitados e impressos no console ao invocar `Files.walkFileTree`. Para cada arquivo encontrado foi invocado o método `visitFile` da instância de `MeuFileVisitor`.
+Note that all files in the directory and subdirectories were visited and printed on the console by invoking `Files.walkFileTree`. For each file found the `visitFile` method of the instance of `MyFileVisitor` was invoked.
 +
-Veja que foi retornado `FileVisitResult.CONTINUE` do método `visitFile`. Isso instrui o FileVisitor a continuar visitando a árvore de arquivos. Também é possível retornar `TERMINATE`, `SKIP_SUBTREE` e `SKIP_SIBLINGS`, que serão apresentados a seguir.
+Note that `FileVisitResult.CONTINUE` has been returned from the `visitFile` method. This instructs FileVisitor to continue visiting the file tree. You can also return `TERMINATE`, `SKIP_SUBTREE` and `SKIP_SIBLINGS`, which will be shown below.
 
-. É possível finalizar a visitação quando for necessário retornando `FileVisitResult.TERMINATE`.
+. You can end the visit when needed by returning `FileVisitResult.TERMINATE`.
 +
 [source,java,indent=0]
 .{java-package}/recursiveaccess/Recursive_VisitorTerminate.java
 ----
 include::{section-java-package}/recursiveaccess/Recursive_VisitorTerminate.java[tag=code]
 ----
 +
-.Saída no console
+.console output
 [source,console]
 ----
-Path: /home/rinaldo/arquivos
-Arquivo visitado: /home/rinaldo/arquivos/arquivo1.txt. Tamanho: 2
-Arquivo visitado: /home/rinaldo/arquivos/arquivo3.txt. Tamanho: 10
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/subpasta12/arquivo122.txt. Tamanho: 10
-Arquivo encontrado. Finalizando.
+Path: /home/rinaldo/files
+Visited file: /home/rinaldo/files/file1.txt. Size: 2
+Visited file: /home/rinaldo/files/file3.txt. Size: 10
+Visited file: /home/rinaldo/files/subfolder1/subfolder12/file122.txt. Size: 10
+File found. Terminating.
 ----
 
-. Também é possível tomar decisões antes e depois de visitar diretórios.
+. It is also possible to make decisions before and after visiting directories.
 +
 [source,java,indent=0]
 .{java-package}/recursiveaccess/Recursive_VisitorDirectory.java
 ----
 include::{section-java-package}/recursiveaccess/Recursive_VisitorDirectory.java[tag=code]
 ----
 +
-.Saída no console
+.console output
 [source,console]
 ----
-Path: /home/rinaldo/arquivos
-Arquivo visitado: /home/rinaldo/arquivos/arquivo1.txt. Tamanho: 2
-Arquivo visitado: /home/rinaldo/arquivos/arquivo3.txt. Tamanho: 10
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/arquivo11.txt. Tamanho: 10
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/arquivo12.txt. Tamanho: 2
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/arquivo13.txt. Tamanho: 2
-Arquivo visitado: /home/rinaldo/arquivos/arquivo2.txt. Tamanho: 2
+Path: /home/rinaldo/files
+Visited file: /home/rinaldo/files/file1.txt. Size: 2
+Visited file: /home/rinaldo/files/file3.txt. Size: 10
+Visited file: /home/rinaldo/files/subfolder1/file11.txt. Size: 10
+Visited file: /home/rinaldo/files/subfolder1/file12.txt. Size: 2
+Visited file: /home/rinaldo/files/subfolder1/file13.txt. Size: 2
+Visited file: /home/rinaldo/files/file2.txt. Size: 2
 ----
 
-. Também é possível ignorar todos os elementos que estão no mesmo nível de um `Path`.
+. You can also ignore all elements that are on the same level as a `Path`.
 +
 [source,java,indent=0]
 .{java-package}/recursiveaccess/Recursive_VisitorIgnoreSiblings.java
 ----
 include::{section-java-package}/recursiveaccess/Recursive_VisitorIgnoreSiblings.java[tag=code]
 ----
 +
-.Saída no console
+.console output
 [source,console]
 ----
-Path: /home/rinaldo/arquivos
-Arquivo visitado: /home/rinaldo/arquivos/arquivo1.txt. Tamanho: 2
-Arquivo visitado: /home/rinaldo/arquivos/arquivo3.txt. Tamanho: 10
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/subpasta12/arquivo122.txt. Tamanho: 10
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/subpasta12/arquivo121.txt. Tamanho: 10
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/arquivo11.txt. Tamanho: 10
-Arquivo visitado: /home/rinaldo/arquivos/arquivo2.txt. Tamanho: 2
+Path: /home/rinaldo/files
+Visited file: /home/rinaldo/files/file1.txt. Size: 2
+Visited file: /home/rinaldo/files/file3.txt. Size: 10
+Visited file: /home/rinaldo/files/subfolder1/subfolder12/file122.txt. Size: 10
+Visited file: /home/rinaldo/files/subfolder1/subfolder12/file121.txt. Size: 10
+Visited file: /home/rinaldo/files/subfolder1/file11.txt. Size: 10
+Visited file: /home/rinaldo/files/file2.txt. Size: 2
 ----
 
-. É possível implementar diretamente a interface `FileVisitor`, ao invés de `SimpleFileVisitor`, e implementar todos os seus métodos.
+. You can directly implement the `FileVisitor` interface, instead of `SimpleFileVisitor`, and implement all of its methods.
 +
 [source,java,indent=0]
 .{java-package}/recursiveaccess/Recursive_FileVisitor.java
 ----
 include::{section-java-package}/recursiveaccess/Recursive_FileVisitor.java[tag=code]
 ----
 +
-.Saída no console
+.console output
 [source,console]
 ----
-Path: /home/rinaldo/arquivos
-Antes de visitar o diretório: /home/rinaldo/arquivos
-Arquivo visitado: /home/rinaldo/arquivos/arquivo1.txt
-Arquivo visitado: /home/rinaldo/arquivos/arquivo3.txt
-Antes de visitar o diretório: /home/rinaldo/arquivos/subpasta1
-Antes de visitar o diretório: /home/rinaldo/arquivos/subpasta1/subpasta12
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/subpasta12/arquivo122.txt
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/subpasta12/arquivo121.txt
-Após de visitar o diretório: /home/rinaldo/arquivos/subpasta1/subpasta12
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/arquivo11.txt
-Antes de visitar o diretório: /home/rinaldo/arquivos/subpasta1/subpasta11
-Após de visitar o diretório: /home/rinaldo/arquivos/subpasta1/subpasta11
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/arquivo12.txt
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/arquivo13.txt
-Após de visitar o diretório: /home/rinaldo/arquivos/subpasta1
-Arquivo visitado: /home/rinaldo/arquivos/arquivo2.txt
-Após de visitar o diretório: /home/rinaldo/arquivos
-----
-
-. É possível definir opções adicionais e limitar a profundidade utilizando outra versão do método `walkFileTree`.
+Path: /home/rinaldo/files
+Before visiting the directory: /home/rinaldo/files
+Visited file: /home/rinaldo/files/file1.txt
+Visited file: /home/rinaldo/files/file3.txt
+Before visiting the directory: /home/rinaldo/files/subfolder1
+Before visiting the directory: /home/rinaldo/files/subfolder1/subfolder12
+Visited file: /home/rinaldo/files/subfolder1/subfolder12/file122.txt
+Visited file: /home/rinaldo/files/subfolder1/subfolder12/file121.txt
+After visiting the directory: /home/rinaldo/files/subfolder1/subfolder12
+Visited file: /home/rinaldo/files/subfolder1/file11.txt
+Before visiting the directory: /home/rinaldo/files/subfolder1/subfolder11
+After visiting the directory: /home/rinaldo/files/subfolder1/subfolder11
+Visited file: /home/rinaldo/files/subfolder1/file12.txt
+Visited file: /home/rinaldo/files/subfolder1/file13.txt
+After visiting the directory: /home/rinaldo/files/subfolder1
+Visited file: /home/rinaldo/files/file2.txt
+After visiting the directory: /home/rinaldo/files
+----
+
+. You can set additional options and limit depth using another version of the `walkFileTree` method.
 +
 [source,java,indent=0]
 .{java-package}/recursiveaccess/Recursive_VisitorOptionsAndDepth.java
 ----
 include::{section-java-package}/recursiveaccess/Recursive_VisitorOptionsAndDepth.java[tag=code]
 ----
 +
-.Saída no console
+.console output
 [source,console]
 ----
-Path: /home/rinaldo/arquivos
-Arquivo visitado: /home/rinaldo/arquivos/arquivo1.txt
-Arquivo visitado: /home/rinaldo/arquivos/arquivo3.txt
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/subpasta12
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/arquivo11.txt
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/subpasta11
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/arquivo12.txt
-Arquivo visitado: /home/rinaldo/arquivos/subpasta1/arquivo13.txt
-Arquivo visitado: /home/rinaldo/arquivos/arquivo2.txt
+Path: /home/rinaldo/files
+Visited file: /home/rinaldo/files/file1.txt
+Visited file: /home/rinaldo/files/file3.txt
+Visited file: /home/rinaldo/files/subfolder1/subfolder12
+Visited file: /home/rinaldo/files/subfolder1/file11.txt
+Visited file: /home/rinaldo/files/subfolder1/subfolder11
+Visited file: /home/rinaldo/files/subfolder1/file12.txt
+Visited file: /home/rinaldo/files/subfolder1/file13.txt
+Visited file: /home/rinaldo/files/file2.txt
 ----
 
+.References
 ****
 
 * Working with Directories
 +
-Boyarsky, Jeanne; Selikoff, Scott. OCP: Oracle Certified Professional Java SE 8 Programmer II Study Guide (p. 617). Wiley. Edição do Kindle. 
+Boyarsky, Jeanne; Selikoff, Scott. OCP: Oracle Certified Professional Java SE 8 Programmer II Study Guide (p. 617). Wiley. Kindle Edition.
 
 * https://www.baeldung.com/java-list-directory-files[List Files in a Directory in Java.]
 
@@ -195,4 +194,4 @@ Boyarsky, Jeanne; Selikoff, Scott. OCP: Oracle Certified Professional Java SE 8
 
 * https://docs.oracle.com/javase/tutorial/essential/io/pathOps.html[Path Operations.] The Java™ Tutorials.
 
-****
+****

src/org/j6toj8/fileio/recursiveaccess/Recursive_DirectoryStream.java

@@ -11,11 +11,11 @@ public class Recursive_DirectoryStream {
   public static void main(String[] args) {
     // tag::code[]
     String userHome = System.getProperty("user.home");
-    Path path = Paths.get(userHome, "arquivos");
+    Path path = Paths.get(userHome, "files");
     System.out.println("Path: " + path);
 
     try (DirectoryStream<Path> directoryStream = Files.newDirectoryStream(path)) {
-      // iteração com sintaxe for-each
+      // iteration with for-each syntax
       for (Path subPath : directoryStream) {
         System.out.println(subPath);
       }
@@ -24,7 +24,7 @@ public static void main(String[] args) {
     }
 
     try (DirectoryStream<Path> directoryStream = Files.newDirectoryStream(path)) {
-      // iteração com operação forEach e expressão lambda
+      // iteration with forEach operation and lambda expression
       directoryStream.forEach(p -> System.out.println(p));
     } catch (IOException e) {
       e.printStackTrace();

src/org/j6toj8/fileio/recursiveaccess/Recursive_FileVisitor.java

@@ -11,38 +11,38 @@
 public class Recursive_FileVisitor {
 
   // tag::code[]
-  static class MeuFileVisitor implements FileVisitor<Path> {
+  static class MyFileVisitor implements FileVisitor<Path> {
     @Override
     public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException {
-      System.out.println("Arquivo visitado: " + file);
+      System.out.println("Visited file: " + file);
       return FileVisitResult.CONTINUE;
     }
 
     @Override
     public FileVisitResult preVisitDirectory(Path dir, BasicFileAttributes attrs) throws IOException {
-      System.out.println("Antes de visitar o diretório: " + dir);
+      System.out.println("Before visiting the directory: " + dir);
       return FileVisitResult.CONTINUE;
     }
 
     @Override
     public FileVisitResult postVisitDirectory(Path dir, IOException exc) throws IOException {
-      System.out.println("Após de visitar o diretório: " + dir);
+      System.out.println("After visiting the directory: " + dir);
       return FileVisitResult.CONTINUE;
     }
 
     @Override
     public FileVisitResult visitFileFailed(Path file, IOException exc) throws IOException {
-      System.out.println("Falhou ao visitar o arquivo: " + file);
+      System.out.println("Failed to visit file: " + file);
       return FileVisitResult.CONTINUE;
     }
   }
 
   public static void main(String[] args) {
     String userHome = System.getProperty("user.home");
-    Path path = Paths.get(userHome, "arquivos");
+    Path path = Paths.get(userHome, "files");
     System.out.println("Path: " + path);
     try {
-      Files.walkFileTree(path, new MeuFileVisitor());
+      Files.walkFileTree(path, new MyFileVisitor());
     } catch (IOException e) {
       e.printStackTrace();
     }

src/org/j6toj8/fileio/recursiveaccess/Recursive_SimpleFileVisitor.java

@@ -11,24 +11,23 @@
 public class Recursive_SimpleFileVisitor {
 
   // tag::code[]
-  // Implementação simples de um SimpleFileVisitor
-  static class MeuFileVisitor extends SimpleFileVisitor<Path> {
+  // Simple Implementation of a SimpleFileVisitor
+  static class MyFileVisitor extends SimpleFileVisitor<Path> {
     @Override
     public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException {
-      // Método que será invocado a cada arquivo encontrado
-      System.out.println("Arquivo visitado: " + file + ". Tamanho: " + attrs.size());
-      return FileVisitResult.CONTINUE; // instrui o FileVisitor a continuar seguindo a árvore de arquivos
+      // Method that will be invoked for each file found
+      System.out.println("Visited file: " + file + ". Size: " + attrs.size());
+      return FileVisitResult.CONTINUE; // instructs FileVisitor to continue following the file tree
     }
   }
 
   public static void main(String[] args) {
     String userHome = System.getProperty("user.home");
-    Path path = Paths.get(userHome, "arquivos");
+    Path path = Paths.get(userHome, "files");
     System.out.println("Path: " + path);
     try {
-      // Utilização da classe MeuFileVisitor para acessar
-      // todos os arquivos no diretório e seus subdiretórios
-      Files.walkFileTree(path, new MeuFileVisitor());
+      // Using the MyFileVisitor class to access all files in the directory and their subdirectories.
+      Files.walkFileTree(path, new MyFileVisitor());
     } catch (IOException e) {
       e.printStackTrace();
     }