CodeGym /Kursy /JAVA 25 SELF /Klasy File, Path, Files: przegląd, tworzenie obiektów

Klasy File, Path, Files: przegląd, tworzenie obiektów

JAVA 25 SELF
Poziom 35, Lekcja 1
Dostępny

1. Klasa File: jak to się zaczęło

Mimo że uzgodniliśmy, iż klasy File lepiej nie używać w nowych projektach, wciąż istnieje wiele systemów legacy, w których jest ona stosowana. Dlatego warto ją rozumieć i umieć z nią pracować. Klasa File to stary sposób reprezentowania pliku lub katalogu na dysku. Ale uwaga: obiekt File to nie sam plik, a jedynie „wskaźnik”/opis ścieżki. Na przykład wyrażenie File f = new File("hello.txt"); nie tworzy pliku na dysku — po prostu opisałeś ścieżkę.

Jak utworzyć obiekt File?

import java.io.File;

public class FileDemo {
    public static void main(String[] args) {
        File file = new File("example.txt"); // ścieżka względna
        File folder = new File("mydir");     // katalog

        System.out.println("Ścieżka bezwzględna: " + file.getAbsolutePath());
        System.out.println("Czy plik istnieje? " + file.exists());
        System.out.println("Czy to plik? " + file.isFile());
        System.out.println("Czy to katalog? " + folder.isDirectory());
    }
}

Co warto zapamiętać:
Utworzenie obiektu File nie tworzy pliku na dysku. To tylko „skrót”. Aby plik faktycznie powstał, trzeba jawnie zainicjować utworzenie (np. zapisać dane lub wywołać file.createNewFile()).

Podstawowe metody klasy File

  • exists() — sprawdza, czy plik/katalog istnieje.
  • isFile() — czy to plik (a nie folder)?
  • isDirectory() — czy to katalog?
  • getAbsolutePath() — pobiera ścieżkę bezwzględną.
  • length() — rozmiar pliku w bajtach.
  • getName() — nazwa pliku lub folderu.
  • delete() — usuwa plik/katalog (jeśli pusty).

Przykład: wypisujemy informacje o pliku

File file = new File("example.txt");
System.out.println("Nazwa: " + file.getName());
System.out.println("Ścieżka: " + file.getAbsolutePath());
System.out.println("Rozmiar: " + file.length() + " bajtów");
System.out.println("Istnieje? " + file.exists());

2. Klasa Path: nowoczesne podejście do plików

Path — część nowego plikowego API (NIO.2, od Javy 7). To abstrakcja ścieżki do pliku/katalogu; ścieżka może wskazywać nie tylko dysk lokalny, lecz także np. wnętrze archiwum ZIP albo zasób zdalny (przy dostępności odpowiedniego providera).

Jeśli File to stara papierowa mapa, to Path to nawigacja GPS.

Jak utworzyć obiekt Path?

import java.nio.file.Path;
import java.nio.file.Paths;

public class PathDemo {
    public static void main(String[] args) {
        Path path1 = Paths.get("example.txt"); // ścieżka względna
        Path path2 = Paths.get("folder", "file.txt"); // łączymy części ścieżki

        System.out.println("Ścieżka 1: " + path1.toAbsolutePath());
        System.out.println("Ścieżka 2: " + path2.toAbsolutePath());
    }
}

Plus: nie musisz martwić się o separatory. Paths.get dopasuje właściwy format do twojej OS.

Konwersja między File i Path

  • File → Path: file.toPath()
  • Path → File: path.toFile()
File file = new File("test.txt");
Path path = file.toPath();

Path anotherPath = Paths.get("data.txt");
File anotherFile = anotherPath.toFile();

Praca ze ścieżkami: resolve, relativize, normalize

Łączenie ścieżek (resolve)

Path dir = Paths.get("myfolder");
Path file = dir.resolve("notes.txt"); // myfolder/notes.txt
System.out.println(file); // myfolder/notes.txt

Ścieżka względna (relativize)

Path pathA = Paths.get("folderA/file1.txt");
Path pathB = Paths.get("folderA/subfolder/file2.txt");
Path relative = pathA.relativize(pathB);
System.out.println(relative); // ../subfolder/file2.txt

Normalizacja ścieżki (normalize)

Path messy = Paths.get("folder/../folder/file.txt");
Path clean = messy.normalize();
System.out.println(clean); // folder/file.txt

Przykład: budujemy ścieżkę do pliku

