Pular para o conteúdo principal

NIO.2 do Java 7: uma nova API do Java para file system

Uma das novidades mais importantes e aguardadas do Java 7 foi a NIO.2, a nova API para a manipulação I/O com Java. A NIO.2, também conhecida como JSR 203, disponibiliza um conjunto de novos componentes, projetados para melhorar caracterísiticas de I/O com Java como por exemplo: uma nova API para o acesso e manipulação de conteúdo do file system (sistema de arquivos); outra API para operações assíncronas com I/O; e a atualização da API para comunicação via sockets (channel sockets). 

O Java, antes da versão 7, tratava a manipulação do sistema de arquivos de forma primitiva. O programador tinha de trabalhar com a classe File para representar arquivos e/ou diretórios, com um número escasso de funcionalidades. Uma operação simples como copiar um arquivo demandava um código relativamente grande. Outras funcionalidades triviais, como por exemplo o uso de links simbólicos, não eram suportadas. Esses são alguns dos motivos para justificar o uso de bibliotecas terceiras, com funcionalidades complementares a API I/O do Java, durante o desenvolvimento de um sistema. 

API para o sistema de arquivos
No novo pacote java.nio.file estam contidos boa parte dos componentes da API para a manipulação do sistema de arquivos. Um dos pontos de partida para essa nova API é a interface Path. Ela representa o caminho hierárquico do file system de um diretório ou arquivo. Essa classe possui métodos para recuperar informações do caminho do arquivo, acessar outro elemento na estrutura hierárquica ou converter uma estrutura de diretórios.  

É possível criar um objeto Path de várias formas, uma dela é através da classe Paths (plural), uma classe helper com métodos estáticos especificos para a criação de objetos Path. O trecho de código a seguir demonstra como criar e utilizar objetos da classe Path, representando o caminho para o arquivo logo.png.
Path logo = Paths.get("/home/yaw/logo.png"); //passa o caminho completo
Path logo2 = Paths.get("/home", "yaw", "logo.png"); //outra forma

System.out.println(logo.equals(logo2));
System.out.format("%s é igual a %s? %b%n", logo, logo2, logo.equals(logo2));
System.out.format("Nome do arquivo: %s%n", logo.getFileName());
System.out.format("Qtde de elementos no path: %d%n", logo.getNameCount());
System.out.format("Volume: %s%n", logo.getRoot());
System.out.format("1o diretório: %s%n", logo.getName(0));
System.out.format("Pedaço do path (1o e 2o dir): %s%n", logo.subpath(0, 2));
System.out.format("Diretório do arquivo: %s%n", logo.getParent());
Outra opção seria criar o Path a partir do FileSystem. A classe abstrata FileSystem provê uma representação do sistema de arquivos, com funcionalidades para criar ou acessar elementos nessa estrutura. Mas para recuperar um objeto do tipo FileSystem, precisamos de outra classe helper: FileSystems (plural novamente) que atua como um fábrica desses objetos. A seguir o trecho de código com essa estratégia:
FileSystem fileSystem = FileSystems.getDefault(); //recupera o File System
Path logo3 = fileSystem.getPath("/home/yaw/logo.png"); //cria o Path
O método resolve é util para criar um Path a partir de outro Path, respeitando a hierarquia. Veja um exemplo:
Path home = Paths.get("/home/yaw"); //diretorio home
Path logo4 = home.resolve("logo.png"); //arquivo dentro do diretorio
System.out.format("Arquivo: %s%n", logo4.toAbsolutePath());

Backup com NIO.2
Já conhecemos os componentes que representam o sistema de arquivos e o path para um arquivo ou diretório. O próximo passo é manipular os arquivos! Para isso precisamos da classe Files, uma classe helper composta por métodos que operam sobre arquivos e/ou diretórios. A seguir o trecho de código que realiza a cópia de um arquivo:
Path home = Paths.get("/home/yaw");
Path txt = home.resolve("instrucoes.txt");
Path backup = home.resolve("instrucoes.txt.backup");

//caso exista, substitui
Files.copy(txt, backup, StandardCopyOption.REPLACE_EXISTING);
System.out.format("A cópia foi criada? %s%n", Files.exists(backup));
O método copy recebe o caminho do arquivo origem e destino para reliazar a cópia. Caso o arquivo de backup já exista ele será substítuido. Agora se o arquivo de origem não existir o método lança uma IOException. Repare que para trabalhar com os métodos da classe Files, devemos tratar IOException. Seguindo no exemplo do backup, o trecho de código a seguir move o arquivo cópia para outro diretório:
Path dirDestino = Paths.get("/home/yaw/backup");
if (Files.exists(backup)) {
    Files.move(backup, dirDestino.resolve(backup.getFileName()));
}
Nos dois últimos exemplos utilizo o método exists de Files, para verificar se o arquivo realmente existe no sistema de arquivos.

