简介基于Java与Web技术集成的医学DICOM图片打印系统源码面向医疗影像领域的开发者和技术实施人员用于解决DICOM影像的打印处理与Web化访问问题。资源包共452个文件大小28.44MB其中370个Java源文件构成核心处理逻辑57个JAR包提供依赖库支持7个XML文件完成系统配置另有HTML、JavaScript、CSS等前端资源用于构建浏览器交互界面。系统采用Java跨平台特性可通过标准浏览器直接访问包含登录、列表、打印预览等完整Web页面模块实现从影像加载到打印输出的全流程操作。目前已有115人学习下载。借助该源码可快速掌握DICOM打印模块的目录结构与实现思路参考readme说明可完成部署调试适用于医疗信息化项目开发、二次集成及Java Web技术学习。1. 用Java与Web做DICOM打印先想清楚边界体检中心和临床科室里用Web阅片已经是常态但真正把DICOM原图打印到胶片或A4纸上很多团队仍然卡在“能显示、不能打印”的状态。直接调window.print打出来的不是过黑就是过白窗宽窗位全丢。这套设计源码的思路是后端用Java解析DICOM把像素数据重建成Web端可用的图像再通过前端打印工作台做排版、分页和灰阶控制。它适合准备从零搭建医学影像打印模块的Java开发团队也适合想理解DICOM像素流转的影像IT工程师。核心不是某个库调通而是把解析、渲染、排版、输出这条链路拆干净。我习惯把整个模块分成服务端解析、前端工作台、接口调度三个部分来设计每个部分有独立的失败表现排查问题时会轻松很多。2. Java服务端把DICOM文件解析成Web能用的图像数据在服务端需要先明确一个边界医学打印的真正目标不是“把图片打出来”而是“把DICOM里保存的像素和显示参数完整还原”。一张CT图在显示器和胶片上看起来是否一致取决于窗宽窗位、覆盖层和像素映射关系。Web前端拿不到这些所以必须由Java读DICOM并在后端完成渲染。2.1 DICOM打印为什么要先做“图像化”而不是直接发Print SCUDICOM标准里有专门的Print Service支持Print SCU和Print SCP打印工作流中还有MPPS、Presentation State等配合。但使用这个协议的前提是科室有激光相机或者支持DICOM打印的胶片打印机并且需要在PACS里维护复杂的打印会话。很多Web项目只是把DICOM文件存到对象存储然后用浏览器查看没有独立打印服务器。这种情况下最稳妥的设计是把DICOM的图像化交给Java打印输出交给Web。后端用dcm4che读取像素转成PNG或JPEG前端用CSS分页排版通过浏览器打印机或生成PDF。这个方案把DICOM打印拆成“解析渲染”和“排版输出”两段两端都可以单独测试。这里还有一个隐藏收益即使浏览器不支持的JPEG2000压缩格式也会在后端解码完成前端只看到标准PNG。需要注意DICOM中还有Overlay叠加层和Shutter快门遮挡打印时通常要保留这部分需要额外处理后面会提到。2.2 用dcm4che只读解析头信息和像素数据在Java生态里解析DICOM最常见的库是dcm4che。dcm4che读数据集时不能把文件当普通图片处理因为DICOM头里含有大量元数据像素数据在末尾。ImageIO的DICOM插件会把这两个部分分开先读Attributes再交给ImageReader读取。2.2.1 最小解析代码import org.dcm4che3.data.Attributes; import org.dcm4che3.data.Tag; import org.dcm4che3.imageio.plugins.dcm.DicomImageReadParam; import org.dcm4che3.io.DicomInputStream; import javax.imageio.ImageIO; import javax.imageio.ImageReader; import javax.imageio.stream.ImageInputStream; import java.awt.image.BufferedImage; import java.io.File; import java.util.Iterator; public class DicomToPrintImage { public static BufferedImage load(File dicom, int windowCenter, int windowWidth) throws Exception { // 先只读数据集不读像素区域 Attributes attrs; try (DicomInputStream dis new DicomInputStream(dicom)) { attrs dis.readDataset(-1, -1); } // dcm4che 在 ImageIO 里注册了 DICOM 插件 IteratorImageReader readers ImageIO.getImageReadersByFormatName(DICOM); if (!readers.hasNext()) { throw new IllegalStateException(未找到 DICOM ImageReader请确认 dcm4che-imageio 依赖); } ImageReader reader readers.next(); try (DicomInputStream dis new DicomInputStream(dicom); ImageInputStream iis ImageIO.createImageInputStream(dis)) { reader.setInput(iis, true, false); DicomImageReadParam param (DicomImageReadParam) reader.getDefaultReadParam(); // windowWidth 和 windowCenter 为 0 时交给 dcm4che 使用 DICOM 头里的默认显示参数 if (windowWidth 0 windowCenter 0) { param.setWindowWidth(windowWidth); param.setWindowCenter(windowCenter); } return reader.read(0, param); } finally { reader.dispose(); } } }readDataset(-1, -1)是读取整个数据集到内存兼容性最好但消耗内存大如果提前知道只需要某个序列可以换成流式读取。ImageIO.createImageInputStream(dis)负责把DICOM输入流转成标准ImageIO流reader.setInput(iis, true, false)里的true表示允许随机定位false表示不用静默模式。给DicomImageReadParam设置窗宽窗位后一部分dcm4che版本会直接输出应用过VOI LUT的图像如果输出仍是16bit灰度就需要做一次手动映射。public static BufferedImage applyWindow(BufferedImage src, int wc, int ww) { int w src.getWidth(); int h src.getHeight(); BufferedImage out new BufferedImage(w, h, BufferedImage.TYPE_BYTE_GRAY); int[] samples src.getRaster().getSamples(0, 0, w, h, (int[]) null); int min wc - ww / 2; int max wc ww / 2; int[] outPixels out.getRaster().getPixels(0, 0, w, h, (int[]) null); for (int i 0; i samples.length; i) { int v samples[i]; int o (v - min) * 255 / (max - min); outPixels[i] Math.max(0, Math.min(255, o)); } out.getRaster().setPixels(0, 0, w, h, outPixels); return out; }这段映射的输入是原始像素值输出是8bit灰度。wc - ww / 2和wc ww / 2分别对应映射范围的上下界低于下界的置黑高于上界的置白。这里的除法用的是整数除法如果窗宽为奇数下界会比理论值偏小一个像素医学打印里可以接受。需要留意有符号CT值和不同PhotometricInterpretation的情况实际项目中最好先从Attributes读PixelRepresentation再判断是否要转换符号位。2.3 窗口宽度/窗位参数在Web打印里的作用窗宽窗位可以理解成把CT值映射到人眼可见灰阶的“亮度对比度”。CT值范围通常是-1024到3071如果用16bit数据直接交给前端显示器或打印机只会看到一片黑。实际打印时先通过窗位指定关注的组织中心再用窗宽定义灰度覆盖范围。下表是CT几个常用显示参数注意这些值不是固定的不同机型、不同重建核会有偏差设计源码时要让前端可以覆盖后端默认值。部位/窗型Window CenterWindow Width胸部CT纵隔窗40400颅脑CT4080腹部CT40400骨窗3001500肺窗-6001500这些参数通常以两个DICOM标签WindowCenter和WindowWidth存在多个值代表有多套预设。打印时建议按实例选择一套并在打印预览上显示当前窗型名称。如果前端不传参数服务端就用Attributes里第一个值如果没有这个标签再使用上表的默认值兜底。提示dcm4che中的DicomImageReadParam并不是所有发行版都会自动应用窗宽窗位本地验证时最好打印一张带窗宽窗位的样图。2.4 处理灰度反转和覆盖层除了窗宽窗位DICOM的PhotometricInterpretation如果为MONOCHROME1表示值越小越亮很多DR和CR图像都用这种编码。打印时如果不处理骨骼会变成黑色诊断方向就全反了。常见做法是在解析时判断这个标签若是MONOCHROME1就对输出灰度做一次255 - v反转。覆盖层也容易漏。DICOM Overlay 可能由设备厂家写入记录照射野框、标记线等信息打印和诊断都要求保留。dcm4che可以把Overlay数据作为独立帧读出来再画到主图像上也可以忽略如果这是一个仅用于浏览的打印模块。3. 前端打印工作台从图像渲染到排版控制后端给出标准PNG后前端要解决的问题是“一张图放哪、一叠图怎么翻页”。如果直接用一个img标签放大缩小最后打印出来的图会变形如果强制按比例缩放又会在A4纸上留下大片空白。所以前端需要一个排版层把每个检查实例放到独立的“打印页”上。3.1 为什么不能用浏览器原生的window.print直接打Radiographwindow.print能打印HTML但打印机的默认页边距和纸张方向会吃掉很多可用区域。特别是DICOM图像本身可能是方形或竖屏需要按实际比例放入打印区域。另一个问题是浏览器打印时默认会尝试保留CSS颜色深色背景经常被原样打印出来既费墨又让灰阶图失去对比度。更关键的是医院里打印往往要和报告单结合需要显示患者姓名、检查号、序列描述。所以不能直接把整个阅片页面交给print必须构造一个独立的打印视图。3.2 用CSS分页构造打印排版用CSS分页最简单每个检查实例一个div.print-sheet在media print中设置page-break-after: always。如果图像数量很多可以先用canvas把同系列的多帧图像拼接成一张长图但拼接后的高度一旦超过纸张可打印区浏览器会自动裁切到下一页反而破坏排版。我的建议是一个sheet只放一张关键图除非医生勾选了连续打印。!DOCTYPE html html langzh head meta charsetUTF-8 titleDICOM打印预览/title style .print-sheet { width: 180mm; min-height: 265mm; margin: 0 auto; padding: 5mm; box-sizing: border-box; display: flex; align-items: center; justify-content: center; } .print-sheet img { max-width: 100%; max-height: 100%; object-fit: contain; } media print { page { size: A4 portrait; margin: 8mm; } body { margin: 0; padding: 0; } .print-sheet { page-break-after: always; break-after: page; width: 100%; height: 100%; min-height: 0; padding: 0; } } /style /head body div idprint-area/div script async function buildPrintView() { const items await fetch(/api/dicom/print-sheet?uid1.2.3).then(r r.json()); const area document.getElementById(print-area); area.innerHTML ; for (const item of items) { const sheet document.createElement(div); sheet.className print-sheet; const img document.createElement(img); img.src /api/dicom/image?file${encodeURIComponent(item.path)}wc${item.wc}ww${item.ww}; sheet.appendChild(img); area.appendChild(sheet); } } buildPrintView(); /script /body /htmlCSS里180mm和min-height:265mm是按A4纵向设计的如果浏览器打印设置里已指定横向这两个值需要对应调整。object-fit: contain保证图像比例不变且完整显示不会被拉伸。page-break-after是老牌写法break-after是新的标准属性两个都写兼容性更好。page里的margin:8mm会比系统默认小因为默认边距常有12mm以上对图像类打印不够用。3.3 打印参数表纸张、方向、边距参数典型值适用场景sizeA4 portrait单张报告、患者信息下方sizeA4 landscape双序列对比、多相位margin8mm ~ 12mm避免打印机边缘不可打印区图像最小宽度1024px对应约300dpi打印颜色空间GrayScale打印灰阶图不送RGB分辨率、方向、边距这些参数最好在打印预览弹窗里开放给用户调整而不是直接读取默认打印机设置。前端通过URL参数控制size和margin后端在生成打印任务时也会用到。3.4 多序列组图的排版策略一个检查里可能有多个序列比如CT平扫加增强。打印时医生通常只看几个关键层面而不是整包序列。前端可以做一个“序列选择器”默认只加载序列的第一张图用户点击“加入打印”后再加载其余图。相应的接口可以用批量instanceUid列表减少请求次数。具体做法就是在print-sheet接口返回JSON数组时带上每张图的selected字段前端根据它决定渲染哪几个sheet。4. 端到端整合Java接口与Web打印流的完整设计前两章的服务端和前端是独立模块这一章把链路打通。打印流程设计成三个接口查询打印任务、获取DICOM渲染图、提交打印任务。这样前端不需要关心DICOM解析细节后端也不需要在一次请求里把所有图像都渲染完。如果渲染很慢还可以把第三步改成异步任务。4.1 接口设计/api/dicom/print-sheet先给后端Controller的骨架RestController RequestMapping(/api/dicom) public class DicomPrintController { private final String imageRoot /data/pacs; GetMapping(/print-sheet) public ResponseEntityListPrintSheetItem getPrintSheet(RequestParam String seriesUid) { ListPrintSheetItem items dicomRepository.listInstances(seriesUid); return ResponseEntity.ok(items); } GetMapping(/image) public ResponseEntitybyte[] getImage(RequestParam String file, RequestParam(defaultValue 0) int wc, RequestParam(defaultValue 0) int ww) throws Exception { File dicom new File(imageRoot, file); if (!dicom.exists()) { return ResponseEntity.notFound().build(); } BufferedImage image DicomToPrintImage.load(dicom, wc, ww); ByteArrayOutputStream out new ByteArrayOutputStream(); ImageIO.write(image, PNG, out); return ResponseEntity.ok() .contentType(MediaType.IMAGE_PNG) .body(out.toByteArray()); } }/print-sheet接收seriesUid返回该序列包含哪些实例以及每张图的默认窗宽窗位。/image接收文件相对路径和窗口参数返回渲染后的PNG。生产环境里file应换成instanceUid由后端查库找到真实路径防止路径穿越。dicomRepository这里只是一个示意接口实际实现可能是查询PACS索引表或对象存储元数据。4.2 前端调度获取图像、合成排版、触发打印前端可以在新窗口打开预览页也可以在当前页面用iframe隐藏打印。新窗口的好处是打印参数独立不会影响阅片界面的样式。打开预览窗口后等afterprint事件触发再关闭使用者不容易误点。function openPrintPreview(seriesUid) { const url /print/preview.html?uid${encodeURIComponent(seriesUid)}; const win window.open(url, _blank, width900,height700); if (!win) { alert(浏览器阻止了弹窗请允许本站打开新窗口); return; } win.addEventListener(afterprint, () { win.close(); }); }注意afterprint事件在Firefox和Chrome中触发时机有差异有的浏览器在双击取消打印时不触发。更稳妥的做法是让预览页放一个“关闭”按钮不要完全依赖自动关闭。4.3 打印任务队列与状态回传当图像数量很多或网络较慢时逐张调用/api/dicom/image会占用大量HTTP连接。常见做法是后端先生成打印任务把渲染好的图片存到临时目录再给前端一个缩略图列表等用户确认后通过浏览器打印。任务接口可以这样设计接口作用典型返回POST /api/print/jobs创建打印任务jobIdGET /api/print/jobs/{id}查询渲染状态已渲染数/总数GET /api/print/jobs/{id}/sheet获取整个任务的打印页面HTML片段或PDF这个方案需要一台缓存服务器或本地磁盘保存临时文件建议对jobId设置30分钟过期时间防止磁盘堆积。打印任务队列还可以和上级系统集成把打印动作回传给报告医生方便审计。5. 进阶DICOM打印协议与Web打印的边界处理到这一步Web打印链路已经可以跑通。最后值得花时间的是边界场景踩过一次再回头调整成本比一开始就做得大得多。5.1 何时应该考虑DICOM Print SCU如果科室有PACS配套的医用胶片打印机并且要求出胶片Web方案只能做预览。真正的胶片打印需要走DICOM Print SCUJava端一般通过dcm4che建立Association提交Print Job到这一层需要配置AE Title、IP、端口并且要和胶片打印机厂商联调。如果坚持在Web里调用Print SCU还需要在前端架设WebSocket代理把浏览器事件转发到Java后端的Print SCU连接上打印状态很难同步不做成重试机制很容易丢任务。普通报告打印用本文的Web方案足够。5.2 验证打印结果的对位和清晰度打印一张带标尺的测试图用直尺量图像对角线误差应小于2mm灰度图要看16级黑白色块是否连续可辨。表格验证项合格标准图像尺寸与A4可打印区误差 2mm灰度阶16级灰阶可辨认患者信息与图像不重叠字号不小于6pt窗宽窗位骨窗和肺窗切换后灰阶明显变化5.3 常见边界与坑CSS里任何transform属性都会让浏览器打印结果变得模糊甚至空页打印视图里不要加。dcm4che解码大文件比如大矩阵CT序列后端要限制同时解码数量否则内存占用会直接拉垮。浏览器缩放比例也会影响mm单位打印预览最终以浏览器设置为准代码里不要试图强制覆盖page size。打印机的纸张来源也要检查有些医用胶片打印机默认纸槽是胶片规格普通A4走另一个纸槽纸张类型选不对会报错或卡纸。遇到预览正常但打印缺列的情况先检查打印比例是否为100%再检查sheet是否有固定宽度溢出。本文还有配套的精品资源点击获取