Czym jest Maven w Javie (samouczek dotyczący działania)

Kolejnym krokiem jest skonfigurowanie pliku POM projektu. Plik ten opisuje zależności projektu, proces kompilacji oraz inne ważne informacje. Rozważmy następujący przykładowy plik pom.xml.

PLIK XML

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.example</groupId>
    <artifactId>SampleProject</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>
    <dependencies>
        <dependency>
            <groupId>com.ironsoftware</groupId>
            <artifactId>ironpdf</artifactId>
            <version>2024.9.1</version>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-simple</artifactId>
            <version>2.0.5</version>
        </dependency>
    </dependencies>
</project>

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.example</groupId>
    <artifactId>SampleProject</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>
    <dependencies>
        <dependency>
            <groupId>com.ironsoftware</groupId>
            <artifactId>ironpdf</artifactId>
            <version>2024.9.1</version>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-simple</artifactId>
            <version>2.0.5</version>
        </dependency>
    </dependencies>
</project>

Powyższy plik pom.xml definiuje projekt Maven o następujących szczegółach:

• Identyfikator grupy: org.example
• Identyfikator artefaktu: SampleProject
• Wersja: 1.0-SNAPSHOT

Ten plik pom.xml zawiera również sekcję służącą do definiowania właściwości na poziomie projektu, do których można odwoływać się w innych częściach pliku pom.xml. W tym przykładzie właściwość projektu build.sourceEncoding jest ustawiona na UTF-8.

Definiuje projekt z dwiema zależnościami:

• Biblioteka IronPDF (popularna biblioteka do generowania dokumentów PDF z treści HTML w Javie), wersja 2024.9.1, z grupy com.ironsoftware.
• Biblioteka slf4j-simple, wersja 2.0.5, z grupy org.slf4j.

Oprócz zależności plik pom.xml ustawia również wersję źródłową i docelową kompilatora Java na 17, wykorzystując właściwości maven.compiler.source i maven.compiler.target.

Należy pamiętać, że jest to tylko przykład, a pliki pom.xml mogą się znacznie różnić pod względem zawartości i złożoności w zależności od potrzeb projektu.

Po skonfigurowaniu projektu można go skompilować za pomocą następującego polecenia:

mvn clean install

mvn clean install

Maven automatycznie pobierze i zainstaluje wszelkie niezbędne zależności, skompiluje kod źródłowy oraz wygeneruje niezbędne artefakty, takie jak pliki JAR lub WAR. W tym przypadku zainstaluje IronPDF.

Po zainstalowaniu biblioteki IronPDF można z niej korzystać w projekcie, importując niezbędne klasy i metody. Poniżej znajduje się przykład wykorzystania IronPDF do wygenerowania dokumentu PDF na podstawie ciągu znaków HTML.

Generowanie pliku PDF z ciągu znaków HTML

import com.ironsoftware.ironpdf.PdfDocument; // Import necessary class from IronPDF

public class PDFGenerator {

    public static void main(String[] args) {
        // Create a PDF document from an HTML string
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>What is MVN in Java.?</h1><p>Sample PDF file</p>");

        // Save the PDF document to a file
        pdf.saveAs("MVN.pdf");
    }
}

import com.ironsoftware.ironpdf.PdfDocument; // Import necessary class from IronPDF

public class PDFGenerator {

    public static void main(String[] args) {
        // Create a PDF document from an HTML string
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>What is MVN in Java.?</h1><p>Sample PDF file</p>");

        // Save the PDF document to a file
        pdf.saveAs("MVN.pdf");
    }
}

Ten kod wykorzystuje bibliotekę IronPDF do generowania dokumentu PDF na podstawie ciągu znaków HTML i zapisywania go w pliku. Oto jak to działa:

1. Najpierw importujemy niezbędną klasę PdfDocument z biblioteki IronPDF.
2. W metodzie głównej obiekt PdfDocument jest tworzony poprzez wywołanie metody [renderHtmlAsPdf](/java/object-reference/api/com/ironsoftware/ironpdf/PdfDocument.html#renderHtmlAsPdf(java.lang.String) klasy PdfDocument. W tej metodzie przekazujemy ciąg znaków HTML. W tym przypadku ciąg HTML zawiera nagłówek oraz akapit o treści "Przykładowy plik PDF".
3. Metoda renderHtmlAsPdf generuje dokument PDF na podstawie ciągu znaków HTML przy użyciu biblioteki IronPDF.
4. Powstały dokument PDF jest następnie zapisywany do pliku przy użyciu metody [saveAs](/java/object-reference/api/com/ironsoftware/ironpdf/PdfDocument.html#saveAs(java.lang.String) klasy PdfDocument. W tym przypadku jako argument metody saveAs podajemy nazwę pliku "MVN.PDF".

Plik PDF wygenerowany na podstawie ciągu znaków HTML