1. IronPDF
2. 操作指南
3. IronPDF Java Azure Functions

如何在Azure Function中運行IronPDF for Java

• IronPDF for Java 僅支援 Docker 部署。
• 由於不支援 Zip 部署 IronPDF 在執行期間需要執行二進位文件。

1. 按照Microsoft 官方指南：使用自訂映像在 Linux 上建立函式

   • 為「選擇程式語言」-> 選擇「Java」

   • 按照指南操作，直到您的應用程序運行起來。

2. 添加 IronPDF 依賴性

   • 將此添加到您的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>

• 注意：在 Docker 中運行 IronPDF 需要 ironpdf-engine-linux。

3. 添加 RenderPdf 函數

   • 在 Function.java 中新增一個函數。

   • 此功能將接收一個URL並返回渲染的PDF。

    public class Function {

    //...
    @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
        final String url = request.getQueryParameters().get("url");
        if (url == null) {
            return request.createResponseBuilder(HttpStatus.BAD_REQUEST).body("Please pass a url on the query string").build();
        } else {
            context.getLogger().info("IronPDF try to render url: " + url);
            PdfDocument pdfDocument = com.ironsoftware.ironpdf.PdfDocument.renderUrlAsPdf(url);
            byte [] content = pdfDocument.getBinaryData();
            return request.createResponseBuilder(HttpStatus.OK)
                    .body(content)
                    .header("Content-Disposition", "attachment; filename=ironpdf_result.pdf")
                    .build();
        }
    }
    }

    public class Function {

    //...
    @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
        final String url = request.getQueryParameters().get("url");
        if (url == null) {
            return request.createResponseBuilder(HttpStatus.BAD_REQUEST).body("Please pass a url on the query string").build();
        } else {
            context.getLogger().info("IronPDF try to render url: " + url);
            PdfDocument pdfDocument = com.ironsoftware.ironpdf.PdfDocument.renderUrlAsPdf(url);
            byte [] content = pdfDocument.getBinaryData();
            return request.createResponseBuilder(HttpStatus.OK)
                    .body(content)
                    .header("Content-Disposition", "attachment; filename=ironpdf_result.pdf")
                    .build();
        }
    }
    }

4. 更新 Dockerfile

   • 添加 IronPDF Linux 所需的套件。

   從示例來看，基礎 Docker 映像是 mcr.microsoft.com/azure-functions/java:4-java$JAVA_VERSION-build，這是 Debian 11。

   因此，我們需要將這些包添加到 Docker 文件中。

   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

   1. 建置與打包 mvn clean package

   2. 建立 Docker 映像，例如：docker build --tag <DOCKER_ID>/azurefunctionsimage:v1.0.0 .

   3. 推送 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

6. 享受 IronPDF

   • 在以下位置觸發功能：https://<APP_NAME>.azurewebsites.net/api/RenderPdf?url=https://www.google.com

   • 注意：函式首次觸發時，可能因初始化而緩慢或失敗，但之後就會正常。