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.
GO TO FULL VERSION