Este documento apresenta a API Java NIO.2 como uma alternativa melhorada à API java.io para manipulação de arquivos no Java. Apresenta as limitações da API java.io e o design da API NIO.2, incluindo os pacotes principais, a interface Path, a classe Files com métodos estáticos e o WatchService para monitoramento de arquivos. Demonstra várias operações comuns como criação, leitura e escrita de arquivos e diretórios, atributos de arquivo, listagem de diretórios e percorrimento de árvores

1. JavaNIO.2:MaisumaAPIparaI/O?
UMARÁPIDAINTRODUÇÃO
FranciscoOliveira
OzJUG-2016

3. WhoamI?
AnalistadeSistemas
● Iron Mountain do Brasil
TecnólogoemAnáliseeDesenvolvimentodeSistemas
● Fatec Ipiranga
Social
● delley.fx@gmail.com
● @delley_fx
● facebook.com/delley.fx
● github.com/delley

4. O que há de errado com
java.io.File?

5. ● Faltadeinformação sobre o que está acontecendo
● Operações com arquivo nãosãoatômicas
● Semacessoemmassa para atributos dos arquivos
● Difilcudades para escalarlistagem de diretórios
● Faltam operações básicas
● Não é possível copiaratributos de um arquivo
Por que outra API para a
MANIPULAÇÃO de ARQUIVOS?

6. ● Suporte limitado para metadadosdoarquivo
● Suporte limitado para linkssimbólicos
● Não há maneiras de estender a API para implementações
de sistemasdearquivoscustomizados
● Não há suporte para notificações
Por que outra API para a
MANIPULAÇÃO de ARQUIVOS?

7. OdesigndaAPINIO.2
Pacotes
● java.nio.file
● java.nio.file.attribute
● java.nio.file.spi
Path
● Um caminho no sistema de arquivos
Paths
● Fábrica de objetos Path (caminho)
Files
● Classe com métodos estáticos para operações mais comuns
FileSystems
● Fábrica de objetos FileSystem
FileStore
● Encapsula o sistema de armazenamento

8. AinterfacePath
●Representa um caminho absoluto ou relativo
●Iterável sobre elementos de um caminho
●Imutável
●Operações para:
 Acesso aos elementos de caminho
 Combinar caminhos
 Comparar caminhos

9. Criandoumcaminho
Path path =
FileSystems.getDefault().getPath("/foo");

10. Criandoumcaminho
Path path = Paths.get("/foo");

11. Criandoumcaminho
URI uri = URI.create("file:///foo");
Path path = Paths.get(uri);

12. Criandoumcaminho
File file = new File("/foo");
Path path = file.getPath();

13. Acessandoelementosdeumcaminho
Path path = Paths.get("/","foo","bar","x");
Path file = path.getFileName();
Path parent = path.getParent();
Path root = path.getRoot();
Path subpath = path.subpath(1,3);

14. Acessandoelementosdeumcaminho
Path path = Paths.get("/","foo","bar","x");
for (Path element : path ) {
System.out.format("%s%n", element);
}

15. Combinandocaminhos
Path foo = Paths.get("/", "foo");
Path bar = foo.resolve("bar");
Path baz = foo.resolveSibling("baz");
Path qux = Paths.get("/", "baz", "qux");
Path relative = foo.relativize(qux);

16. Testandocaminhos
Path path = Paths.get("top", "foo", "bar");
boolean isStart = path.startsWith("to");
boolean isEnd = path.endsWith("pot");
boolean isAbs = path.isAbsolute();

17. Outrasoperações
Path path = Paths.get("top", "foo", "bar");
Path normal = path.normalize();
Path abs = path.toAbsolutePath();
Path real = path.toRealPath();
URI uri = path.toUri();
File file = path.toFile();

18. AclasseFiles
● Métodos estáticas para trabalhar com arquivos
● A maioria das operações espera um Path como argumento
● Operações para:
 Leitura e Escrita de arquivos
 Streams, leitores (readers), escritores (writers)
 Links Simbólicos
 Trabalhar com diretórios
● Lança exceções significativas em caso de falha

19. Files:Operaçõesbásicas
Path file = Files.createFile(path);
Path dir = Files.createDirectory(pathDir);
Path dir = Files.createDirectories(pathDir);

20. Files:Operaçõesbásicas
import static
java.nio.charset.StandardCharsets.*;
List<String> lines = Files.readAllLines(file,
UTF_8);
byte[] bytes = Files.readAllBytes(file);

21. Files.delete(path);
Files.deleteIfExists(path);
Files.copy(source, target);
Files.copy(source, target, ATOMIC_MOVE,
REPLACE_EXISTING, COPY_ATTRIBUTES);
Files.move(source, target);
Files:Operaçõesbásicas

22. Files:Linkssimbólicos
Path link = Paths.get("top", "link");
Path target = Paths.get("top", "foo", "tar");
Files.createSymbolicLink(link, target);
boolean isSymLink = Files.isSymbolicLink(link);
boolean isSame = Files.isSameFile(link, target);
Path tar = Files.readSymbolicLink(link);

23. Leitura(reader)eescrita(Writer)
import static
java.nio.charset.StandardCharsets.*;
import java.nio.file.StandardOpenOption;
Path file = ...
BufferedReader reader =
Files.newBufferedReader(file, UTF_8);
BufferedWriter writer =
Files.newBufferedWriter(file, UTF_8,
StandardOpenOption.CREATE_NEW);

