1. IronPDF
  2. Loslegen
  3. IronPDF Java Azure Functions

How to Run IronPDF for Java in an Azure Function

Curtis Chau
Curtis Chau
Aktualisiert:
This article was translated from English: Does it need improvement?
Translated
View the article in English

  • IronPDF for Java unterstützt nur die Docker-Bereitstellung.
  • Zip Deployment wird nicht unterstützt, da IronPDF die Ausführung von Binärdateien zur Laufzeit erfordert.

  1. Folgen Sie dem Microsoft Official Guide for Creating Function on Linux Using Custom Image
    • Für Wählen Sie eine Programmiersprache -> wählen Sie Java
    • Folgen Sie dem Leitfaden, bis Ihre App einsatzbereit ist.

  2. Fügen Sie die IronPDF-Abhängigkeit hinzu

    • Fügen Sie dies mit der neuesten <version> zu Ihrem pom hinzu:
    <dependencies>
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>2022.xx.x</version>
    </dependency>
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf-engine-linux-x64</artifactId>
        <version>2022.xx.x</version>
    </dependency>
</dependencies>
    <dependencies>
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>2022.xx.x</version>
    </dependency>
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf-engine-linux-x64</artifactId>
        <version>2022.xx.x</version>
    </dependency>
</dependencies>
    XML
    • Hinweis: ironpdf-engine-linux-x64 ist erforderlich, um IronPDF in Docker auszuführen.

  3. Hinzufügen einer RenderPdf-Funktion

    • Hinzufügen einer neuen Funktion in Function.java
    • Diese Funktion empfängt eine URL und gibt eine gerenderte PDF-Datei zurück.
    import com.microsoft.azure.functions.*;
import com.ironsoftware.ironpdf.PdfDocument;
import java.util.Optional;

public class Function {

    /**
     * Azure function to render a URL as a PDF and return it.
     * Triggered by an HTTP request with a URL query string parameter.
     */
    @FunctionName("RenderPdf")
    public HttpResponseMessage renderPdf(
            @HttpTrigger(
                    name = "req",
                    methods = {HttpMethod.GET, HttpMethod.POST},
                    authLevel = AuthorizationLevel.ANONYMOUS)
            HttpRequestMessage<Optional<String>> request,
            final ExecutionContext context) {
        context.getLogger().info("Java HTTP trigger processed a request. (RenderPdf)");

        // Parse query parameter for the URL
        final String url = request.getQueryParameters().get("url");

        // Check if the URL parameter is provided
        if (url == null) {
            return request.createResponseBuilder(HttpStatus.BAD_REQUEST)
                    .body("Please pass a url on the query string")
                    .build();
        } else {
            try {
                context.getLogger().info("IronPDF is attempting to render the URL: " + url);

                // Render the given URL as a PDF
                PdfDocument pdfDocument = PdfDocument.renderUrlAsPdf(url);

                // Convert the PDF document to binary data
                byte[] content = pdfDocument.getBinaryData();

                // Return the PDF as an attachment in the response
                return request.createResponseBuilder(HttpStatus.OK)
                        .body(content)
                        .header("Content-Disposition", "attachment; filename=ironpdf_result.pdf")
                        .build();
            } catch (Exception e) {
                context.getLogger().severe("Failed to render PDF: " + e.getMessage());
                return request.createResponseBuilder(HttpStatus.INTERNAL_SERVER_ERROR)
                        .body("An error occurred while rendering the PDF.")
                        .build();
            }
        }
    }
}
    import com.microsoft.azure.functions.*;
import com.ironsoftware.ironpdf.PdfDocument;
import java.util.Optional;

public class Function {

    /**
     * Azure function to render a URL as a PDF and return it.
     * Triggered by an HTTP request with a URL query string parameter.
     */
    @FunctionName("RenderPdf")
    public HttpResponseMessage renderPdf(
            @HttpTrigger(
                    name = "req",
                    methods = {HttpMethod.GET, HttpMethod.POST},
                    authLevel = AuthorizationLevel.ANONYMOUS)
            HttpRequestMessage<Optional<String>> request,
            final ExecutionContext context) {
        context.getLogger().info("Java HTTP trigger processed a request. (RenderPdf)");

        // Parse query parameter for the URL
        final String url = request.getQueryParameters().get("url");

        // Check if the URL parameter is provided
        if (url == null) {
            return request.createResponseBuilder(HttpStatus.BAD_REQUEST)
                    .body("Please pass a url on the query string")
                    .build();
        } else {
            try {
                context.getLogger().info("IronPDF is attempting to render the URL: " + url);

                // Render the given URL as a PDF
                PdfDocument pdfDocument = PdfDocument.renderUrlAsPdf(url);

                // Convert the PDF document to binary data
                byte[] content = pdfDocument.getBinaryData();

                // Return the PDF as an attachment in the response
                return request.createResponseBuilder(HttpStatus.OK)
                        .body(content)
                        .header("Content-Disposition", "attachment; filename=ironpdf_result.pdf")
                        .build();
            } catch (Exception e) {
                context.getLogger().severe("Failed to render PDF: " + e.getMessage());
                return request.createResponseBuilder(HttpStatus.INTERNAL_SERVER_ERROR)
                        .body("An error occurred while rendering the PDF.")
                        .build();
            }
        }
    }
}
    JAVA

  4. Dockerfile aktualisieren

    • Fügen Sie die für IronPDF Linux erforderlichen Pakete hinzu. Im Beispiel ist das Basis-Docker-Image mcr.microsoft.com/azure-functions/java:4-java$JAVA_VERSION-build, das auf Debian 11 basiert. Wir müssen also diese Pakete zum Dockerfile hinzufügen.
    RUN apt update \