Links simbólicos
A partir do Java 7 é possível criar e utilizar links simbólicos com API de I/O, através da classe Files. O próximo trecho de código demonstra como criar um link para um determinado arquivo e como verificar se o arquivo é um link.
Path alvo = Paths.get("/home/yaw/inicializacao_v1.sh");
Path link = Paths.get("/home/yaw/scripts/inicializacao.sh");

//cria o link
Files.createSymbolicLink(link, alvo);

Path f = Paths.get("/home/yaw/scripts/inicializacao.sh");

//verifica se o path eh um link
if (Files.isSymbolicLink(f)) {
  System.out.format("'%s' é link de '%s'%n", f, Files.readSymbolicLink(f));
}
Listar o conteúdo do diretório
Outra vantangem dessa API são as várias opções para consultar o conteúdo de um diretório. É possível realizar consultas simples, com filtro na extensão do arquivo, e avançadas navegando recursivamente na estrutura de diretórios.

A interface DirectoryStream nos permite iterar nos elementos contidos dentro de um diretório. A classe Files fornece várias versões do método newDirectoryStream, uma delas utilizamos a seguir indicando o filtro pela extensão jpg:

Path dir = Paths.get("/home/yaw");
String filtro = "*.jpg";

DirectoryStream<Path> stream = Files.newDirectoryStream(dir, filtro);

//iterator com os elementos da pasta
for (Path p : stream) {
  System.out.println("\t" + p);
}
Com a interface SimpleFileVisitor, que implementa o pattern Visitor, é possível criar um mecanismo mais inteligente para percorrer o conteúdo de um diretório. O método walkFileTree, da classe Files, utiliza o SimpleFileVisitor aplicado um dado diretório. Veja um exemplo dessa estratégia nessa url.

Leitura e escrita de arquivos
Outra novidade são os métodos para leitura e escrita de arquivos compactos, pequenos. Esses métodos podem ser utilizados para escrever ou ler em formato binário (bytes) ou texto (string). Veja um exemplo que lê e escreve texto:
Path txt = Paths.get("/home/yaw/instrucoes.txt");
List<String> linhas = Files.readAllLines(txt, Charset.defaultCharset());
for (String l: linhas) {
  System.out.format("%s%n",l);
}

linhas.add("novo conteudo para o arquivo texto...");
Files.write(txt, linhas, Charset.defaultCharset());
O método readAllLines retorna uma lista com todas as linhas contidas no arquivo. Repare que não foi necessário escrever código para fechar o arquivo, isso quem faz é o próprio médodo. O mesmo aconcete com o método write, logo após escrever o conteúdo ele fecha o arquivo.

Propriedades
A interface BasicFileAttributes foi criada para resgatar atributos básicos de um arquivo dentro do sistema de arquivos. Veja um exemplo de como recuperar propriedades básicas de um arquivo/diretório:
BasicFileAttributes info = Files.readAttributes(txt, BasicFileAttributes.class);

System.out.format("Data de criação: %s%n", info.creationTime());
System.out.format("Último acesso: %s%n", info.lastAccessTime());
System.out.format("Última modificação: %s%n", info.lastModifiedTime());
System.out.format("É um diretorio: %s%n", info.isDirectory());
System.out.format("Tamanho: %s bytes%n", info.size());

O código demonstrado nesse post e outros exemplos estam disponíveis no github. fique a vontade para visualizar, copiar e modificar!

O Java 7 disponibiliza outros recursos, esses links complementam o aprendizado e as novidades da linguagem:

[]s
Eder Magalhães
www.yaw.com.br
twitter.com/youandwe
twitter.com/edermag

Comentários

André Valenti disse…
Muito bom o post! E muito boa a nova API também. Gostei principalmente da nova maneira de ler linhas de e escrever linhas em arquivo. Ficou quase tão compacto quanto Python!
Yara Senger disse…
Ótimo post! Valeu!
markblog disse…
Muy buen aporte!!

Postagens mais visitadas deste blog

2º Bate Papo do SP-GTUG - Divulgação

Pessoal, Para aqueles que já estiveram presentes nas atividades do SP-GTUG (encontros ou bate papos na Globalcode), e para os que ainda não puderam estar presentes, teremos um novo bate papo acerca de mais duas tecnologias do Google: AdSense e Python no GAE. Este será o nosso segundo bate papo do SP-GTUG, nos mesmos moldes dos minicursos da Globalcode . Local e data O bate papo acontecerá no dia 27/03/10, das 10:00 às 13:00 na Globalcode. Para fazer sua inscrição e participar acesse a home da Globalcode e vá até a parte de "Minicursos Gratuitos da Semana ". Conteúdo das apresentações Abaixo seguem as descrições passadas pelos palestrantes: Título: "Algoritmos em Python" Resumo: Python é uma linguagem considerada frugal, simples, sem ser simplória! Entenda como construir algoritmos ninjas com essa linguagem, adotada pela Google e pelo MIT. Veremos muito, muito código, desde algoritmos clássicos até tutoriais do

10 reasons why we love JSF

