Baseado nos cursos da Softblue

NIO.2 API x Legacy I/O API

O Java conta com uma API de I/O desde a sua primeira versão

– Esta API tem algumas limitações

A New I/O (NIO.2) API surgiu para resolver os problemas que a API legada possui
A NIO.2 API surgiu com o Java 7
A tendência é que ela substitua a API de I/O legada gradualmente

A interface Path

O sistema de arquivos define caminhos para diretórios e arquivos
Windows

C:\Users\Me\MyFile.txt

Unix

/home/me/Myfile.txt

Um objeto Path representa um caminho

– Pode ser de um arquivo ou diretório

– O arquivo ou diretório não precisam necessariamente existir

Manipulando objetos Path

A classe Paths possui métodos estáticos, que permitem manipular objetos Path

  
Path p = Paths.get("C:\\Users\\Me\\MyFile.txt");//Cria um objeto Path com base no caminho especificado

Path p = Paths.get("C:", "Users", "Me", "MyFile.txt");//Cria um objeto Path juntando partes do caminho

É comum haver situações onde dois ou mais objetos Path precisam ser juntados para gerar um Path completo

  
Path dir = Paths.get("/home/me");
Path file = Paths.get("MyFile.txt");
Path path = dir.resolve(file);
Path path = dir.resolve("MyFile.txt"); ///home/me/MyFile.txt

Métodos úteis da classe Paths

  
Path p = Paths.get("C:\\Users\\Me\\MyFile.txt");

Método	Retorno
p.toString()	“C:\Users\Me\MyFile.txt”
p.getFileName()	“MyFile.txt”
p.getParent()	“C:\Users\Me”
p.getNameCount()	3
p.getName(1)	“Me”
p.subPath(0, 2)	“Users\Me”
p.getRoot()	“C:"

  
Path p = Paths.get("files\MyFile.txt");

Método	Retorno
p.toAbsolutePath()	“C:\DiretorioCorrente\files\MyFile.txt”

A classe Files

Possui métodos estáticos que permitem manipular arquivos

  
Path path = Paths.get("/home/me/MyFile.txt")
boolean exists = Files.exists(path);//Verifica se o arquivo ou diretório existe

Outros métodos de Files

Método	Descrição
isReadable(path)	Permite leitura?
isWritable(path)	Permite escrita?
isExecutable(path)	Pode ser executado?
isDirectory(path)	É um diretório?
isHidden(path)	Está oculto?
size()	Retorna o tamanho em bytes

Operações em arquivos e diretórios

Excluir

  
Files.delete(path);
Files.deleteIfExists(path);

Copiar

  
Files.copy(sourcePath, targetPath);
Files.copy(sourcePath, targetPath, StandardCopyOption.REPLACE_EXISTING);

Mover

  
Files.move(sourcePath, targetPath);
Files.move(sourcePath, targetPath, StandardCopyOption.REPLACE_EXISTING);

Lendo e escrevendo dados

  
InputStream in = Files.newInputStream(path);//Arquivos binários
BufferedReader reader = Files.newBufferedReader(path);//Arquivos texto

InputStream e BufferedReadersão classes que fazem parte da API legada de I/O

  
byte[] bytes = Files.readAllBytes(path);
List<String> lines = Files.readAllLines(path);
//Recomendados para arquivos menores

  
OutputStream out = Files.newOutputStream(path);//Arquivos binários
BufferedWriter writer = Files.newBufferedWriter(path);//Arquivos texto

OutputStream e BufferedWriter são classes que fazem parte da API legada de I/O

  
Files.write(path, bytes);
Files.write(path, lines);
//Recomendados para arquivos menores

O enum `StandardOpenOptions`

Várias operações de manipulação de arquivos e diretórios solicitam parâmetros que definem o comportamento destas operações

Elemento do enum	Descrição
WRITE	Arquivo para escrita.
APPEND	Faz append de dados.
TRUNCATE_EXISTING	Faz o truncamento do arquivo.
CREATE_NEW	Cria um novo arquivo. Se ele existir, lança exceção.
CREATE	Se o arquivo existir, abre. Se não existir, cria.
DELETE_ON_CLOSE	Exclui o arquivo quando a stream é fechada.

Criando arquivos

Arquivos regulares

  
Path file = Files.createFile(path);

Arquivos temporários

  
Path file = Files.createTempFile("files_", ".temp");
//C:\Users\Me\AppData\Local\Temp\files_1365648452074156411.temp

Criando diretórios

Diretórios regulares

  
Path dir = Files.createDirectory(path);
Path dir = Files.createDirectories(path);//Cria vários níveis de diretórios

Diretórios temporários

  
Path dir = Files.createTempDirectory("temp_");
//C:\Users\Me\AppData\Local\Temp\temp_6589015846917767979

Conteúdo de um diretório

A interface DirectoryStream permite iterar sobre o conteúdo de um diretório

  
try (DirectoryStream<Path> stream = Files.newDirectoryStream(dir)) {
    for (Path path : stream) {
        //...
    }
}

É possível filtrar por padrões no nome

  
try (DirectoryStream<Path> stream = Files.newDirectoryStream(dir, "*.txt") {//Glob
    for (Path path : stream) {
        //...
    }
}

Para saber mais sobre o glob, consulte o javadoc de FileSystem.getPathMatcher()

Criando filtros de conteúdos

Nem sempre o uso do glob atende às necessidades de filtragem

– Ele se baseia apenas em padrões de nome

Nestes casos é preciso implementar um filtro customizado

  
DirectoryStream.Filter<Path> filter =file -> Files.isDirectory(file);// Expressão lambda para o método accept()
DirectoryStream<Path> s = Files.newDirectoryStream(dir, filter)) {

Iterando sobre a árvore de diretórios

A interface FileVisitor possui 4 métodos que devem ser implementados

– preVisitDirectory()

– postVisitDirectory()

– visitFile()

– visitFileFailed()

É possível também estender a classe SimpleFileVisitor
O método Files.walkFileTree() é chamado para iniciar a iteração

Watch Service API

Permite que a aplicação seja notificada quando um diretório ou arquivo é criado, excluído ou modificado

  
WatchService watcher = FileSystems.getDefault().newWatchService();
WatchKey key = dir.register(watcher,ENTRY_CREATE, ENTRY_DELETE, ENTRY_MODIFY);

Deve existir um loop na aplicação que fica recebendo os eventos

Integrando NIO.2 com a Legacy I/O API

Aplicações antigas (anteriores ao Java 7) não tiveram acesso à NIO.2 API
Para que estas aplicações não precisem ser reescritas, existe uma forma de integrar a API legada de I/O com a NIO.2 API

  
Path path = file.toPath();
File file = path.toFile();

I/O com a NIO.2 API em Java