&& apt install -y libgdiplus libxkbcommon-x11-0 libc6 libc6-dev libgtk2.0-0 libnss3 \
                 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 \
                 libasound2 libxrender1 libfontconfig1 libxshmfence1
RUN apt-get install -y xvfb libva-dev libgdiplus

  5. Stellen Sie Ihre Funktion auf Azure um

    1. Erstellen und verpacken: mvn clean package
    2. Docker-Image erstellen: docker build --tag <DOCKER_ID>/azurefunctionsimage:v1.0.0 .
    3. Docker-Image pushen: docker push <DOCKER_ID>/azurefunctionsimage:v1.0.0
    4. Azure-Funktion aktualisieren: 
      az functionapp create --name <APP_NAME> --storage-account <STORAGE_NAME> \
                    --resource-group AzureFunctionsContainers-rg --plan myPremiumPlan \
                    --deployment-container-image-name <DOCKER_ID>/azurefunctionsimage:v1.0.0
      az functionapp create --name <APP_NAME> --storage-account <STORAGE_NAME> \
                    --resource-group AzureFunctionsContainers-rg --plan myPremiumPlan \
                    --deployment-container-image-name <DOCKER_ID>/azurefunctionsimage:v1.0.0
      SHELL
  6. Viel Spaß mit IronPDF
    • Funktion auslösen bei: https://<APP_NAME>.azurewebsites.net/api/RenderPdf?url=https://www.google.com
    • Hinweis: Wenn die Funktion das erste Mal ausgelöst wird, kann sie langsam sein oder aufgrund der Initialisierung fehlschlagen, aber danach sollte sie konsistent funktionieren.

Häufig gestellte Fragen

Wie kann ich einen PDF-Generator in Java mit Azure Functions erstellen?

Sie können einen PDF-Generator in Java mit Azure Functions erstellen, indem Sie IronPDF über Docker bereitstellen. Dies beinhaltet die Verwendung der IronPDF-Bibliothek, um die PDF-Generierungsaufgaben innerhalb einer Azure-Funktionsumgebung zu erledigen.

Warum ist eine Docker-Bereitstellung für IronPDF auf Azure Functions erforderlich?

Eine Docker-Bereitstellung ist für IronPDF auf Azure Functions erforderlich, da die Ausführung von Binärdateien zur Laufzeit erforderlich ist, was von Zip-Bereitstellungsmethoden nicht unterstützt wird.

Wie sind die Schritte, um IronPDF-Abhängigkeiten zu einem Maven-Projekt hinzuzufügen?

Um IronPDF-Abhängigkeiten zu einem Maven-Projekt hinzuzufügen, schließen Sie die IronPDF- und `ironpdf-engine-linux-x64`-Bibliotheken in die `pom.xml`-Datei ein. Stellen Sie sicher, dass Sie die neuesten Versionsnummern für Kompatibilität verwenden.

Wie funktioniert die RenderPdf-Funktion in einer Azure-Funktion?

Die RenderPdf-Funktion in einer Azure-Funktion liest eine URL aus einer HTTP-Anfrage, verwendet die Methode `PdfDocument.renderUrlAsPdf` von IronPDF, um die URL als PDF zu rendern, und gibt das PDF als Anlage in der Antwort zurück.

Welche Linux-Pakete sind in der Docker-Datei für IronPDF erforderlich?

Die Docker-Datei für IronPDF sollte Linux-Pakete wie `libgdiplus`, `libxkbcommon-x11-0`, `libc6` und `libgtk2.0-0` enthalten, um eine ordnungsgemäße Funktionalität innerhalb eines Debian-basierten Images zu gewährleisten.

Was sollte ich erwarten, wenn ich die PDF-Generierungsfunktion zum ersten Mal auslöse?

Beim ersten Auslösen der PDF-Generierungsfunktion kann es aufgrund von Initialisierungsprozessen langsam sein oder fehlschlagen. Nachfolgende Ausführungen sollten konsistenter ablaufen.

Wie kann ich ein Docker-Image für eine Azure-Funktion bereitstellen?

Um ein Docker-Image für eine Azure-Funktion bereitzustellen, bauen Sie Ihr Projekt mit `mvn clean package`, erstellen Sie das Docker-Image, pushen Sie es in ein Docker-Registry, und aktualisieren Sie die Azure-Funktion, um dieses neue Image zu verwenden.

Welches ist das korrekte URL-Format, um eine PDF-Generierungsfunktion in Azure auszulösen?

Um die PDF-Generierungsfunktion auszulösen, verwenden Sie das URL-Format: `https://.azurewebsites.net/api/RenderPdf?url=`.

Wo finde ich Ressourcen zum Einrichten einer Azure-Funktion mit einem benutzerdefinierten Docker-Image?

Zum Einrichten einer Azure-Funktion mit einem benutzerdefinierten Docker-Image können Sie den offiziellen Microsoft-Leitfaden zum Erstellen einer Azure-Funktion auf Linux mit einem benutzerdefinierten Image konsultieren.

Curtis Chau
Curtis Chau
  Jetzt mit dem Ingenieurteam chatten
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Version: 2025.11 gerade veröffentlicht