Path home = Paths.get(System.getProperty("user.home"));
Path docs = home.resolve("Documents");
Path myFile = docs.resolve("myfile.txt");
System.out.println("Ścieżka do pliku: " + myFile.toAbsolutePath());

3. Klasa Files: twój szwajcarski scyzoryk

Klasa Files z pakietu java.nio.file — narzędziowy zestaw statycznych metod do pracy z plikami i katalogami na bazie Path. Potrafi praktycznie wszystko: sprawdzać istnienie, tworzyć/usuwać, czytać/zapisywać, kopiować/przenosić, pobierać atrybuty i przechodzić po drzewie katalogów.

Podstawowe metody klasy Files

  • Files.exists(path) — sprawdza, czy plik/katalog istnieje.
  • Files.isDirectory(path) — czy to katalog?
  • Files.size(path) — rozmiar pliku.
  • Files.createFile(path) — tworzy plik.
  • Files.createDirectory(path) — tworzy katalog.
  • Files.delete(path) — usuwa plik/katalog.
  • Files.copy(src, dest) — kopiuje plik.
  • Files.move(src, dest) — przenosi/zmienia nazwę.
  • Files.getLastModifiedTime(path) — czas ostatniej modyfikacji.
  • Files.readAllBytes(path) — czyta cały plik do tablicy bajtów.
  • Files.readAllLines(path) — czyta wszystkie wiersze pliku tekstowego.
  • Files.write(path, bytes) — zapisuje bajty do pliku.

Przykład: sprawdzamy plik

import java.nio.file.*;

public class FilesDemo {
    public static void main(String[] args) {
        Path path = Paths.get("example.txt");

        System.out.println("Czy plik istnieje? " + Files.exists(path));
        System.out.println("Czy to katalog? " + Files.isDirectory(path));

        if (Files.exists(path)) {
            try {
                System.out.println("Rozmiar pliku: " + Files.size(path) + " bajtów");
            } catch (Exception e) {
                System.out.println("Błąd podczas pobierania rozmiaru: " + e.getMessage());
            }
        }
    }
}

4. Praktyka: tworzymy obiekty, wypisujemy właściwości

Tworzymy obiekty dla pliku i katalogu

import java.io.File;
import java.nio.file.Path;
import java.nio.file.Paths;

public class CompareDemo {
    public static void main(String[] args) {
        // Stary sposób
        File oldFile = new File("test.txt");
        File oldDir = new File("mydir");

        // Nowy sposób
        Path newFile = Paths.get("test.txt");
        Path newDir = Paths.get("mydir");

        System.out.println("=== File API ===");
        System.out.println("Plik: " + oldFile.getAbsolutePath());
        System.out.println("Istnieje? " + oldFile.exists());
        System.out.println("Czy to plik? " + oldFile.isFile());
        System.out.println("Czy to katalog? " + oldDir.isDirectory());

        System.out.println("\n=== Path API ===");
        System.out.println("Plik: " + newFile.toAbsolutePath());
        System.out.println("Istnieje? " + java.nio.file.Files.exists(newFile));
        System.out.println("Czy to plik? " + java.nio.file.Files.isRegularFile(newFile));
        System.out.println("Czy to katalog? " + java.nio.file.Files.isDirectory(newDir));
    }
}

Wypisujemy właściwości pliku

import java.nio.file.*;

public class FileProperties {
    public static void main(String[] args) {
        Path path = Paths.get("test.txt");

        System.out.println("Ścieżka bezwzględna: " + path.toAbsolutePath());
        System.out.println("Nazwa pliku: " + path.getFileName());
        System.out.println("Folder nadrzędny: " + path.getParent());

        if (Files.exists(path)) {
            try {
                System.out.println("Rozmiar: " + Files.size(path) + " bajtów");
                System.out.println("Ostatnia modyfikacja: " + Files.getLastModifiedTime(path));
            } catch (Exception e) {
                System.out.println("Błąd podczas pobierania informacji: " + e.getMessage());
            }
        } else {
            System.out.println("Plik nie znaleziony.");
        }
    }
}

5. Porównanie: File vs Path/Files

Możliwość File (java.io) Path + Files (java.nio.file)
Reprezentacja ścieżki Tylko dysk lokalny Dysk lokalny, ZIP, zasoby sieciowe
Łączenie ścieżek Ręczne łączenie przez ukośniki Wygodnie przez resolve
Sprawdzanie istnienia exists() Files.exists(path)
Odczyt/zapis zawartości Nie Tak (Files.readAll..., Files.write)
Pobieranie atrybutów Podstawowe (length(), lastModified()) Rozszerzone atrybuty i reprezentacje
Zgodność Ze wszystkimi wersjami Javy Java 7 i nowsze
Obsługa dowiązań symbolicznych Ograniczona Pełna obsługa

