PrintBridge 打印桥 🖨️

连接Web与打印机的智能桥梁 - 一个企业级Web打印中间件,让浏览器应用轻松调用本地打印服务。

基于Java Swing + Jetty构建,为Web应用提供高性能、跨浏览器的本地打印解决方案。

简体中文 | English

⭐ 给个Star吧!

如果PrintBridge对您有帮助,请给个Star支持一下! ⭐

您的支持是我们持续改进PrintBridge、交付更多功能的最大动力。一个Star不仅帮助其他开发者发现这个项目,更能让整个社区受益!

快速点Star: 点击页面右上角的 ⭐ 按钮 → 只需2秒钟!

为什么选择PrintBridge? 💭

PrintBridge诞生于真实业务场景中的痛点:当Web应用需要调用本地打印机时,传统方案往往复杂、不稳定。PrintBridge提供了一个轻量、可靠的解决方案。

项目演进

2020: v1.0 基于Socket的原型系统
2025: v2.0 企业级重构
- 🔄 从原始Socket实现升级到企业级Jetty服务器
- 📊 集成SLF4J + Logback日志系统
- 🎨 使用FlatLaf现代化界面主题
- 🧹 遵循现代Java开发规范

核心特性 🚀

🌐 即插即用: 一行API调用,任何浏览器都能打印
📄 多格式支持: PDF、Word、Excel、PPT、图片等格式
⚡ 高性能架构: Jetty服务器 + 多线程队列,轻松应对高并发
🔄 智能转换: 基于JODConverter + LibreOffice,完美还原格式
🎯 智能队列: 可视化任务管理,批量打印不混乱
🎨 极简界面: FlatLaf现代主题,操作直观不费力
📝 生产级日志: SLF4J + Logback,问题排查有据可依
🔒 安全可控: 本地服务,数据不出本机

快速开始 ⚡

前置条件

☕ Java 8+ 运行环境
🖨️ 至少一台可用的打印机
📦 LibreOffice (可选,用于支持Office格式)

启动服务

方式一: Maven 快速启动(推荐)

# 从GitHub克隆
git clone https://github.com/magicyuan876/PrintBridge.git

# 或从Gitee克隆(国内更快)
git clone https://gitee.com/magic_yuan_admin/PrintBridge.git

# 启动服务
cd PrintBridge
mvn clean compile exec:java -Dexec.mainClass="com.magicyuan.print.PrintApplication"

方式二: 直接运行

javac -cp "lib/*" -d target/classes src/main/java/**/*.java
java -cp "target/classes:lib/*" com.magicyuan.print.PrintApplication

验证安装

启动后访问 http://localhost:8281/health ,看到 {"status":"ok"} 即表示服务正常运行。

LibreOffice配置(可选)

如需打印Word/Excel/PPT等Office格式,请安装LibreOffice:

Windows:

访问 https://www.libreoffice.org/download/download/
下载并安装
重启PrintBridge服务

Linux:

# Ubuntu/Debian
sudo apt-get install libreoffice

# CentOS/RHEL
sudo yum install libreoffice

macOS:

brew install --cask libreoffice

启动时日志会显示:

✓ Office格式: Word, Excel, PowerPoint
  LibreOffice已检测到,多格式支持已启用

使用指南 📖

API接口

打印文档

POST http://localhost:8281/print

请求参数:

[
  {
    "fileName": "文档名称",           // 文档名称
    "fileUrl": "http://example.com/file.xxx",  // 文件URL
    "landscape": false               // false=竖向, true=横向
  }
]

支持的文件格式:

PDF: http://example.com/document.pdf
Word: http://example.com/report.docx
Excel: http://example.com/table.xlsx
PowerPoint: http://example.com/slides.pptx
图片: http://example.com/image.png

响应示例:

{
  "code": 200,
  "message": "打印任务已加入队列"
}

前端集成示例

原生JavaScript

function printDocument(fileUrl, fileName = 'document.pdf') {
    fetch('http://localhost:8281/print', {
        method: 'POST',
        headers: {'Content-Type': 'application/json'},
        body: JSON.stringify([{
            fileName: fileName,
            fileUrl: fileUrl,
            landscape: false  // 横向打印设为true
        }])
    })
    .then(res => res.json())
    .then(data => console.log('✓ 打印任务已提交:', data))
    .catch(err => console.error('✗ 打印失败:', err));
}

// 打印PDF
printDocument('https://example.com/invoice.pdf', '发票.pdf');

// 打印Word文档
printDocument('https://example.com/report.docx', '报告.docx');

// 打印Excel表格
printDocument('https://example.com/data.xlsx', '数据.xlsx');

// 打印图片
printDocument('https://example.com/photo.png', '照片.png');

jQuery方式

$.ajax({
    url: 'http://localhost:8281/print',
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify([{
        fileName: '合同.pdf',
        fileUrl: 'https://example.com/contract.pdf',
        landscape: false
    }]),
    success: (res) => alert('打印任务已提交'),
    error: (err) => alert('打印失败: ' + err.statusText)
});

React/Vue 示例

// React组件中
const handlePrint = async (pdfUrl) => {
    try {
        const response = await fetch('http://localhost:8281/print', {
            method: 'POST',
            headers: {'Content-Type': 'application/json'},
            body: JSON.stringify([{
                fileName: '报表.pdf',
                fileUrl: pdfUrl,
                landscape: false
            }])
        });
        const result = await response.json();
        console.log('打印成功', result);
    } catch (error) {
        console.error('打印失败', error);
    }
}