24. Streams
Path file = ...
InputStream is =
Files.newInputStream(file);
OutputStream os =
Files.newOutputStream(file);
OutputStream osAppend =
Files.newOutputStream(file, CREATE, APPEND);

25. Atributosdearquivo
● Metadados dos arquivos
● Exemplo:
 criado, atualizado, data do último acesso
 rwxr--r--
● Definido pela plataforma e sistemas de arquivos

26. Atributosdearquivo
BasicFileAttributes
● Suportado por todas as plataformas
● Datas (criação, modificação, último acesso), tipo
arquivo, tamanho, chave do arquivo
DosFileAttributes
● Oculto, arquivo, somente leitura, sistema
PosixFileAttributes
● Dono, grupo, conjunto de permissões

27. Atributosdearquivo
BasicFileAttributes basicAttr =
Files.readAttributes(path,
BasicFileAttributes.class);
String key = basicAttr.fileKey();
long size = basicAttr.size();
boolean isDirectory = basicAttr.isDirectory();
FileTime lastModified =
basicAttr.lastModifiedTime();

28. Atributosdearquivo
PosixFileAttributes posixAttr =
Files.readAttributes(path,
PosixFileAttributes.class);
UserPrincipal owner = posixAttr.owner();
GroupPrincipal group = posixAttr.group();
String perms =
PosixFilePermissions.toString(
posixAttr.permissions()));
Files.setPosixFilePermissions(path,
PosixFilePermissions.fromString("rwxrwxrwx"));

29. ListagemdeDiretório
● Iteração eficiente na listagem de diretórios
● Escalabilidade para grandes diretórios, sistemas de
arquivos remotos, etc.
● Suporta filtros:
 Glob
 Regex
 Filtros personalizados

30. ListagemdeDiretórios
try (DirectoryStream<Path> dirStream =
Files.newDirectoryStream(dir,"*.java")) {
for (Path path : dirStream) {
format("%s%n", path.toAbsolutePath());
}
}

31. ListagemdeDiretório
DirectoryStream.Filter<Path> filter =
new DirectoryStream.Filter<Path>() {
public boolean accept(Path entry)
throws IOException {
return Files.size(entry) > 1024;
}
};
try (DirectoryStream<Path> dirStream =
Files.newDirectoryStream(dir,filter)) {
...
}

32. Percorrendoárvoresdediretórios
● Implementa o PadrãoVisitor para percorrer árvores de
diretórios
● Files.walkFileTree (start, fileVisitor)
 start: nó incial
 fileVisitor: define operaçõe que serão realizadas
● Travessia em profundidade

33. Percorrendoárvoresdediretórios
● Métodos callbacks de FileVisitor:
 preVisitDirectory
 visitFile
 postVisitDirectory
 visitFileFailed
● Enum FileVisitResult
 CONTINUE
 TERMINATE
 SKIP_SUBTREE
 SKIP_SIBLINGS

34. Percorrendoárvoresdediretórios
Path start = Paths.get("/foo/bar");
Files.walkFileTree(start, new SimpleFileVisitor<Path>(){
public FileVisitResult preVisitDirectory(Path dir,
BasicFileAttributes attrs) throws IOException {
format("preVisitDirectory: %s%n", dir);
return FileVisitResult.CONTINUE;
}
public FileVisitResult visitFile(Path file,
BasicFileAttributes attrs) throws IOException {
format("visitFile: %s%n", file);
return FileVisitResult.CONTINUE;
}
});

35. WatchService
● Monitora mudanças
 Criar, atualizar, excluir
● Usa notificações nativas

36. WatchService
WatchService watcher =
FileSystems.getDefault().newWatchService();
Path dir = …
WatchKey watchKey = dir.register(watcher,
ENTRY_MODIFY);

37. WatchService
boolean keepWatching = true;
while(keepWatching){
WatchKey key = watcher.poll(10,
TimeUnit.SECONDS);
for (WatchEvent<?> event: key.pollEvents()) {
if (event.kind() == ENTRY_MODIFY) {
Path name = (Path) event.context();
...
}
}
key.reset();
}

38. WatchService
PontosaobservarnoMundoReal
● Sub-diretórios não são monitorados
● Alguns editores criam um novo arquivo ao atualizar
 Esperamos uma ATUALIZAÇÃO, mas recebemos um
evento EXCLUIR + CRIAR
● Alguns sistemas de arquivos criam inicialmente um
arquivo com zero bytes
 Esperamos um evento de CRIAR, mas observamos um
CRIAR + ATUALIZAÇÃO

39. Sistemadearquivospersonalizado
● Permite a criação de sistemas de arquivos personalizados
 FileSystemProvider
● Sistema de arquivos em memória
● O Provedor de sistema de arquivo Zip é fornecido como
uma implementação de referência

40. Consideraçõesfinais
● NIO.2 funciona de forma consistente em todas as
plataformas
● Suporta novas operações
● Suporta o acesso em massa para atributos de arquivo
● Exceções melhores
● SPI para a interface de provedores de sistemas de
arquivos personalizados

41. OBRIGADO!!!