如何在 Azure 函数中运行 IronPDF for Java.

Curtis Chau

已更新:六月 1, 2025

Translated

View the article in English

IronPDF for Java 仅支持 Docker 部署。
不支持 Zip 部署，因为 IronPDF 需要在运行时执行二进制文件。

1.请遵循 Microsoft 官方指南：在 Linux 上使用自定义映像创建功能。

对于 选择一种编程语言 -> 选择 Java

按照指南进行操作，直到您的应用程序正常运行。 2.添加 IronPDF 依赖关系

使用最新的 <version> 将其添加到您的 pom 中：

<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

注意：ironpdf-engine-linux-x64 是必需的以在 Docker 中运行 IronPDF。

3.添加 RenderPdf 函数

在 Function.java 中添加一个新函数

该函数将接收 URL 并返回渲染后的 PDF。

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

添加 IronPdf.Linux 所需软件包。从示例中可以看出，基础 Docker 映像是 mcr.microsoft.com/azure-functions/java:4-java$JAVA_VERSION-build，它基于 Debian 11。因此，我们需要将这些软件包添加到 Dockerfile 中。

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

有关其他 Linux 发行版，请参阅《IronPDF Linux 安装指南》。

5.将您的功能重新部署到 Azure

构建和打包：mvn clean package 2.构建 Docker 映像：docker build --tag <DOCKER_ID>/azurefunctionsimage:v1.0.0 .

推送 Docker 镜像：docker push <DOCKER_ID>/azurefunctionsimage:v1.0.0 4.更新 Azure 功能：

  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.享受 IronPDF