Introdução
Commons IO é uma biblioteca de utilitários para auxiliar no desenvolvimento da funcionalidade IO em Java. Ele fornece várias classes de utilitários para operações comuns para File IO, cobrindo uma ampla gama de casos de uso. Isso ajuda a evitar escrever código clichê. Ele também fornece várias implementações de Comparador para Arquivos.
commons io 2.4 jar download
Algumas das principais caracterÃsticas do Commons IO são:
IOUtils: uma classe que contém métodos utilitários para trabalhar com fluxos, leitores, gravadores e arquivos.
FileUtils: Uma classe que contém métodos utilitários para trabalhar com objetos File, como abrir, ler, gravar, copiar e mover arquivos.
FilenameUtils: Uma classe que contém métodos utilitários para trabalhar com nomes de arquivos sem usar objetos File. Ele fornece uma maneira independente do sistema operacional de executar funções comuns em nomes de arquivo.
FileSystemUtils: Uma classe que contém métodos utilitários para trabalhar com o sistema de arquivos, como obter o espaço livre em uma unidade.
TeeInputStream e TeeOutputStream: Classes que permitem gravar um único fluxo de entrada em dois fluxos de saÃda diferentes ou ler de dois fluxos de entrada diferentes em um único fluxo de saÃda.
Filtros de arquivo e comparadores de arquivo: interfaces e classes que fornecem vários critérios para filtrar e classificar arquivos.
Neste artigo, veremos como baixar e instalar o Commons IO 2.4 e como usar alguns de seus recursos mais úteis. Também iremos compará-lo com algumas alternativas e explicar os benefÃcios de usar o Commons IO.
Download e instalação
Para usar o Commons IO 2.4, precisamos baixar o arquivo jar do site oficial ou de um site espelho. Também podemos usar Maven ou Gradle para gerenciar a dependência.
Depois de baixar o arquivo jar, precisamos adicioná-lo ao classpath do nosso projeto. Isso pode ser feito adicionando o arquivo jar à pasta lib do nosso projeto ou configurando a ferramenta de compilação ou IDE para incluÃ-lo.
Por exemplo, se estivermos usando Maven, podemos adicionar a seguinte dependência ao nosso arquivo pom.xml:
<dependency> <groupId>commons-io</groupId> <artifactId>commons-io</artifactId> <version>2.4</version> </dependency>
Se estivermos usando Gradle, podemos adicionar a seguinte dependência ao nosso arquivo build.gradle:
dependencies implementação 'commons-io:commons-io:2.4'
Classes utilitárias
O Commons IO fornece várias classes de utilitários que podem nos ajudar a executar tarefas comuns em arquivos. Nesta seção, veremos como usar alguns deles com exemplos.
IOUtils
IOUtils contém métodos utilitários para trabalhar com fluxos, leitores, gravadores e arquivos. Esses métodos podem economizar muito tempo e código, simplificando operações comuns, como leitura, gravação, cópia e fechamento de recursos.
Por exemplo, suponha que queremos ler bytes de uma URL e imprimi-los. Podemos fazer isso com IOUtils da seguinte maneira:
InputStream in = new URL(" tente System.out.println(IOUtils.toString(in)); finalmente IOUtils.closeQuietly(in);
Esse código é muito mais curto e simples do que usar as classes Java padrão, como InputStreamReader, BufferedReader, etc. Ele também fecha o fluxo silenciosamente em caso de exceção.
FileUtils
FileUtils contém métodos utilitários para trabalhar com objetos File. Esses métodos podem nos ajudar a realizar várias operações em arquivos, como abrir, ler, escrever, copiar, mover, excluir e comparar arquivos. Eles também podem lidar com exceções e fechar recursos automaticamente.
Por exemplo, suponha que queremos copiar um arquivo de um local para outro. Podemos fazer isso com FileUtils da seguinte maneira:
Origem do arquivo = new File("C:\Usuários\usuário\Documentos\fonte.txt"); File dest = new File("C:\Users\user\Documents\dest.txt"); FileUtils.copyFile(origem, destino);
Esse código é muito mais fácil e seguro do que usar as classes Java padrão, como FileInputStream, FileOutputStream, etc. Ele também manipula qualquer IOException que possa ocorrer durante a operação de cópia.
FilenameUtils
FilenameUtils contém métodos utilitários para trabalhar com nomes de arquivos sem usar objetos File. Esses métodos podem nos ajudar a manipular e extrair informações de nomes de arquivos de maneira independente de plataforma. Eles também podem lidar com vários formatos e extensões de arquivo.
Por exemplo, suponha que queremos obter o nome base e a extensão de um nome de arquivo. Podemos fazer isso com FilenameUtils da seguinte maneira:
String filename = "C:\Usuários\usuário\Documentos\relatório.pdf"; String basename = FilenameUtils.getBaseName(filename); // retorna "relatório" String extension = FilenameUtils.getExtension(filename); // retorna "pdf"
Este código funciona independentemente do sistema operacional ou do separador de arquivo usado. Ele também lida com qualquer ponto ou barra no nome do arquivo.
FileSystemUtils
FileSystemUtils contém métodos utilitários para trabalhar com o sistema de arquivos. Esses métodos podem nos ajudar a obter informações sobre o sistema de arquivos, como o espaço livre em uma unidade ou partição.
Por exemplo, suponha que queremos obter o espaço livre na unidade C em bytes. Podemos fazer isso com FileSystemUtils da seguinte maneira:
long freeSpace = FileSystemUtils.freeSpaceKb("C:"); // retorna o espaço livre em kilobytes freeSpace = freeSpace * 1024; // converte para bytes
Este código funciona em sistemas Windows, Linux e Unix. Ele também lida com qualquer exceção que possa ocorrer durante a operação.
Entrada e saÃda
O Commons IO também fornece classes que podem nos ajudar a trabalhar com fluxos de entrada e saÃda de maneira mais flexÃvel. Nesta seção, veremos como usar dois deles: TeeInputStream e TeeOutputStream.
TeeInputStream
TeeInputStream é uma classe que permite gravar um único fluxo de entrada em dois fluxos de saÃda diferentes. Isso pode ser útil para fins de registro, depuração ou monitoramento.
Por exemplo, suponha que queremos ler bytes de uma URL e gravá-los em um arquivo e no console. Podemos fazer isso com TeeInputStream da seguinte maneira:
InputStream in = new URL(" OutputStream out1 = new FileOutputStream("C:\Users\user\Documents\output.txt"); OutputStream out2 = System.out; TeeInputStream tee = new TeeInputStream(entrada, saÃda1); tente IOUtils.copy(tee, out2); finalmente IOUtils.closeQuietly(tee); IOUtils.closeQuietly(out1);
Esse código lê bytes da URL e os grava no arquivo e no console simultaneamente. Também fecha todos os fluxos silenciosamente em caso de qualquer exceção.
TeeOutputStream
TeeOutputStream é uma classe que permite a leitura de dois fluxos de entrada diferentes em um único fluxo de saÃda. Isso pode ser útil para mesclar, combinar ou concatenar dados de diferentes fontes.
Por exemplo, suponha que queremos ler bytes de dois arquivos e escrevê-los em um único arquivo. Podemos fazer isso com TeeOutputStream da seguinte maneira:
InputStream in1 = new FileInputStream("C:\Users\user\Documents\input1.txt"); InputStream in2 = new FileInputStream("C:\Users\user\Documents\input2.txt"); OutputStream out = new FileOutputStream("C:\Users\user\Documents\output.txt"); TeeOutputStream tee = new TeeOutputStream(saÃda, entrada1); tente IOUtils.copy(in2, tee); finalmente IOUtils.closeQuietly(tee); IOUtils.closeQuietly(in1); IOUtils.closeQuietly(in2);
Esse código lê bytes de ambos os arquivos de entrada e os grava no arquivo de saÃda sequencialmente. Também fecha todos os fluxos silenciosamente em caso de qualquer exceção.
Filtros
O Commons IO também fornece interfaces e classes que podem nos ajudar a filtrar e classificar arquivos com base em vários critérios. Nesta seção, veremos como usar alguns deles: filtros de arquivos e comparadores de arquivos.
Filtros de arquivo
Os filtros de arquivo são interfaces e classes que fornecem vários critérios para filtrar arquivos. Eles podem ser usados para selecionar arquivos com base em seu nome, tamanho, data, tipo ou conteúdo. Eles também podem ser combinados com operadores lógicos como AND, OR e NOT.
Por exemplo, suponha que queremos listar todos os arquivos em um diretório que tenham a extensão .txt e sejam maiores que 1 KB. Podemos fazer isso com filtros de arquivo da seguinte maneira:
File dir = new File("C:\Usuários\usuário\Documentos"); filtro FileFilter = new AndFileFilter( new SuffixFileFilter(".txt"), new SizeFileFilter(1024, false) ); Arquivo[] arquivos = dir.listFiles(filtro); for (File file : files) System.out.println(file.getName());
Esse código usa o AndFileFilter para combinar dois outros filtros: o SuffixFileFilter que corresponde a arquivos com o sufixo fornecido e o SizeFileFilter que corresponde a arquivos com o intervalo de tamanho especificado. Em seguida, ele lista os arquivos que correspondem a ambos os critérios.
Comparadores de arquivo
Comparadores de arquivos são interfaces e classes que fornecem vários critérios para classificar arquivos. Eles podem ser usados para ordenar arquivos com base em seu nome, tamanho, data, tipo ou conteúdo. Eles também podem ser revertidos ou encadeados com outros comparadores.
Por exemplo, suponha que queremos classificar os arquivos em um diretório por nome em ordem crescente e, em seguida, por tamanho em ordem decrescente. Podemos fazer isso com comparadores de arquivos da seguinte maneira:
File dir = new File("C:\Usuários\usuário\Documentos"); Comparador comparador = new CompositeFileComparator( new NameFileComparator(), new ReverseComparator(new SizeFileComparator()) ); Arquivo[] arquivos = dir.listFiles(); Arrays.sort(arquivos, comparador); for (File file : files) System.out.println(file.getName() + " (" + file.length() + " bytes)");
Esse código usa o CompositeFileComparator para encadear dois outros comparadores: o NameFileComparator que compara os arquivos pelo nome e o ReverseComparator que inverte a ordem de outro comparador. Nesse caso, inverte o SizeFileComparator que compara os arquivos pelo tamanho. Em seguida, ele classifica os arquivos usando os dois critérios.
Conclusão
Neste artigo, vimos como usar o Commons IO 2.4, uma biblioteca de utilitários para desenvolver a funcionalidade IO em Java.Vimos como baixar e instalar a biblioteca e como usar alguns de seus recursos mais úteis. Também comparamos com algumas alternativas e explicamos os benefÃcios de usar o Commons IO.
O Commons IO pode nos ajudar a simplificar e melhorar nosso código, fornecendo várias classes de utilitários para operações comuns em arquivos. Também pode nos ajudar a trabalhar com fluxos de entrada e saÃda de maneira mais flexÃvel. Também pode nos ajudar a filtrar e classificar arquivos com base em vários critérios.
Recomendamos o uso do Commons IO sempre que precisarmos lidar com a funcionalidade IO em Java. Isso pode nos poupar muito tempo e esforço e tornar nosso código mais legÃvel e confiável.
perguntas frequentes
Aqui estão algumas perguntas frequentes sobre Commons IO:
P: Quais são as vantagens de usar Commons IO sobre classes Java padrão?
R: Algumas das vantagens são:
O Commons IO fornece mais funcionalidade e recursos do que as classes Java padrão.
O Commons IO lida com exceções e fecha recursos automaticamente.
O Commons IO é independente de plataforma e oferece suporte a vários formatos e extensões de arquivo.
Commons IO é bem testado e amplamente utilizado por muitos projetos.
P: Quais são algumas alternativas ao Commons IO?
R: Algumas alternativas são:
NIO: Um pacote que fornece operações de entrada e saÃda sem bloqueio para Java. Ele suporta canais, buffers, seletores e operações assÃncronas.
Guava: Uma biblioteca que fornece vários utilitários para Java, incluindo alguns para funcionalidade IO.
Jakarta Commons Lang: Uma biblioteca que fornece vários utilitários para Java, incluindo alguns para manipulação e validação de strings.
P: Como posso contribuir para o Commons IO?
R: Você pode contribuir com o Commons IO relatando bugs, sugerindo melhorias, enviando patches, escrevendo documentação ou ingressando na lista de discussão. Você pode encontrar mais informações sobre como contribuir no site oficial.
P: Como posso saber mais sobre o Commons IO?
R: Você pode aprender mais sobre o Commons IO lendo a documentação oficial, navegando no código-fonte[^5^ ] ou seguindo os tutoriais e exemplos online.
P: Onde posso obter suporte para Commons IO?
R: Você pode obter suporte para Commons IO ingressando na lista de discussão do usuário, postando perguntas no Stack Overflow ou entrando em contato diretamente com os desenvolvedores. Você pode encontrar mais informações sobre como obter suporte no site oficial. 0517a86e26