POMOC DOTYCZąCA JęZYKA JAVA

Apache Commons IO: Narzędzia I/O Java

Name: IronPDF
Brand: Iron Software
Availability: InStock
Rating: 4.87 (307 reviews)

Zaktualizowano:18 stycznia, 2026

Apache Commons IO to obszerna biblioteka narzędzi, która pomaga programistom Java w bardziej wydajnym obsłudze operacji wejścia/wyjścia (I/O). W ramach projektu Apache Commons, Commons IO zapewnia zestaw łatwych w użyciu narzędzi do zarządzania implementacjami plików i strumieni, które w Javie są zazwyczaj uciążliwe i podatne na błędy.

W tym artykule omówiono kluczowe funkcje i praktyczne zastosowania biblioteki Apache Commons IO, pokazując, dlaczego jest ona cennym dodatkiem do zestawu narzędzi każdego programisty Java.

Wprowadzenie do Apache Commons IO

Apache Commons IO zostało zaprojektowane w celu wypełnienia luki między niskopoziomowymi klasami wejścia/wyjścia w Javie a operacjami wysokopoziomowymi, które programiści często muszą wykonywać. Najnowsza wersja zawiera zoptymalizowane klasy i metody użytkowe, które upraszczają zadania, takie jak odczyt i zapis plików, zarządzanie systemami plików oraz obsługa strumieni danych. Jego głównymi celami są poprawa czytelności kodu, ograniczenie kodu szablonowego oraz zminimalizowanie prawdopodobieństwa wystąpienia błędów.

Apache Commons IO (jak to działa dla programistów): Rysunek 1

Najważniejsze cechy

Narzędzia do obsługi plików i katalogów:

FileUtils: Ta klasa oferuje metody statyczne do typowych operacji na plikach, takich jak kopiowanie, przenoszenie, usuwanie i odczytywanie plików. Na przykład FileUtils.copyFile(File srcFile, File destFile) upraszcza zadanie kopiowania plików.
DirectoryWalker: Narzędzie umożliwiające rekurencyjne przeszukiwanie struktur katalogów, ułatwiające przetwarzanie plików w drzewie katalogów.

Monitorowanie plików:

FileAlterationMonitor: Ta klasa zapewnia prosty mechanizm monitorowania zmian w systemie plików. Może wykrywać zdarzenia związane z tworzeniem, modyfikacją i usuwaniem plików.

Strumienie i czytniki/zapisywacze:

IOUtils: Ta klasa zawiera metody statyczne do pracy ze strumieniami, czytnikami i zapisami. Metody takie jak IOUtils.copy(InputStream input, OutputStream output) i IOUtils.toString(InputStream input, String encoding) ułatwiają transfer i konwersję danych.
EndianUtils: Narzędzia do obsługi konwersji danych związanych z kolejnością bajtów (endian), które są często wymagane podczas pracy z danymi binarnymi.

Filtry plików:

Różnorodne filtry plików (np. SuffixFileFilter, PrefixFileFilter, WildcardFileFilter) pozwalają programistom łatwo filtrować pliki na podstawie wzorców nazewnictwa, rozszerzeń lub innych kryteriów.

Porównywarki plików:

Klasy te zapewniają elastyczne sposoby porównywania plików na podstawie różnych atrybutów, takich jak rozmiar, nazwa lub data ostatniej modyfikacji, co ułatwia sortowanie i organizowanie plików.

Zastosowania praktyczne

Obsługa plików: Commons IO upraszcza zadania związane z obsługą plików. Na przykład kopiowanie zawartości jednego katalogu do drugiego można wykonać bez wysiłku:

import org.apache.commons.io.FileUtils;
import java.io.File;
import java.io.IOException;