W skrócie: kiedy czego używać?

  • Do nowych projektów — używaj Path i Files.
  • Do utrzymania starego kodu — czasem trzeba będzie pracować z File.

6. Przydatne niuanse

Ścieżki względne i bezwzględne

Ścieżka względna — to ścieżka względem bieżącego katalogu roboczego; bezwzględna — to pełna ścieżka od korzenia systemu plików.

Path relative = Paths.get("data", "file.txt");
Path absolute = relative.toAbsolutePath();
System.out.println("Ścieżka bezwzględna: " + absolute);

Wieloplatformowość

Path i Files uwzględniają cechy OS (separatory, kodowania itp.). Nie wpisuj ścieżek ręcznie w rodzaju "C:\\folder\\file.txt" — używaj Paths.get i resolve.

Konwersja między File i Path

Jeśli masz stary kod oparty na File, łatwo przejść na nowe API:

File legacy = new File("legacy.txt");
Path modern = legacy.toPath();
if (Files.exists(modern)) {
    // Teraz można używać wszystkich możliwości NIO.2
}

Sprawdzanie istnienia pliku

Path path = Paths.get("notes.txt");
if (Files.exists(path)) {
    System.out.println("Plik znaleziony!");
} else {
    System.out.println("Plik nie istnieje.");
}

7. Mini‑praktyka: tworzymy i sprawdzamy plik i katalog

import java.nio.file.*;

public class MiniPractice {
    public static void main(String[] args) throws Exception {
        Path dir = Paths.get("demo_dir");
        Path file = dir.resolve("hello.txt");

        // Tworzymy katalog, jeśli go nie ma
        if (!Files.exists(dir)) {
            Files.createDirectory(dir);
            System.out.println("Katalog utworzony: " + dir.toAbsolutePath());
        }

        // Tworzymy plik, jeśli go nie ma
        if (!Files.exists(file)) {
            Files.createFile(file);
            System.out.println("Plik utworzony: " + file.toAbsolutePath());
        }

        // Wypisujemy właściwości
        System.out.println("Czy plik istnieje? " + Files.exists(file));
        System.out.println("Czy to plik? " + Files.isRegularFile(file));
        System.out.println("Rozmiar: " + Files.size(file) + " bajtów");

        // Usuwamy plik i katalog (opcjonalnie)
        Files.delete(file);
        Files.delete(dir);
        System.out.println("Plik i katalog usunięte.");
    }
}

8. Typowe błędy przy pracy z File/Path/Files

Błąd nr 1: Mylisz File i Path. Wielu początkujących próbuje używać metod Files z obiektem File. Pamiętaj: Files.* działa z Path. Jeśli masz File, najpierw zrób file.toPath().

Błąd nr 2: Oczekiwanie, że utworzenie obiektu File lub Path tworzy plik. Obiekt ścieżki to skrót, a nie realny plik. Do utworzenia używaj Files.createFile(path) lub zapisu danych.

Błąd nr 3: Ręczne sklejanie ścieżek w łańcuchach. Nie pisz "folder/file.txt" ani "folder\\file.txt". Używaj Paths.get(...) i resolve(...). To bezpieczniejsze i wieloplatformowe.

Błąd nr 4: Ignorowanie wyjątków. Operacje na plikach mogą zgłaszać IOException i inne wyjątki. Obsługuj je przez try-catch lub przekaż wyżej (throws).

Błąd nr 5: Sprawdzanie przez File.exists(), a potem praca przez Path. Staraj się trzymać jednego stylu: zacząłeś od Path — używaj Files.exists(path) i pozostałych metod Files.

1
Zadanie
JAVA 25 SELF, poziom 35, lekcja 1
Niedostępne
Gdzie są skarby? Sprawdzenie katalogu z zasobami gry 🎮
Gdzie są skarby? Sprawdzenie katalogu z zasobami gry 🎮
1
Zadanie
JAVA 25 SELF, poziom 35, lekcja 1
Niedostępne
Budowanie projektu: pełna ścieżka do "głównego" pliku 🏗️
Budowanie projektu: pełna ścieżka do "głównego" pliku 🏗️
Komentarze
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION