buildo/java8-wkhtmltopdf

java8-wkhtmltopdf

镜像概述和主要用途

java8-wkhtmltopdf是一个集成了Java 8运行环境和wkhtmltopdf工具的Docker镜像。该镜像旨在为需要在Java应用中实现HTML到PDF转换功能的场景提供开箱即用的运行环境，避免手动配置Java和wkhtmltopdf的依赖关系，简化应用部署流程。

核心功能和特性

• Java 8运行环境：内置Java 8 SDK，支持运行基于Java 8开发的应用程序
• wkhtmltopdf工具：集成wkhtmltopdf（一款将HTML页面转换为PDF文档的命令行工具），支持HTML/CSS标准，可生成高质量PDF
• 预配置环境：无需额外安装依赖，镜像已包含运行Java应用和执行PDF转换所需的基础组件
• 轻量级设计：基于精简基础镜像构建，平衡功能与镜像大小

使用场景和适用范围

• 需要从HTML模板生成PDF报表的Java应用
• 文档管理系统中实现HTML内容导出为PDF功能
• 企业级应用中需要服务端PDF生成的场景
• 开发、测试和生产环境中需要快速部署Java+PDF转换功能的场景

使用方法和配置说明

拉取镜像

bash
docker pull [镜像仓库地址]/java8-wkhtmltopdf:latest

（注：请将[镜像仓库地址]替换为实际的镜像仓库地址）

基本使用示例

1. 交互式运行容器

bash
docker run -it --rm [镜像仓库地址]/java8-wkhtmltopdf:latest /bin/bash

进入容器后，可直接使用Java和wkhtmltopdf命令：

bash
# 验证Java版本
java -version

# 验证wkhtmltopdf版本
wkhtmltopdf --version

# 示例：将HTML文件转换为PDF
echo "<h1>Test PDF</h1><p>Generated by wkhtmltopdf</p>" > test.html
wkhtmltopdf test.html output.pdf

2. 运行Java应用（挂载应用目录）

假设本地Java应用目录为/path/to/app，其中包含需要运行的JAR文件和HTML模板：

bash
docker run -v /path/to/app:/app --rm [镜像仓库地址]/java8-wkhtmltopdf:latest java -jar /app/your-application.jar

应用中可通过调用系统命令使用wkhtmltopdf，例如Java代码示例：

java
// 调用wkhtmltopdf将HTML文件转换为PDF
Process process = Runtime.getRuntime().exec("wkhtmltopdf /app/templates/report.html /app/output/report.pdf");
process.waitFor();

高级配置

• 挂载数据卷：通过-v参数挂载本地目录，实现HTML模板、PDF输出文件的持久化存储
• 环境变量：可根据需要设置Java环境变量（如JAVA_OPTS调整JVM参数），例如：

  bash
  docker run -e "JAVA_OPTS=-Xms512m -Xmx1g" [镜像仓库地址]/java8-wkhtmltopdf:latest java -jar /app/your-application.jar
  

• 网络配置：如需访问外部资源（如HTML中引用的远程图片），确保容器网络配置正确

docker-compose配置示例

yaml
version: '3'
services:
  pdf-generator:
    image: [镜像仓库地址]/java8-wkhtmltopdf:latest
    volumes:
      - ./app:/app
      - ./templates:/templates
      - ./output:/output
    environment:
      - JAVA_OPTS=-Xms512m -Xmx1g
    command: java -jar /app/pdf-generator.jar --template-path /templates --output-path /output