public class FileManipulator {
    public static void main(String[] args) {
        File srcDir = new File("/path/to/source");
        File destDir = new File("/path/to/destination");

        try {
            // Copy contents from source directory to destination directory
            FileUtils.copyDirectory(srcDir, destDir);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

import org.apache.commons.io.FileUtils;
import java.io.File;
import java.io.IOException;

public class FileManipulator {
    public static void main(String[] args) {
        File srcDir = new File("/path/to/source");
        File destDir = new File("/path/to/destination");

        try {
            // Copy contents from source directory to destination directory
            FileUtils.copyDirectory(srcDir, destDir);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

JAVA

Odczytywanie i zapisywanie plików: Odczytywanie zawartości pliku do String:

import org.apache.commons.io.FileUtils;
import java.io.File;
import java.io.IOException;
import java.nio.charset.StandardCharsets;

public class FileReadWriteExample {
    public static void main(String[] args) {
        File file = new File("/path/to/file.txt");

        try {
            // Read file content into a String
            String content = FileUtils.readFileToString(file, StandardCharsets.UTF_8);
            System.out.println("File Content: " + content);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

import org.apache.commons.io.FileUtils;
import java.io.File;
import java.io.IOException;
import java.nio.charset.StandardCharsets;

public class FileReadWriteExample {
    public static void main(String[] args) {
        File file = new File("/path/to/file.txt");

        try {
            // Read file content into a String
            String content = FileUtils.readFileToString(file, StandardCharsets.UTF_8);
            System.out.println("File Content: " + content);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

JAVA

Zapisywanie String do pliku:

import org.apache.commons.io.FileUtils;
import java.io.File;
import java.io.IOException;
import java.nio.charset.StandardCharsets;

public class FileReadWriteExample {
    public static void main(String[] args) {
        File file = new File("/path/to/file.txt");
        String content = "Hello, World!";

        try {
            // Write String content to the specified file
            FileUtils.writeStringToFile(file, content, StandardCharsets.UTF_8);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

import org.apache.commons.io.FileUtils;
import java.io.File;
import java.io.IOException;
import java.nio.charset.StandardCharsets;

public class FileReadWriteExample {
    public static void main(String[] args) {
        File file = new File("/path/to/file.txt");
        String content = "Hello, World!";

        try {
            // Write String content to the specified file
            FileUtils.writeStringToFile(file, content, StandardCharsets.UTF_8);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

JAVA

Monitorowanie plików: Konfiguracja monitora plików w celu śledzenia zmian w katalogu:

import org.apache.commons.io.monitor.FileAlterationListenerAdaptor;
import org.apache.commons.io.monitor.FileAlterationMonitor;
import org.apache.commons.io.monitor.FileAlterationObserver;
import java.io.File;

public class FileMonitorExample {
    public static void main(String[] args) {
        // Create an observer for the specified directory
        FileAlterationObserver observer = new FileAlterationObserver(new File("/path/to/directory"));

        // Add a listener to handle file create and delete events
        observer.addListener(new FileAlterationListenerAdaptor() {
            @Override
            public void onFileCreate(File file) {
                System.out.println("File created: " + file.getName());
            }

            @Override
            public void onFileDelete(File file) {
                System.out.println("File deleted: " + file.getName());
            }

            // Other override methods for file modification, etc.
        });

        // Set up the file alteration monitor
        FileAlterationMonitor monitor = new FileAlterationMonitor(5000, observer);

        try {
            // Start the monitoring process
            monitor.start();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

import org.apache.commons.io.monitor.FileAlterationListenerAdaptor;
import org.apache.commons.io.monitor.FileAlterationMonitor;
import org.apache.commons.io.monitor.FileAlterationObserver;
import java.io.File;

public class FileMonitorExample {
    public static void main(String[] args) {
        // Create an observer for the specified directory
        FileAlterationObserver observer = new FileAlterationObserver(new File("/path/to/directory"));

        // Add a listener to handle file create and delete events
        observer.addListener(new FileAlterationListenerAdaptor() {
            @Override
            public void onFileCreate(File file) {
                System.out.println("File created: " + file.getName());
            }

            @Override
            public void onFileDelete(File file) {
                System.out.println("File deleted: " + file.getName());
            }

            // Other override methods for file modification, etc.
        });

        // Set up the file alteration monitor
        FileAlterationMonitor monitor = new FileAlterationMonitor(5000, observer);

        try {
            // Start the monitoring process
            monitor.start();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

JAVA

Wykorzystanie Apache Commons IO z IronPDF for Java do generowania plików PDF

IronPDF for Java, opracowany i utrzymywany przez Iron Software, to potężna biblioteka, która umożliwia inżynierom oprogramowania tworzenie, edytowanie i wyodrębnianie treści PDF w projektach Java, Kotlin i Scala.

Apache Commons IO (jak to działa dla programistów): Rysunek 2

Łącząc IronPDF z Apache Commons IO, programiści mogą efektywnie obsługiwać operacje na plikach, korzystając jednocześnie z zaawansowanych funkcji generowania plików PDF. W tym artykule pokazano, jak używać tych dwóch bibliotek razem do generowania plików PDF z adresów URL, plików HTML i ciągów znaków HTML.

O IronPDF for Java

IronPDF for Java opiera się na sukcesie swojego odpowiednika dla platformy .NET, oferując szeroki zakres możliwości, w tym:

Generowanie plików PDF z HTML, adresów URL, JavaScript, CSS i różnych formatów obrazów.
Dodawanie nagłówków, stopek, podpisów, załączników, haseł i funkcji zabezpieczeń.
Optymalizacja wydajności dzięki pełnej obsłudze wielowątkowości i asynchroniczności.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że dodałeś do swojego projektu niezbędne zależności zarówno dla IronPDF, jak i Apache Commons IO. Poniżej znajdują się zależności Maven dla tych bibliotek:

`pom.xml`

<dependencies>

    <dependency>
        <groupId>commons-io</groupId>
        <artifactId>commons-io</artifactId>
        <version>2.11.0</version>
    </dependency>

    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>2024.3.1</version>
    </dependency>

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>2.0.3</version>
    </dependency>
</dependencies>

<dependencies>

    <dependency>
        <groupId>commons-io</groupId>
        <artifactId>commons-io</artifactId>
        <version>2.11.0</version>
    </dependency>

    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>2024.3.1</version>
    </dependency>

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>2.0.3</version>
    </dependency>
</dependencies>

XML

Przykład: Generowanie pliku PDF z pliku tekstowego za pomocą Apache Commons IO

Ten przykład pokazuje, jak odczytać zawartość pliku tekstowego przy użyciu Apache Commons IO, a następnie wygenerować plik PDF za pomocą IronPDF.

`Main.java`

import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.Settings;
import org.apache.commons.io.FileUtils;
import java.io.File;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.nio.file.Paths;

public class PdfFromTextFileExample {
    public static void main(String[] args) {
        try {
            // Apply your IronPDF license key
            License.setLicenseKey("YOUR-LICENSE-KEY");

            // Set a log path for IronPDF logging
            Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

            // Read text content from a file using Apache Commons IO
            File textFile = new File("example.txt");
            String textContent = FileUtils.readFileToString(textFile, StandardCharsets.UTF_8);

            // Render the text content as a PDF
            PdfDocument pdfFromTextContent = PdfDocument.renderHtmlAsPdf("<pre>" + textContent + "</pre>");

            // Save the PdfDocument using IronPDF's saveAs method
            pdfFromTextContent.saveAs(Paths.get("example.pdf"));

            System.out.println("PDF generated and saved as example.pdf");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.Settings;
import org.apache.commons.io.FileUtils;
import java.io.File;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.nio.file.Paths;

public class PdfFromTextFileExample {
    public static void main(String[] args) {
        try {
            // Apply your IronPDF license key
            License.setLicenseKey("YOUR-LICENSE-KEY");

            // Set a log path for IronPDF logging
            Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

            // Read text content from a file using Apache Commons IO
            File textFile = new File("example.txt");
            String textContent = FileUtils.readFileToString(textFile, StandardCharsets.UTF_8);

            // Render the text content as a PDF
            PdfDocument pdfFromTextContent = PdfDocument.renderHtmlAsPdf("<pre>" + textContent + "</pre>");

            // Save the PdfDocument using IronPDF's saveAs method
            pdfFromTextContent.saveAs(Paths.get("example.pdf"));

            System.out.println("PDF generated and saved as example.pdf");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

JAVA

Wyjaśnienie kodu

Oto krótkie wyjaśnienie powyższego kodu:

Zaimportuj niezbędne biblioteki:
- IronPDF do tworzenia plików PDF.
- Apache Commons IO do operacji na plikach.
Konfiguracja metody głównej:
- Zdefiniuj metodę main, aby zawierała logikę wykonania.
Ustaw licencję IronPDF:
- Zastosuj klucz licencyjny IronPDF z License.setLicenseKey("YOUR-LICENSE-KEY"). Do generowania dokumentów PDF wymagana jest licencja.
Ustaw ścieżkę dziennika:
- Zdefiniuj ścieżkę do pliku dziennika dla IronPDF za pomocą Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log")).
Odczyt pliku tekstowego:
- Użyj Apache Commons IO do odczytania treści z example.txt jako ciągu znaków zakodowanego w formacie UTF-8. Metoda readFileToString konwertuje zawartość pliku na String.
Render PDF:
- Przekonwertuj treść tekstową do formatu PDF za pomocą PdfDocument.renderHtmlAsPdf("<pre>" + textContent + "</pre>").
Zapisz jako PDF:
- Zapisz wygenerowany plik PDF w example.pdf, używając pdfFromTextContent.saveAs(Paths.get("example.pdf")).
Komunikat o zakończeniu i obsługa wyjątków:
- Wyświetl komunikat o pomyślnym utworzeniu pliku PDF.
- Obsłuż IOException, PRINTując ślad stosu w celu debugowania.

Aby uzyskać bardziej szczegółowe informacje na temat IronPDF, odwiedź stronę dokumentacji. Aby dowiedzieć się więcej o możliwościach IronPDF, odwiedź tę stronę z przykładami kodu.

Wnioski

Apache Commons IO to nieoceniona biblioteka dla programistów Java zajmujących się operacjami na plikach i strumieniach. Dzięki integracji Apache Commons IO z IronPDF for Java możesz zwiększyć możliwości obsługi plików podczas generowania plików PDF. W połączeniu biblioteki te stanowią potężne rozwiązanie do zarządzania i generowania plików PDF w aplikacjach Java. Niezależnie od tego, czy generujesz pliki PDF z plików tekstowych, adresów URL, plików HTML czy ciągów znaków HTML, takie podejście zapewnia usprawnione i skuteczne zarządzanie plikami PDF w projektach Java.

IronPDF oferuje bezpłatną wersję próbną. Pobierz bibliotekę stąd i wypróbuj ją!

Darrius Serrant

Czat z zespołem inżynierów teraz

Full Stack Software Engineer (WebOps)

Darrius Serrant posiada tytuł licencjata z informatyki z Uniwersytetu Miami i pracuje jako Full Stack WebOps Marketing Engineer w Iron Software. Już od młodych lat zainteresował się kodowaniem, postrzegając informatykę jako zarówno tajemniczą, jak i dostępną, co czyni ją doskonałym medium dla kreatywności ...

Czytaj więcej

Powiązane artykuły

Zaktualizowano 26 października, 2025

Java – przekazywanie przez referencję (jak to działa dla programistów)

W języku programowania Java przekazywanie parametrów zawsze odbywa się metodą „pass-by-value”. W przypadku obiektów zmienna referencyjna jest przekazywana przez wartość.

Czytaj więcej