
本文详解如何使用 Files.readAttributes() 与 DosFileAttributes 批量读取、序列化并精准还原 Windows 文件的全部原生属性(如隐藏、系统、只读、存档等),避免逐个调用 getAttribute/setAttribute 带来的性能损耗与逻辑遗漏。
本文详解如何使用 files.readattributes() 与 dosfileattributes 批量读取、序列化并精准还原 windows 文件的全部原生属性(如隐藏、系统、只读、存档等),避免逐个调用 getattribute/setattribute 带来的性能损耗与逻辑遗漏。
在开发跨平台备份工具(尤其面向 Windows 环境)时,仅恢复文件内容远远不够——元数据完整性(metadata fidelity)至关重要。例如 desktop.ini、Thumbs.db 或驱动程序文件常被标记为“系统 + 隐藏”双属性,若仅调用 Files.setAttribute(path, "dos:hidden", true),将丢失 dos:system 属性,导致资源管理器无法正确识别其系统身份,甚至影响 Shell 扩展行为。
Java NIO.2 自 Java 7 起提供平台专属属性支持,其中 DosFileAttributes 接口专为 Windows FAT/NTFS 文件系统设计,可一次性读取全部 DOS 属性字段,是解决该问题的官方、高效且类型安全的方案。
✅ 一次性读取全部 Windows 文件属性
import java.io.IOException;
import java.nio.file.*;
import java.nio.file.attribute.DosFileAttributes;
public class DosAttributeReader {
public static DosFileAttributes readAllDosAttributes(Path path) throws IOException {
return Files.readAttributes(path, DosFileAttributes.class);
}
public static void main(String[] args) {
Path file = Paths.get("desktop.ini");
try {
DosFileAttributes attrs = readAllDosAttributes(file);
System.out.println("文件: " + file);
System.out.println("→ 隐藏: " + attrs.isHidden());
System.out.println("→ 系统: " + attrs.isSystem());
System.out.println("→ 只读: " + attrs.isReadOnly());
System.out.println("→ 存档: " + attrs.isArchive());
System.out.println("→ 创建时间: " + attrs.creationTime());
System.out.println("→ 最后修改: " + attrs.lastModifiedTime());
System.out.println("→ 最后访问: " + attrs.lastAccessTime());
System.out.println("→ 大小: " + attrs.size() + " 字节");
} catch (IOException e) {
System.err.println("读取 DOS 属性失败: " + e.getMessage());
}
}
}? 关键优势:
Files.readAttributes(path, DosFileAttributes.class)底层调用 Windows APIGetFileInformationByHandle,单次系统调用即可获取全部字段,相比循环调用Files.getAttribute(path, "dos:xxx")(每次触发独立 syscall),性能提升显著,尤其在批量恢复数百个系统文件时。
✅ 安全还原全部属性(含系统/隐藏组合)
还原时需注意:DosFileAttributeView 是唯一能写入 dos:system 和 dos:hidden 的视图,且必须通过 Files.getFileAttributeView() 获取:
立即学习“Java免费学习笔记(深入)”;
import java.io.IOException;
import java.nio.file.*;
import java.nio.file.attribute.DosFileAttributeView;
import java.nio.file.attribute.DosFileAttributes;
public class DosAttributeRestorer {
/**
* 将源文件的全部 DOS 属性(含 system/hidden 组合)完整还原到目标文件
*/
public static void restoreDosAttributes(Path source, Path target) throws IOException {
// 1. 读取源文件所有 DOS 属性
DosFileAttributes srcAttrs = Files.readAttributes(source, DosFileAttributes.class);
// 2. 获取目标文件的 DOS 视图(必须!普通 setAttribute 不支持 system/hidden 写入)
DosFileAttributeView view = Files.getFileAttributeView(target, DosFileAttributeView.class);
if (view == null) {
throw new UnsupportedOperationException("目标文件系统不支持 DOS 属性视图");
}
// 3. 一次性设置全部可写属性(顺序无关,底层原子写入)
view.setHidden(srcAttrs.isHidden());
view.setSystem(srcAttrs.isSystem());
view.setReadOnly(srcAttrs.isReadOnly());
view.setArchive(srcAttrs.isArchive());
}
// 示例:备份时序列化属性(可用于网络传输)
public static DosFileAttributes captureAttributes(Path file) throws IOException {
return Files.readAttributes(file, DosFileAttributes.class);
}
// 示例:还原时反序列化并应用(假设已通过 Socket 接收属性对象)
public static void applyAttributes(Path target, DosFileAttributes attrs) throws IOException {
DosFileAttributeView view = Files.getFileAttributeView(target, DosFileAttributeView.class);
view.setHidden(attrs.isHidden());
view.setSystem(attrs.isSystem());
view.setReadOnly(attrs.isReadOnly());
view.setArchive(attrs.isArchive());
}
}⚠️ 重要注意事项与兼容性说明
-
dos:system和dos:hidden是 Windows 特有属性:仅在 NTFS/FAT32 卷上有效;Linux/macOS 不支持,调用会抛UnsupportedOperationException。 -
权限要求:设置
dos:system属性需进程具有SeRestorePrivilege(通常管理员权限),普通用户进程可能静默失败或仅设hidden。建议在还原前检查view.supportsFileAttributeView(DosFileAttributeView.class)并捕获异常。 -
不要混用旧 API:避免在已用
readAttributes后再调用file.isHidden()(java.io.File)——它仅检查dos:hidden,且内部仍触发额外GetFileAttributes调用,破坏性能优势。 -
属性完整性保障:
DosFileAttributes包含全部 4 个核心标志位(hidden,system,readonly,archive)及 3 个时间戳,覆盖 Windows 资源管理器显示和系统行为所需全部元数据。 -
网络传输建议:
DosFileAttributes实例不可直接序列化(非Serializable),推荐封装为轻量 POJO(如DosAttrSnapshot),包含boolean hidden, system, readOnly, archive+FileTime时间戳字段,通过 JSON 或 Protocol Buffers 传输。
✅ Windows 全 DOS 属性速查表(Java NIO.2 映射)
| 属性名(Java 视图) | 对应 Windows 属性 | 说明 | 是否可读/写 |
|---|---|---|---|
dos:hidden |
Hidden | 隐藏文件(资源管理器默认不显示) | ✅ 读/写 |
dos:system |
System | 系统文件(如 pagefile.sys、desktop.ini) |
✅ 读/写(需权限) |
dos:readonly |
Read-only | 只读文件(禁止修改内容) | ✅ 读/写 |
dos:archive |
Archive | 存档位(备份软件常用标记) | ✅ 读/写 |
dos:creationTime |
Creation Time | 文件创建时间(NTFS 支持,FAT32 无) | ✅ 读,⚠️ 写需 DosFileAttributeView.setCreationTime()
|
dos:lastModifiedTime |
Last Write Time | 最后写入时间 | ✅ 读/写(同 BasicFileAttributes) |
dos:lastAccessTime |
Last Access Time | 最后访问时间(NTFS 默认禁用) | ✅ 读,⚠️ 写受限 |
? 提示:可通过
Files.getFileStore(path).supportsFileAttributeView("dos")动态检测当前卷是否支持 DOS 属性,增强程序健壮性。
综上,借助 DosFileAttributes + DosFileAttributeView,您不仅能一次性获取/还原全部 Windows 文件属性,还能确保 desktop.ini 等关键系统文件在备份恢复后保持原始语义——真正实现企业级备份工具所需的元数据保真度。


