配置说明 ⚙️

默认配置

配置项	默认值	说明
监听端口	8281	HTTP服务端口
工作线程	10-100	动态线程池
支持格式	PDF	当前版本支持
日志目录	`logs/`	日志文件位置
日志保留	30天	自动清理旧日志

自定义配置

修改 src/main/resources/logback.xml 可调整日志级别和输出策略。

常见问题 💡

Q: 服务启动失败怎么办?

解决步骤:

检查8281端口是否被占用: netstat -ano | findstr 8281
查看错误日志: logs/print-server-error.log
确认Java版本 >= 8: java -version

Q: 打印任务没有反应?

排查清单:

✓ PDF文件URL是否可访问(浏览器测试)
✓ 打印机是否在线且驱动正常
✓ 查看界面打印队列状态
✓ 检查日志文件 logs/print-server.log

Q: 浏览器提示跨域错误?

解决方案:

PrintBridge已内置CORS支持,无需额外配置
确认服务已启动: 访问 http://localhost:8281/health
如在HTTPS页面调用,需配置SSL证书或使用代理

Q: 支持哪些文件格式?

完全支持:

✅ PDF文档

图片格式(自动转换为PDF):

✅ PNG, JPG, JPEG, GIF, BMP

Office格式(需要安装LibreOffice):

✅ Word (.docx, .doc)
✅ Excel (.xlsx, .xls)
✅ PowerPoint (.pptx, .ppt)

如未安装LibreOffice,Office格式将无法打印。

Q: 如何启用Office格式支持?

步骤:

下载并安装 LibreOffice
重启PrintBridge服务
启动时会自动检测LibreOffice并启用Office格式支持

验证: 查看启动日志,会显示"LibreOffice已检测到,多格式支持已启用"

架构设计 🏗️

PrintBridge
├── controller/         # API接口层
├── service/           # 核心业务逻辑
│   ├── JettyPrintService     # HTTP服务
│   ├── PrintService          # 打印引擎
│   └── ServerStatusService   # 状态管理
├── ui/                # Swing界面
├── model/             # 数据模型
└── config/            # 配置中心

技术栈:

🚀 Web服务: Jetty 9.4
🖨️ 打印引擎: Apache PDFBox 2.0
🔄 格式转换: JODConverter 4.4 + LibreOffice
🎨 界面框架: Swing + FlatLaf
📝 日志系统: SLF4J + Logback
📦 依赖管理: Maven

版本历史 📋

版本	日期	更新内容
v2.1.0	2025-10	📄 多格式支持: Word/Excel/PPT/图片 + JODConverter集成
v2.0.0	2025-01	🚀 企业级重构: Jetty服务器 + SLF4J日志 + FlatLaf主题
v1.0.0	2020-08	🎉 初始版本: Socket HTTP服务器 + PDF打印

产品路线图 🗺️

✅ v2.1 (当前版本)

📄 多格式支持: Word、Excel、PPT、图片等格式
🔄 JODConverter集成: 基于LibreOffice的格式转换
🖼️ 图片打印: PNG、JPG、GIF、BMP自动转PDF

🎯 v2.2 (计划中)

🖨️ 打印预设: 保存常用打印配置
📋 打印历史: 查看和重新打印历史任务
📊 打印统计: 任务数量、成功率等统计

🚀 v3.0 (规划中)

🎨 水印功能: 文字/图片水印添加
⚙️ 高级设置: 双面打印、页面范围、份数控制
🖥️ 网络共享: 局域网内多台电脑共享使用

🌟 长期愿景

🔍 打印预览: 打印前本地预览
☁️ 云存储集成: 支持OSS/S3等云存储直接打印
🔐 安全加固: IP白名单、API Token认证

💡 有好的想法?欢迎提Issue或加入讨论!

参与贡献 🤝

欢迎各种形式的贡献!无论是新功能、Bug修复还是文档改进。

贡献流程

🍴 Fork本项目
🌿 创建特性分支 git checkout -b feature/AmazingFeature
💾 提交更改 git commit -m 'Add some AmazingFeature'
📤 推送到分支 git push origin feature/AmazingFeature
🎉 提交Pull Request

开发规范

遵循现有代码风格
添加必要的单元测试
更新相关文档
提交前运行 mvn clean test

开源协议 📄

本项目基于 Apache License 2.0 开源协议发布。

社区与支持 💬

致谢 🙏

感谢所有使用和贡献PrintBridge的开发者!

核心依赖:

Apache PDFBox - PDF处理引擎
JODConverter - 文档格式转换
LibreOffice - Office文档渲染
Eclipse Jetty - HTTP服务器
FlatLaf - 现代UI主题

⭐ 如果PrintBridge对您有帮助,请给个Star支持! ⭐

您的Star是我们最大的动力! 只需2秒钟,却对我们意义重大!

Made with ❤️ by developers, for developers

⭐ GitHub上Star · ⭐ Gitee上Star · 提交Issue · 参与讨论

Name		Name	Last commit message	Last commit date
Latest commit History 15 Commits
META-INF		META-INF
src/main		src/main
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
README_EN.md		README_EN.md
pom.xml		pom.xml

Folders and files

Latest commit

History

Repository files navigation