尧图网站建设 
简介面向Java桌面应用开发初学者与图形界面编程学习者这份电子相册源码演示了如何使用JavaFX或Swing构建照片管理工具内容涉及文件读写、图像处理、事件监听、多线程以及数据库连接等关键技术点。压缩包共10个文件其中核心源码文件可清晰查看程序逻辑编译后的运行类便于直接体验五张JPEG图片与一张BMP图片用作相册素材另有网页预览文件与说明文档帮助了解项目结构整个压缩包仅160KB轻量又完整。已有495人学习查看适合用来理解桌面程序界面布局、图片文件读取和照片信息保存的实现思路。从界面控件到事件响应再到图片数据和数据库元数据的协作代码层次清楚适合逐段研读读者还可以在此基础上继续扩展缩略图生成、图片旋转裁剪、按日期筛选等功能作为课程设计或自学练手项目都很合适。1. 一个 Java 电子相册源码包到底解决了什么照片一多按目录翻找就成了体力活与其用商业图库把文件传上云不如在本地跑一个把目录扫描、缩略图、标签和幻灯片播放串起来的 Java 项目。这就是 Java 电子相册源码.zip 这类包存在的原因它不是又一份 UI demo而是一个解压后能看懂、能改、能继续扩展的代码骨架。对刚把 Java 基础学完的人它把文件流、集合、Swing/JavaFX、线程和 JDBC 全用上了对有几年经验的人它又能很快改成内网素材库、实验室图片管理这类小工具。很多 Java 学习路线都会把这类项目放到简历实战里面试官也喜欢从扫描线程、数据库锁、缩略图缓存三处追问所以源码可以不大但边界必须清楚。拿到这种源码包别急着双击运行。先想清楚它要解决的是“照片堆积”还是“照片丢失”前者需要快速浏览分类后者需要增量索引和备份这两个方向写出来的数据模型完全不同。2. 拆解 Java 电子相册的功能边界与数据模型做一个电子相册不必做成在线图库。大部分源码标注的“电子相册”落到代码上只有四件事扫描磁盘目录、生成缩略图、按相册/标签展示、大图查看。能把四条链路做顺畅后面要加入脸分组或云备份都只是同一套数据模型上新增字段的事。所以第一件事不是写界面而是把功能边界和数据边界固定下来。2.1 先定功能边界本地照片、索引和展示从一张家庭照片到可浏览的相册中间隔着三条链路文件采集、元数据入库、界面渲染。文件采集要处理哪些目录、要不要跟随符号链接元数据要保存拍摄时间和文件摘要避免每次启动都全盘扫描界面渲染要处理缩略图加载失败、大图内存溢出这两类高频问题。常见做法是启动时选择“照片根目录”把目录下的 jpg/png/webp 文件扫出来写入本地索引库之后每次启动做增量扫描只处理新增和变化过的文件。这一层最容易写歪的地方是在扫描线程里直接刷新界面。扫描只负责把路径和时间戳写入待处理队列缩略图生成放到另一个线程池界面轮询数据库拿“已生成缩略图”的记录。否则用户选了十万张照片的目录相册窗口会卡死。2.2 数据模型SQLite 和 H2 怎么选源码包要给别人直接跑数据库不能要求额外安装所以选嵌入式数据库。常见选择是 SQLite 和 H2两者都能以单文件方式工作区别主要在两点SQLite 通过 JDBC 驱动访问适合轻量单写场景H2 有更完整的 SQL 支持和内置 Web Console适合需要调试数据接口的项目。判断点SQLiteH2驱动体积小xerial 驱动更轻更大自带 PG/MySQL 兼容模式并发模型一个进程一个写者支持 MVStore多连接读更好数据类型弱类型字段长度不强制强类型更适合常规 JavaBean 映射导出迁移单文件直接复制可做 SQL 脚本迁移适合场景纯本机相册、内网工具需要连管理界面、多人共用我一般会把缩略图路径和照片路径都存成绝对路径因为相册工具通常跑在固定机器上绝对路径便于直接写File操作。如果做跨平台分发则要额外保存“相对于根目录的相对路径”否则换一台电脑索引就断链。数据模型至少要有三张表照片表、相册表和标签表照片与标签用中间表关联照片与相册也用中间表关联。2.3 用 DDL 把相册表、标签表和缩略图表落下来下面是这套模型里最核心的建表语句源码包里如果有schema.sql多数也是这个骨架。CREATE TABLE photo ( id INTEGER PRIMARY KEY AUTOINCREMENT, path TEXT NOT NULL UNIQUE, file_size INTEGER NOT NULL, file_modified BIGINT NOT NULL, take_time TIMESTAMP, width INTEGER, height INTEGER, thumbnail_path TEXT, imported_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE album ( id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL UNIQUE, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE photo_album ( photo_id INTEGER NOT NULL, album_id INTEGER NOT NULL, PRIMARY KEY (photo_id, album_id) ); CREATE TABLE tag ( id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL UNIQUE ); CREATE TABLE photo_tag ( photo_id INTEGER NOT NULL, tag_id INTEGER NOT NULL, PRIMARY KEY (photo_id, tag_id) );这段 DDL 的核心在photo_album和photo_tag两张中间表相册和标签都与照片一对多但不直接给照片表加album_id字段因为一张照片可能同时出现在“旅行”“家庭”“2024年”多个集合里中间表保留多对多关系。file_modified存文件最后修改时间的 epoch 秒用来做增量扫描比对take_time来自 EXIF不一定每张图都有所以允许空。thumbnail_path单独成字段是为了删原图时能同步清理缩略图文件不需要再额外查一次关联表。建完表之后数据访问层只需要两个核心方法批量插入待扫描文件按file_modified查已存在记录。很多人会在这一步引入 MyBatis 或 Spring Data但一个本地相册用JdbcTemplate或纯 JDBC 就足够减少依赖反而让源码包更容易跑通。建表时要注意path上的 UNIQUE 约束它会在重复扫描时自动挡住重复照片省掉一次应用层查询。3. 用 Java 实现电子相册的核心链路扫描、缩略图与相册展示数据库落好以后程序的核心就变成三条链路扫文件、出缩略图、上屏展示。很多电子相册源码的 bug 都集中在扫描卡 UI、缩略图黑边、自动播放崩内存三件事上这一章的代码会直接对应到这些问题。3.1 目录扫描用 FileVisitor 而不是递归遍历扫描目录时最常见的写法是递归调用listFiles()但遇到大型目录树会产生大量临时File对象而且不方便跳过隐藏目录。用Files.walkFileTree配合FileVisitor可以把“进入目录、读取文件、出错恢复”三个时机分开处理。public final class PhotoScanner implements FileVisitorPath { private static final SetString EXTS Set.of(.jpg, .jpeg, .png, .webp, .bmp); private final QueuePath pending new ConcurrentLinkedQueue(); public void scan(Path root) throws IOException { Files.walkFileTree(root, this); } Override public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) { String name file.getFileName().toString().toLowerCase(); if (attrs.isRegularFile() EXTS.stream().anyMatch(name::endsWith)) { pending.offer(file); } return FileVisitResult.CONTINUE; } Override public FileVisitResult preVisitDirectory(Path dir, BasicFileAttributes attrs) { String name dir.getFileName() null ? : dir.getFileName().toString(); return name.startsWith(.) ? FileVisitResult.SKIP_SUBTREE : FileVisitResult.CONTINUE; } Override public FileVisitResult visitFileFailed(Path file, IOException exc) { System.err.println(read fail: file - exc.getMessage()); return FileVisitResult.CONTINUE; } Override public FileVisitResult postVisitDirectory(Path dir, IOException exc) { return FileVisitResult.CONTINUE; } }这段代码里EXTS用小写匹配避免系统出现.JPG和.jpg混用导致漏扫attrs.isRegularFile()过滤掉符号链接和目录避免把快捷方式也当成图片visitFileFailed返回CONTINUE而不是TERMINATE防止一张权限不足的照片让整个扫描中断。QueuePath用并发队列扫描线程和缩略图线程可以安全地传递文件列表。扫描完下一步要把路径写进photo表。表上有path UNIQUE约束重复跑同一目录会报错。常见做法不是先查一遍再插入而是用INSERT OR IGNORESQLite或MERGE INTOH2把“判断是否存在”交给数据库减少一次往返。3.2 缩略图生成先缩到 256px 再存盘缩略图直接决定相册首页能不能滑得流畅。用ImageIO.read()读原图生成缩略图在 JPEG 大图场景下会把整张图解码进内存二百张 5000 像素宽的照片就能吃满默认堆内存。正确顺序是先读图片头部尺寸按比例算缩放目标再生成缩略图并缓存到磁盘。BufferedImage thumbnail(BufferedImage source, int targetSize) { int type source.getType() 0 ? BufferedImage.TYPE_INT_ARGB : source.getType(); int w, h; if (source.getWidth() source.getHeight()) { w targetSize; h (int) Math.round(targetSize * (source.getHeight() / (double) source.getWidth())); } else { h targetSize; w (int) Math.round(targetSize * (source.getWidth() / (double) source.getHeight())); } BufferedImage out new BufferedImage(w, h, type); Graphics2D g out.createGraphics(); g.setRenderingHint(RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_BILINEAR); g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON); g.drawImage(source, 0, 0, w, h, null); g.dispose(); return out; }这里不建议用source.getScaledInstance(w, h, Image.SCALE_FAST)那个 API 返回的对象是异步缩放质量不稳定而且每次访问像素都可能重复计算。用Graphics2D.drawImage是目前 Java 自带的、可控性最高的缩放方案。如果想让相册网格整齐常见的做法是先把图居中裁剪成正方形再缩到 256px如果保留宽高比就要在JList或网格布局里预留比例修正。生成后的缩略图建议缓存到thumb/子目录文件名用原图path的 SHA-256 哈希值避免路径里的特殊字符影响文件系统。下表是三种缩略图方案的区别代码评审时可以直接引用方案内存占用图片质量适合场景ImageIO 整图缩放高一般小图集Graphics2D 直接绘制中好常规相册ImageReader 按目标尺寸解码最低依赖采样参数大量高分辨率图片3.3 相册面板与自动播放的线程模型Swing 相册界面通常用JList或JTable展示缩略图数据从数据库分批读取一次只加载 50 或 100 条避免一次性生成上千个ImageIcon。打开相册时先查photo_album关联表再通过缩略图路径加载缓存图。为了让磁盘 IO 不阻塞 EDT常见做法是后台线程查数据库得到路径列表EDT 用SwingWorker异步加载图片。class ThumbnailLoader extends SwingWorkerMapString, Icon, ThumbnailItem { private final ListString photoPaths; Override protected MapString, Icon doInBackground() { MapString, Icon result new LinkedHashMap(); for (String p : photoPaths) { Icon icon loadThumbFromCache(p); result.put(p, icon); publish(new ThumbnailItem(p, icon)); } return result; } Override protected void process(ListThumbnailItem chunks) { for (ThumbnailItem item : chunks) { listModel.set(item.path, item.icon); } } }使用SwingWorker的publish/process机制能避免每生成一张缩略图就SwingUtilities.invokeLater一次把多个 UI 更新挤压到同一个 EDT 周期里。自动播放一般用javax.swing.Timer每 3 秒切一张Timer在 EDT 上执行切换大图要从缓存里取缓存不命中就先用占位图占位再异步换图。很多老源码包的自动播放越播越慢原因是图像缓存没有上限给LinkedHashMap加一个removeEldestEntry重载就能限制最多缓存 100 张大图。4. 把源码整理成规范的 Java 工程并打 zip 发布源码包最终是给人解压后直接打开的目录结构比实现技巧更容易决定第一印象。Maven 工程放在根目录src/main/java按功能分包入口类只做依赖初始化扫描、缩略图、数据库、UI 各自独立这样代码才能被其他人快速定位。4.1 工程根目录拆成 src 和 tools入口类只做一件事photo-album/ ├── pom.xml ├── README.md ├── .gitignore ├── data/ ├── src/main/java/ │ └── com/example/photoalbum/ │ ├── Main.java │ ├── repository/ │ ├── scanner/ │ ├── thumbnail/ │ └── ui/ └── tools/ └── import-samples.sh结构里data/保存 SQLite 数据库文件不进源码包但要在.gitignore中保留目录名tools/只放与开发期相关的脚本不属于运行时逻辑。Main.java里只做数据源初始化、创建主窗口、注册关闭钩子三件事扫描逻辑放到scanner包缩略图逻辑放到thumbnail包。入口类写得太胖的源码包往往也意味着类之间的依赖关系没有拆开。4.2 用 .gitignore 和构建插件控制 zip 内容没有.gitignore时打 zip 很容易把.idea/、target/、*.class一起塞进去。源码包要保证“用 git 管理时不会误提交 IDE 配置”所以.gitignore至少包含下面的内容target/ out/ *.class *.log .idea/ *.iml .vscode/ data/* !data/.gitkeeptarget/排除 Maven 构建目录out/排除 IDEA 默认输出目录最后两行保留data目录但忽略里面的数据库文件。对应的 zip 打包命令可以写成zip -r photo-album-src.zip photo-album/ \ -x photo-album/target/* \ -x photo-album/.git/* \ -x photo-album/.idea/*如果需要控制“哪些必须进包、哪些必须排除”可以按下面这张表核对必须保留必须排除pom.xml、src/、README.mdtarget/、out/、.idea/.gitignore、license 文件data/.db、.log、*.class配置文件模板本机绝对路径的启动参数4.3 利用 Maven 插件一键产出源码包命令行 zip 适合临时分发但源码包要配合 CI 重复构建更可控的做法是用 Maven 的maven-source-plugin生成 sources jar再用 assembly 插件把整个工程打成可分发包。下面这段pom.xml是源码工程最常见的基础配置properties maven.compiler.source17/maven.compiler.source maven.compiler.target17/maven.compiler.target project.build.sourceEncodingUTF-8/project.build.sourceEncoding /properties dependencies dependency groupIdorg.xerial/groupId artifactIdsqlite-jdbc/artifactId version3.45.1.0/version /dependency /dependencies build plugins plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-source-plugin/artifactId version3.3.1/version executions execution idattach-sources/id goalsgoaljar-no-fork/goal/goals /execution /executions /plugin /plugins /buildmaven.compiler.source指定 Java 17project.build.sourceEncoding强制 UTF-8否则 Windows 和 Linux 跨平台解压后注释容易乱码。sqlite-jdbc 的版本要固定到具体数字不能写3.这种范围因为源码包交付后没人保证未来驱动还兼容当时的 JDK。打完包后用unzip -l photo-album-src.zip看一眼文件清单重点确认pom.xml、src/main/java存在target/和本地数据库文件不在清单里。5. 从源码包到可运行程序构建脚本、参数调优和坑源码包真正值钱的地方在于“能改”。很多 Java 学习者拿到代码后遇到的第一个问题不是看不懂业务逻辑而是构建不过、图片乱码、相册窗口一打开就 OOM。这一章把三个高频坑的解法直接放出来。5.1 读大图前先读尺寸避免整图加载撑爆堆内存看大图时直接用ImageIO.read(file)会把一张 3000x4000 的 JPEG 完整解码成 RGBA大约占用 48MB。看似不多但连续翻图时前一张没有被及时 GC堆内存就会快速增长。要避免这个问题先在不解码像素的情况下取尺寸try (ImageInputStream in ImageIO.createImageInputStream(file)) { IteratorImageReader readers ImageIO.getImageReaders(in); int width -1; int height -1; while (readers.hasNext()) { ImageReader reader readers.next(); try { reader.setInput(in, true, true); width reader.getWidth(0); height reader.getHeight(0); break; } finally { reader.dispose(); } } }这段代码通过reader.getWidth(0)只解析文件头不触碰像素数据。拿到的尺寸可以做两件事超过 2000px 的大图先按比例降到显示区域大小再渲染同时把图片按“最近浏览窗口”缓存比如只缓存前后各 5 张大图超过窗口的引用立刻置空让 GC 及时回收。5.2 图片旋转是 EXIF 处理里最常见的“歪图”坑手机拍的照片会写 EXIF 方向字段相册若不处理竖拍图可能横着显示。这个“歪”不是让用户旋转原图而是要在读取缩略图和大图时把方向折算到坐标变换里。常见做法是先读 EXIF Orientation再按值旋转BufferedImage rotateByExif(BufferedImage img, int orientation) { if (orientation 1) return img; int width img.getWidth(); int height img.getHeight(); AffineTransform at new AffineTransform(); switch (orientation) { case 3 - at.rotate(Math.toRadians(180), width / 2.0, height / 2.0); case 6 - { at.translate(height, 0); at.rotate(Math.toRadians(90), 0, 0); } case 8 - { at.translate(0, width); at.rotate(Math.toRadians(270), 0, 0); } default - { return img; } } BufferedImage rotated new BufferedImage(height, width, BufferedImage.TYPE_INT_ARGB); Graphics2D g rotated.createGraphics(); g.setTransform(at); g.drawImage(img, 0, 0, null); g.dispose(); return rotated; }Orientation 为 6 和 8 时旋转后宽高互换画布要写成height, width否则图像会被裁掉一半。缩略图可以在入库时就应用旋转并存入缩略图文件大图每次显示还要再做一次方向转换所以缩略图和大图的处理逻辑不能完全共用。5.3 JVM 参数和日志配置源码包内置的启动脚本里至少要把堆内存上限写出来不要放任 JVM 默认值。常见启动脚本是java -Xms256m -Xmx1024m \ -Dfile.encodingUTF-8 \ -Duser.languagezh \ -jar photo-album.jar-Xmx1024m限制最大堆防止相册一直翻图把内存吃满-Dfile.encodingUTF-8解决 Windows 默认 GBK 下读取中文路径的乱码问题-Duser.languagezh让 Swing 组件语言环境一致避免文件对话框和菜单语言混用。如果用户目录照片特别多堆上限可以放宽到 2048m但翻页时 GC 停顿会更明显。日志建议直接走java.util.logging不要在源码包里捆绑重量级日志框架。电子相册不是服务端日志只有两个职责记录扫描失败的路径记录缩略图生成异常。把日志写到logs/目录不要和图片文件混在一起。数据库打不开时程序要弹出错误对话框而不是静默退出这也是很多源码包的盲区。症状可能原因处理启动即 OOM未设置-Xmx或值太小修改启动脚本堆参数中文路径显示为问号文件读取编码不是 UTF-8增加-Dfile.encodingUTF-8相册窗口白屏缩略图在 EDT 同步加载改用 SwingWorker 后在process更新SQL 报 database is locked多线程共用同一 SQLite 连接扫描线程和缩略图线程分连接6. 最后一步验证源码包的完整性与可复现构建源码包作为 zip 交付前我会做四步检查解压完整性、文件编码、依赖解析、干净构建。第一步是命令级验证unzip -t photo-album-src.zip如果输出里出现CRC error或bad file descriptor说明 zip 在传输或打包过程中已经损坏绝不能发布。第二步是删除临时目录把 zip 解压到全新路径再运行mvn -q clean verify。clean的作用是删掉上次构建的target/让构建过程不依赖任何历史产物。第三步是检查 README 里写的构建命令是否能照着执行。README 不需要长篇教程只要写清 JDK 版本、mvn package后的产物位置、第一次运行会生成什么文件。不要写“需要另外安装数据库”因为嵌入式数据库自己带也不要在 README 里引用开发机器上的绝对路径。最后一步是检查 zip 根目录名。如果解压出来是photo-album-master文件全在带随机后缀的目录里用户很难处理。正确做法是先建一个photo-album/目录把工程内容放进去再打包cd .. zip -r photo-album-src.zip photo-album/ \ -x photo-album/target/* \ -x photo-album/.git/*打完包后还要做一次反向检查把 zip 解压到/tmp/verify在解压目录里直接mvn -q package。这个动作能发现两种隐蔽问题一是打包时漏掉测试资源二是 pom 依赖了个人私有仓库的包。若出现“无法解析依赖”的情况要把依赖换回 Maven Central 上的公共版本否则源码包交到别人手里无法构建。每次修改代码后重新打 zip都应在全新目录里跑一遍构建并同步更新 SHA-256 校验值。等到unzip -t、mvn -q package和校验值对比这三项都通过这份 Java 电子相册源码包才算真正达到了“可分发”的状态。本文还有配套的精品资源点击获取 Java电子相册源码包实战：扫描、缩略图与SQLite存储
简介面向Java桌面应用开发初学者与图形界面编程学习者这份电子相册源码演示了如何使用JavaFX或Swing构建照片管理工具内容涉及文件读写、图像处理、事件监听、多线程以及数据库连接等关键技术点。压缩包共10个文件其中核心源码文件可清晰查看程序逻辑编译后的运行类便于直接体验五张JPEG图片与一张BMP图片用作相册素材另有网页预览文件与说明文档帮助了解项目结构整个压缩包仅160KB轻量又完整。已有495人学习查看适合用来理解桌面程序界面布局、图片文件读取和照片信息保存的实现思路。从界面控件到事件响应再到图片数据和数据库元数据的协作代码层次清楚适合逐段研读读者还可以在此基础上继续扩展缩略图生成、图片旋转裁剪、按日期筛选等功能作为课程设计或自学练手项目都很合适。1. 一个 Java 电子相册源码包到底解决了什么照片一多按目录翻找就成了体力活与其用商业图库把文件传上云不如在本地跑一个把目录扫描、缩略图、标签和幻灯片播放串起来的 Java 项目。这就是 Java 电子相册源码.zip 这类包存在的原因它不是又一份 UI demo而是一个解压后能看懂、能改、能继续扩展的代码骨架。对刚把 Java 基础学完的人它把文件流、集合、Swing/JavaFX、线程和 JDBC 全用上了对有几年经验的人它又能很快改成内网素材库、实验室图片管理这类小工具。很多 Java 学习路线都会把这类项目放到简历实战里面试官也喜欢从扫描线程、数据库锁、缩略图缓存三处追问所以源码可以不大但边界必须清楚。拿到这种源码包别急着双击运行。先想清楚它要解决的是“照片堆积”还是“照片丢失”前者需要快速浏览分类后者需要增量索引和备份这两个方向写出来的数据模型完全不同。2. 拆解 Java 电子相册的功能边界与数据模型做一个电子相册不必做成在线图库。大部分源码标注的“电子相册”落到代码上只有四件事扫描磁盘目录、生成缩略图、按相册/标签展示、大图查看。能把四条链路做顺畅后面要加入脸分组或云备份都只是同一套数据模型上新增字段的事。所以第一件事不是写界面而是把功能边界和数据边界固定下来。2.1 先定功能边界本地照片、索引和展示从一张家庭照片到可浏览的相册中间隔着三条链路文件采集、元数据入库、界面渲染。文件采集要处理哪些目录、要不要跟随符号链接元数据要保存拍摄时间和文件摘要避免每次启动都全盘扫描界面渲染要处理缩略图加载失败、大图内存溢出这两类高频问题。常见做法是启动时选择“照片根目录”把目录下的 jpg/png/webp 文件扫出来写入本地索引库之后每次启动做增量扫描只处理新增和变化过的文件。这一层最容易写歪的地方是在扫描线程里直接刷新界面。扫描只负责把路径和时间戳写入待处理队列缩略图生成放到另一个线程池界面轮询数据库拿“已生成缩略图”的记录。否则用户选了十万张照片的目录相册窗口会卡死。2.2 数据模型SQLite 和 H2 怎么选源码包要给别人直接跑数据库不能要求额外安装所以选嵌入式数据库。常见选择是 SQLite 和 H2两者都能以单文件方式工作区别主要在两点SQLite 通过 JDBC 驱动访问适合轻量单写场景H2 有更完整的 SQL 支持和内置 Web Console适合需要调试数据接口的项目。判断点SQLiteH2驱动体积小xerial 驱动更轻更大自带 PG/MySQL 兼容模式并发模型一个进程一个写者支持 MVStore多连接读更好数据类型弱类型字段长度不强制强类型更适合常规 JavaBean 映射导出迁移单文件直接复制可做 SQL 脚本迁移适合场景纯本机相册、内网工具需要连管理界面、多人共用我一般会把缩略图路径和照片路径都存成绝对路径因为相册工具通常跑在固定机器上绝对路径便于直接写File操作。如果做跨平台分发则要额外保存“相对于根目录的相对路径”否则换一台电脑索引就断链。数据模型至少要有三张表照片表、相册表和标签表照片与标签用中间表关联照片与相册也用中间表关联。2.3 用 DDL 把相册表、标签表和缩略图表落下来下面是这套模型里最核心的建表语句源码包里如果有schema.sql多数也是这个骨架。CREATE TABLE photo ( id INTEGER PRIMARY KEY AUTOINCREMENT, path TEXT NOT NULL UNIQUE, file_size INTEGER NOT NULL, file_modified BIGINT NOT NULL, take_time TIMESTAMP, width INTEGER, height INTEGER, thumbnail_path TEXT, imported_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE album ( id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL UNIQUE, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE photo_album ( photo_id INTEGER NOT NULL, album_id INTEGER NOT NULL, PRIMARY KEY (photo_id, album_id) ); CREATE TABLE tag ( id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL UNIQUE ); CREATE TABLE photo_tag ( photo_id INTEGER NOT NULL, tag_id INTEGER NOT NULL, PRIMARY KEY (photo_id, tag_id) );这段 DDL 的核心在photo_album和photo_tag两张中间表相册和标签都与照片一对多但不直接给照片表加album_id字段因为一张照片可能同时出现在“旅行”“家庭”“2024年”多个集合里中间表保留多对多关系。file_modified存文件最后修改时间的 epoch 秒用来做增量扫描比对take_time来自 EXIF不一定每张图都有所以允许空。thumbnail_path单独成字段是为了删原图时能同步清理缩略图文件不需要再额外查一次关联表。建完表之后数据访问层只需要两个核心方法批量插入待扫描文件按file_modified查已存在记录。很多人会在这一步引入 MyBatis 或 Spring Data但一个本地相册用JdbcTemplate或纯 JDBC 就足够减少依赖反而让源码包更容易跑通。建表时要注意path上的 UNIQUE 约束它会在重复扫描时自动挡住重复照片省掉一次应用层查询。3. 用 Java 实现电子相册的核心链路扫描、缩略图与相册展示数据库落好以后程序的核心就变成三条链路扫文件、出缩略图、上屏展示。很多电子相册源码的 bug 都集中在扫描卡 UI、缩略图黑边、自动播放崩内存三件事上这一章的代码会直接对应到这些问题。3.1 目录扫描用 FileVisitor 而不是递归遍历扫描目录时最常见的写法是递归调用listFiles()但遇到大型目录树会产生大量临时File对象而且不方便跳过隐藏目录。用Files.walkFileTree配合FileVisitor可以把“进入目录、读取文件、出错恢复”三个时机分开处理。public final class PhotoScanner implements FileVisitorPath { private static final SetString EXTS Set.of(.jpg, .jpeg, .png, .webp, .bmp); private final QueuePath pending new ConcurrentLinkedQueue(); public void scan(Path root) throws IOException { Files.walkFileTree(root, this); } Override public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) { String name file.getFileName().toString().toLowerCase(); if (attrs.isRegularFile() EXTS.stream().anyMatch(name::endsWith)) { pending.offer(file); } return FileVisitResult.CONTINUE; } Override public FileVisitResult preVisitDirectory(Path dir, BasicFileAttributes attrs) { String name dir.getFileName() null ? : dir.getFileName().toString(); return name.startsWith(.) ? FileVisitResult.SKIP_SUBTREE : FileVisitResult.CONTINUE; } Override public FileVisitResult visitFileFailed(Path file, IOException exc) { System.err.println(read fail: file - exc.getMessage()); return FileVisitResult.CONTINUE; } Override public FileVisitResult postVisitDirectory(Path dir, IOException exc) { return FileVisitResult.CONTINUE; } }这段代码里EXTS用小写匹配避免系统出现.JPG和.jpg混用导致漏扫attrs.isRegularFile()过滤掉符号链接和目录避免把快捷方式也当成图片visitFileFailed返回CONTINUE而不是TERMINATE防止一张权限不足的照片让整个扫描中断。QueuePath用并发队列扫描线程和缩略图线程可以安全地传递文件列表。扫描完下一步要把路径写进photo表。表上有path UNIQUE约束重复跑同一目录会报错。常见做法不是先查一遍再插入而是用INSERT OR IGNORESQLite或MERGE INTOH2把“判断是否存在”交给数据库减少一次往返。3.2 缩略图生成先缩到 256px 再存盘缩略图直接决定相册首页能不能滑得流畅。用ImageIO.read()读原图生成缩略图在 JPEG 大图场景下会把整张图解码进内存二百张 5000 像素宽的照片就能吃满默认堆内存。正确顺序是先读图片头部尺寸按比例算缩放目标再生成缩略图并缓存到磁盘。BufferedImage thumbnail(BufferedImage source, int targetSize) { int type source.getType() 0 ? BufferedImage.TYPE_INT_ARGB : source.getType(); int w, h; if (source.getWidth() source.getHeight()) { w targetSize; h (int) Math.round(targetSize * (source.getHeight() / (double) source.getWidth())); } else { h targetSize; w (int) Math.round(targetSize * (source.getWidth() / (double) source.getHeight())); } BufferedImage out new BufferedImage(w, h, type); Graphics2D g out.createGraphics(); g.setRenderingHint(RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_BILINEAR); g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON); g.drawImage(source, 0, 0, w, h, null); g.dispose(); return out; }这里不建议用source.getScaledInstance(w, h, Image.SCALE_FAST)那个 API 返回的对象是异步缩放质量不稳定而且每次访问像素都可能重复计算。用Graphics2D.drawImage是目前 Java 自带的、可控性最高的缩放方案。如果想让相册网格整齐常见的做法是先把图居中裁剪成正方形再缩到 256px如果保留宽高比就要在JList或网格布局里预留比例修正。生成后的缩略图建议缓存到thumb/子目录文件名用原图path的 SHA-256 哈希值避免路径里的特殊字符影响文件系统。下表是三种缩略图方案的区别代码评审时可以直接引用方案内存占用图片质量适合场景ImageIO 整图缩放高一般小图集Graphics2D 直接绘制中好常规相册ImageReader 按目标尺寸解码最低依赖采样参数大量高分辨率图片3.3 相册面板与自动播放的线程模型Swing 相册界面通常用JList或JTable展示缩略图数据从数据库分批读取一次只加载 50 或 100 条避免一次性生成上千个ImageIcon。打开相册时先查photo_album关联表再通过缩略图路径加载缓存图。为了让磁盘 IO 不阻塞 EDT常见做法是后台线程查数据库得到路径列表EDT 用SwingWorker异步加载图片。class ThumbnailLoader extends SwingWorkerMapString, Icon, ThumbnailItem { private final ListString photoPaths; Override protected MapString, Icon doInBackground() { MapString, Icon result new LinkedHashMap(); for (String p : photoPaths) { Icon icon loadThumbFromCache(p); result.put(p, icon); publish(new ThumbnailItem(p, icon)); } return result; } Override protected void process(ListThumbnailItem chunks) { for (ThumbnailItem item : chunks) { listModel.set(item.path, item.icon); } } }使用SwingWorker的publish/process机制能避免每生成一张缩略图就SwingUtilities.invokeLater一次把多个 UI 更新挤压到同一个 EDT 周期里。自动播放一般用javax.swing.Timer每 3 秒切一张Timer在 EDT 上执行切换大图要从缓存里取缓存不命中就先用占位图占位再异步换图。很多老源码包的自动播放越播越慢原因是图像缓存没有上限给LinkedHashMap加一个removeEldestEntry重载就能限制最多缓存 100 张大图。4. 把源码整理成规范的 Java 工程并打 zip 发布源码包最终是给人解压后直接打开的目录结构比实现技巧更容易决定第一印象。Maven 工程放在根目录src/main/java按功能分包入口类只做依赖初始化扫描、缩略图、数据库、UI 各自独立这样代码才能被其他人快速定位。4.1 工程根目录拆成 src 和 tools入口类只做一件事photo-album/ ├── pom.xml ├── README.md ├── .gitignore ├── data/ ├── src/main/java/ │ └── com/example/photoalbum/ │ ├── Main.java │ ├── repository/ │ ├── scanner/ │ ├── thumbnail/ │ └── ui/ └── tools/ └── import-samples.sh结构里data/保存 SQLite 数据库文件不进源码包但要在.gitignore中保留目录名tools/只放与开发期相关的脚本不属于运行时逻辑。Main.java里只做数据源初始化、创建主窗口、注册关闭钩子三件事扫描逻辑放到scanner包缩略图逻辑放到thumbnail包。入口类写得太胖的源码包往往也意味着类之间的依赖关系没有拆开。4.2 用 .gitignore 和构建插件控制 zip 内容没有.gitignore时打 zip 很容易把.idea/、target/、*.class一起塞进去。源码包要保证“用 git 管理时不会误提交 IDE 配置”所以.gitignore至少包含下面的内容target/ out/ *.class *.log .idea/ *.iml .vscode/ data/* !data/.gitkeeptarget/排除 Maven 构建目录out/排除 IDEA 默认输出目录最后两行保留data目录但忽略里面的数据库文件。对应的 zip 打包命令可以写成zip -r photo-album-src.zip photo-album/ \ -x photo-album/target/* \ -x photo-album/.git/* \ -x photo-album/.idea/*如果需要控制“哪些必须进包、哪些必须排除”可以按下面这张表核对必须保留必须排除pom.xml、src/、README.mdtarget/、out/、.idea/.gitignore、license 文件data/.db、.log、*.class配置文件模板本机绝对路径的启动参数4.3 利用 Maven 插件一键产出源码包命令行 zip 适合临时分发但源码包要配合 CI 重复构建更可控的做法是用 Maven 的maven-source-plugin生成 sources jar再用 assembly 插件把整个工程打成可分发包。下面这段pom.xml是源码工程最常见的基础配置properties maven.compiler.source17/maven.compiler.source maven.compiler.target17/maven.compiler.target project.build.sourceEncodingUTF-8/project.build.sourceEncoding /properties dependencies dependency groupIdorg.xerial/groupId artifactIdsqlite-jdbc/artifactId version3.45.1.0/version /dependency /dependencies build plugins plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-source-plugin/artifactId version3.3.1/version executions execution idattach-sources/id goalsgoaljar-no-fork/goal/goals /execution /executions /plugin /plugins /buildmaven.compiler.source指定 Java 17project.build.sourceEncoding强制 UTF-8否则 Windows 和 Linux 跨平台解压后注释容易乱码。sqlite-jdbc 的版本要固定到具体数字不能写3.这种范围因为源码包交付后没人保证未来驱动还兼容当时的 JDK。打完包后用unzip -l photo-album-src.zip看一眼文件清单重点确认pom.xml、src/main/java存在target/和本地数据库文件不在清单里。5. 从源码包到可运行程序构建脚本、参数调优和坑源码包真正值钱的地方在于“能改”。很多 Java 学习者拿到代码后遇到的第一个问题不是看不懂业务逻辑而是构建不过、图片乱码、相册窗口一打开就 OOM。这一章把三个高频坑的解法直接放出来。5.1 读大图前先读尺寸避免整图加载撑爆堆内存看大图时直接用ImageIO.read(file)会把一张 3000x4000 的 JPEG 完整解码成 RGBA大约占用 48MB。看似不多但连续翻图时前一张没有被及时 GC堆内存就会快速增长。要避免这个问题先在不解码像素的情况下取尺寸try (ImageInputStream in ImageIO.createImageInputStream(file)) { IteratorImageReader readers ImageIO.getImageReaders(in); int width -1; int height -1; while (readers.hasNext()) { ImageReader reader readers.next(); try { reader.setInput(in, true, true); width reader.getWidth(0); height reader.getHeight(0); break; } finally { reader.dispose(); } } }这段代码通过reader.getWidth(0)只解析文件头不触碰像素数据。拿到的尺寸可以做两件事超过 2000px 的大图先按比例降到显示区域大小再渲染同时把图片按“最近浏览窗口”缓存比如只缓存前后各 5 张大图超过窗口的引用立刻置空让 GC 及时回收。5.2 图片旋转是 EXIF 处理里最常见的“歪图”坑手机拍的照片会写 EXIF 方向字段相册若不处理竖拍图可能横着显示。这个“歪”不是让用户旋转原图而是要在读取缩略图和大图时把方向折算到坐标变换里。常见做法是先读 EXIF Orientation再按值旋转BufferedImage rotateByExif(BufferedImage img, int orientation) { if (orientation 1) return img; int width img.getWidth(); int height img.getHeight(); AffineTransform at new AffineTransform(); switch (orientation) { case 3 - at.rotate(Math.toRadians(180), width / 2.0, height / 2.0); case 6 - { at.translate(height, 0); at.rotate(Math.toRadians(90), 0, 0); } case 8 - { at.translate(0, width); at.rotate(Math.toRadians(270), 0, 0); } default - { return img; } } BufferedImage rotated new BufferedImage(height, width, BufferedImage.TYPE_INT_ARGB); Graphics2D g rotated.createGraphics(); g.setTransform(at); g.drawImage(img, 0, 0, null); g.dispose(); return rotated; }Orientation 为 6 和 8 时旋转后宽高互换画布要写成height, width否则图像会被裁掉一半。缩略图可以在入库时就应用旋转并存入缩略图文件大图每次显示还要再做一次方向转换所以缩略图和大图的处理逻辑不能完全共用。5.3 JVM 参数和日志配置源码包内置的启动脚本里至少要把堆内存上限写出来不要放任 JVM 默认值。常见启动脚本是java -Xms256m -Xmx1024m \ -Dfile.encodingUTF-8 \ -Duser.languagezh \ -jar photo-album.jar-Xmx1024m限制最大堆防止相册一直翻图把内存吃满-Dfile.encodingUTF-8解决 Windows 默认 GBK 下读取中文路径的乱码问题-Duser.languagezh让 Swing 组件语言环境一致避免文件对话框和菜单语言混用。如果用户目录照片特别多堆上限可以放宽到 2048m但翻页时 GC 停顿会更明显。日志建议直接走java.util.logging不要在源码包里捆绑重量级日志框架。电子相册不是服务端日志只有两个职责记录扫描失败的路径记录缩略图生成异常。把日志写到logs/目录不要和图片文件混在一起。数据库打不开时程序要弹出错误对话框而不是静默退出这也是很多源码包的盲区。症状可能原因处理启动即 OOM未设置-Xmx或值太小修改启动脚本堆参数中文路径显示为问号文件读取编码不是 UTF-8增加-Dfile.encodingUTF-8相册窗口白屏缩略图在 EDT 同步加载改用 SwingWorker 后在process更新SQL 报 database is locked多线程共用同一 SQLite 连接扫描线程和缩略图线程分连接6. 最后一步验证源码包的完整性与可复现构建源码包作为 zip 交付前我会做四步检查解压完整性、文件编码、依赖解析、干净构建。第一步是命令级验证unzip -t photo-album-src.zip如果输出里出现CRC error或bad file descriptor说明 zip 在传输或打包过程中已经损坏绝不能发布。第二步是删除临时目录把 zip 解压到全新路径再运行mvn -q clean verify。clean的作用是删掉上次构建的target/让构建过程不依赖任何历史产物。第三步是检查 README 里写的构建命令是否能照着执行。README 不需要长篇教程只要写清 JDK 版本、mvn package后的产物位置、第一次运行会生成什么文件。不要写“需要另外安装数据库”因为嵌入式数据库自己带也不要在 README 里引用开发机器上的绝对路径。最后一步是检查 zip 根目录名。如果解压出来是photo-album-master文件全在带随机后缀的目录里用户很难处理。正确做法是先建一个photo-album/目录把工程内容放进去再打包cd .. zip -r photo-album-src.zip photo-album/ \ -x photo-album/target/* \ -x photo-album/.git/*打完包后还要做一次反向检查把 zip 解压到/tmp/verify在解压目录里直接mvn -q package。这个动作能发现两种隐蔽问题一是打包时漏掉测试资源二是 pom 依赖了个人私有仓库的包。若出现“无法解析依赖”的情况要把依赖换回 Maven Central 上的公共版本否则源码包交到别人手里无法构建。每次修改代码后重新打 zip都应在全新目录里跑一遍构建并同步更新 SHA-256 校验值。等到unzip -t、mvn -q package和校验值对比这三项都通过这份 Java 电子相册源码包才算真正达到了“可分发”的状态。本文还有配套的精品资源点击获取