1. One-slide technology: it's so simple that I can explain basic JSF with one slide. 2. Easy to extend: components, listeners, render kit, Events, Controller, etc. 3. Real-world adoption: JBoss, Exadel, Oracle, IBM, ... 4. Architecture model: you can choose between more than 100 different architecture. 5. Open-mind community: using JSF you are going to meet very interesting people. 6. We are using JSF the last 5 years and we found very good market for JSF in Brazil 7. Progress: look to JSf 1.1 to JSF 1.2, JSF 1.2 to JSF 2.0. People are working really hard! 8. Many professionals now available 9. It's a standard. It's JCP. Before complain, report and help! 10. Ed Burns, spec leader, is an old Globalcode community friend! EXTRA: My wife is specialist in JSF. She's my F1 for JSF :) Nice job JSF community! -Vinicius Senger

JSF 2 - Composite Components, você não precisa mais ser um ninja

Estamos em uma nova era da computação, os dados não estão mais localizados em um banco dentro de sua empresa, vivemos a explosão de redes sociais, informações são geradas a todo instante, e se torna essencial que sua aplicação conheça os serviços disponíveis na web e consumam suas APIs geralmente disponíveis por serviços REST. Legal, mas como ficam meus aplicativos Java EE neste novo cenário? Para quem vem acompanhando a evolução da plataforma, é notório que todo esforço vem sendo utilizado para aumentar a produtividade e a integração com novos serviços. Basicamente duas especificações surgem com muita força para atender este cenário, a JSR - 314 (JSF-2) e JSR - 311 (JAX-RS), neste post exploraremos a JSR-314 (JSF2) e sua nova forma de criar Composite Components. Uma das grandes queixas dos desenvolvedores JSF era a complexidade em criar composite components, era necessário um vasto conhecimento sobre o ciclo de vida de uma aplicação JSF. Agora, você não precisa ser mais um “ninja” em

Gosta de informática e sonha ser programador Java um dia ?

A Globalcode está procurando jovens que queiram ser programadores no futuro, para fazer parte de sua equipe de vendas e operacional na unidade Paraíso em São Paulo somente. O grande diferencial é o planejamento para carreira de programador. O planejamento de cursos do portifólio da Globalcode: Academia do Programador, Academia Java, Academia Web, Robótica, Eletrônica, etc, será realizado periodicamente de acordo com o desempenho e interesse individual. Atenção : Este não é um estágio para trabalhar com Java, são duas vagas CLT administrativas para pessoas que queiram ser programadores no futuro. Perfil : Conhecimentos de informática básica, saber lidar com pessoas e trabalhar em equipe. Deve ter concluído o ensino médio, ter boa escrita, ser organizado, responsável, comprometido e dinâmico. Interesse por computação, programação, internet, robótica, eletrônica,... Temos duas vagas para jovem-aprendiz abertas: 1) Setor operacional No dia a dia Serviços externos Controle de estoqu

JavaMail: Enviando mensagem HTML com anexos

Introdução Depois do post "JavaMail: Enviando e-mail com Java" , que apresentava como enviar um e-mail com Java, resolvi complementar a assunto apresentando como enviar uma mensagem formatada, em HTML , e também como realizar o envio de anexos. Bibliotecas Além da biblioteca JavaMail, veja mais no post anterior , é necessário incluir o JavaBeans Activation Framework (JAF), apenas se a versão utilizada for anterior ao JSE 6.0 , que já tem o JAF incluso. O JAF está disponível em http://www.oracle.com/technetwork/java/javase/downloads/index-135046.html , e neste download encontramos, alguns exemplos na pasta demo , documentação, incluindo javadocs, na pasta docs e a biblioteca activation.jar , que deve ser acrescentada no classpath da aplicação para versões anteriores ao JSE 6.0. Exemplo Primeiramente devemos realizar a configuração da javax.mail.Session e da javax.mail.internet.MimeMessage , estes passos podem ser vistos no post anterior . Agora vamos montar um

TDC INNOVATION lança University Pass

Modalidade de ingresso tem como objetivo ajudar na capacitação dos universitários Uma pesquisa realizada em 2020 pela Associação Brasileira das Empresas de Tecnologia da Informação e Comunicação (Brasscom) diz que até o ano de 2024 o Brasil precisará de cerca de 420 mil profissionais na área de Tecnologia da Informação. Porém, por ano, a mesma pesquisa diz que o país forma apenas 46 mil profissionais capacitados no nicho. Pensando nisso, para ajudar na formação e capacitação desses jovens profissionais, o TDC INNOVATION, segunda edição do ano do The Developer's Conference, lança o University Pass, modalidade de ingresso que possibilita aceso digital gratuito a todas as palestras do evento, ou com 50% de desconto para quem preferir ir pessoalmente. Com o tema central “Desafios para a criação do futuro Digital”, o TDC INNOVATION ocorrerá entre 1 e 3 de junho, de forma híbrida: presencialmente no Centro de Convenções CentroSul, em Florianópolis, e com transmissão simultaneamente pela