Praca z plikami w Javie

1 klasaFiles

Do pracy z plikami dostępna jest elegancka klasa narzędzi - java.nio.file.Files. Ma metody na każdą okazję. Wszystkie metody tej klasy są statyczne i operują na obiektach typu Path. Istnieje wiele metod, więc rozważymy tylko te główne:

Path createFile(Path path)

Path createDirectory(Path path)

Path createDirectories(Path path)

Path createTempFile(prefix, suffix)

Path createTempDirectory(prefix)

void delete(Path path)

Path copy(Path src, Path dest)

Path move(Path src, Path dest)

boolean isDirectory(Path path)

boolean isRegularFile(Path path)

boolean exists(Path path)

long size(Path path)

byte[] readAllBytes(Path path)

String readString(Path path)

List<String> readAllLines(Path path)

Path write(Path path, byte[])

Path writeString(Path path, String str)

DirectoryStream<Path> newDirectoryStream(Path dir)

2. Utwórz pliki i katalogi

Tworzenie plików i katalogów jest bardzo łatwe. Zobaczmy na przykładach:

Files.createFile(Path.of("c:\\readme.txt"));

Files.createDirectory(Path.of("c:\\test"));

Files.createDirectories(Path.of("c:\\test\\1\\2\\3"));

3. Kopiuj, przenieś i usuń

Kopiowanie, przenoszenie i usuwanie plików jest równie łatwe. Dotyczy to również katalogów, ale muszą być puste.

Path path1 = Path.of("c:\\readme.txt");
Path path2 = Path.of("c:\\readme-copy.txt");
Files.copy(path1, path2);

Path path1 = Path.of("c:\\readme.txt");
Path path2 = Path.of("d:\\readme-new.txt");
Files.move(path1, path2);

Path path = Path.of("d:\\readme-new.txt");
Files.delete(path);

4. Sprawdzanie typu i istnienia pliku

Gdy masz ścieżkę podaną z zewnątrz, chciałbyś wiedzieć, czy jest to plik, czy katalog. No ogólnie: czy taki plik/katalog istnieje czy nie?

W tym celu istnieją również specjalne metody. Możesz także łatwo sprawdzić długość pliku:

Files.isRegularFile(Path.of("c:\\readme.txt"));

true

Files.isDirectory(Path.of("c:\\test"));

true

Files.exists(Path.of("c:\\test\\1\\2\\3"));

false

Files.size(Path.of("c:\\readme.txt"));

10112

5. Praca z zawartością pliku

Wreszcie, istnieje cała seria metod, które ułatwiają odczytywanie lub zapisywanie zawartości pliku. Przykład:

Path path = Path.of("c:\\readme.txt");
List<String> list = Files.readAllLines(path);

for (String str : list)
   System.out.println(str);

6. Pobieranie zawartości katalogu

Pozostaje najciekawsza metoda - pobieranie plików i podkatalogów w danym katalogu.

Jest do tego specjalna metoda - newDirectoryStream(), która zwraca specjalny obiekt typu DirectoryStream<Path>. Ma iterator (!), a za pomocą tego iteratora możesz pobrać wszystkie pliki i podkatalogi danego katalogu.

Wygląda łatwiej niż wygląda:

Path path = Path.of("c:\\windows");

try (DirectoryStream<Path> files = Files.newDirectoryStream(path)) {
   for (Path path : files)
      System.out.println(path);
}

Obiekt DirectoryStream<Path>ma dwie właściwości. Po pierwsze, ma iterator, który zwraca ścieżki do plików i możemy użyć tego obiektu wewnątrz pliku for-each.

Po drugie, ten obiekt jest strumieniem danych i musi zostać zamknięty za pomocą metody close()lub użyty wewnątrz try-with-resources.

7. MetodaFiles.newInputStream

Od wersji Java 5 klasy FileInputStreamsą FileOutputStreamuważane za przestarzałe. Jedną z ich wad było to, że kiedy tworzony jest obiekt tych klas, pliki są natychmiast tworzone na dysku. I potencjalnie wszystkie błędy związane z tworzeniem pliku są wyrzucane.

Następnie uznano, że nie jest to najlepsze rozwiązanie. Dlatego do tworzenia obiektów plikowych zaleca się stosowanie metod klasy użytkowej - java.nio.Files.

Oto porównanie starego podejścia do tworzenia plików i nowego:

String src = "c:\\projects\\log.txt";
InputStream input = new FileInputStream( src );

String src = "c:\\projects\\log.txt";
InputStream input = Files.newInputStream( Path.of( src ) );

Podobnie zamiennik dla FileOutputStream:

String src = "c:\\projects\\log.txt";
OutputStream  output = new FileOutputStream( src );

String src = "c:\\projects\\log.txt";
OutputStream  output = Files.newOutputStream( Path.of( src ) );