前言

本笔记聚焦的 V1.0 版本，是整个系统的“基石版本”。它不追求复杂功能，而是将核心目标锁定在 “File 类核心用法学习” 与 “Swing 基础界面搭建” 两大核心点上，通过实现本地目录可视化这一具体需求。通过本笔记可以掌握：File 类的目录遍历、文件类型判断等核心方法，以及 Swing 窗体初始化、布局管理、组件动态添加等。

一、核心目标与技术栈

1. 版本定位

V1.0 聚焦 java.io.File类 + Swing 基础界面开发，核心目标是实现本地文件目录的可视化展示，让用户通过图形界面直观查看指定磁盘的文件 / 目录结构。

2. 技术工具

技术模块	核心内容
Java 基础	循环遍历、条件判断、数组操作、异常预判（空值处理）
Swing 组件	JFrame（顶层窗体）、JLabel（文件展示）、JButton（目录交互）、FlowLayout（布局）
File 类	目录遍历、文件 / 目录判断、属性获取（名称、路径等）

二、File 类核心知识

Java File类是Java中用于处理文件和目录路径名的抽象类，提供文件/目录的创建、删除、属性获取等操作，但不直接处理文件内容

1. 类本质

File 类对象仅存储文件 / 目录的元信息（路径、名称、权限等），不包含文件实际数据。

2. 方法分类（按功能）

功能分类	方法名	作用描述	返回值类型
文件操作	createNewFile()	创建新文件（若文件已存在则失败）	boolean
	delete()	删除文件或空目录（非空目录无法删除）	boolean
	renameTo(File dest)	重命名文件 / 目录，或移动文件（跨盘符可能失败）	boolean
	mkdir()	创建单级目录（仅最后一级目录）	boolean
	mkdirs()	创建多级目录（自动创建不存在的父目录）	boolean
状态检查	exists()	判断文件 / 目录是否存在	boolean
	isFile()	判断当前 File 对象是否为文件	boolean
	isDirectory()	判断当前 File 对象是否为目录	boolean
	canRead()	判断文件 / 目录是否可读	boolean
	canWrite()	判断文件 / 目录是否可写	boolean
	isHidden()	判断文件 / 目录是否为隐藏文件（Windows 隐藏属性 / Linux 前缀 “.”）	boolean
属性获取	length()	获取文件大小（单位：字节）	long
	lastModified()	获取最后修改时间	long
	list()	获取目录下的文件 / 目录名列表（仅名称字符串）	String[]
	listFiles()	获取目录下的 File 对象数组（含路径、属性等完整信息）	File[]
路径操作	getName()	获取文件 / 目录的名称（含文件后缀）	String
	getPath()	获取构造 File 时传入的路径（可能是相对路径）	String
	getAbsolutePath()	获取文件 / 目录的完整绝对路径	String
	getParent()	获取父目录路径（不含当前文件 / 目录名）	String
	toPath()	转换为 Path 对象	Path
其他方法	compareTo(File pathname)	比较两个文件路径	int
	equals(Object obj)	检查文件对象是否相等	boolean
	toString()	返回文件路径字符串	String

三、Swing 界面开发基础

1. 核心组件与布局

• 顶层容器：JFrame（窗体），关键配置：setSize(500,500)（尺寸）、setVisible(true)（显示）
• 布局管理器：FlowLayout（流式布局）
• 功能组件：JLabel（文件标签）、JButton（文件夹按钮）、ImageIcon（图标）

2. 界面开发流程

1. 初始化窗体：设置标题、尺寸、布局等；
2. 初始化目标目录：创建 File 对象，指定非系统盘（如 D 盘）避免权限问题；
3. 目录遍历：调用 listFiles() 获取文件数组，必须做空值判断（防止目录不可访问）；
4. 组件动态生成：遍历数组，区分文件 / 目录创建对应组件，设置固定尺寸避免排版混乱；
5. 显示窗体：setVisible(true) 必须放在最后（组件添加完成后）。

四、文件管理系统

1. 核心功能

运行程序后，自动展示指定磁盘（D 盘）下的所有文件和文件夹，文件夹用可点击按钮表示，文件用文字标签表示。

2. 完整代码示例

import javax.swing.*;
import java.awt.*;
import java.io.File;

public class FileSystemUI_V1 {
	
    JFrame jf;

    // 显示界面方法
    public void showUI() {
        // 创建窗口并设置基础属性
        jf = new JFrame("文件管理系统V1.0");
        jf.setSize(500, 500); // 窗口大小（宽500，高500）
        jf.setLayout(new FlowLayout(FlowLayout.LEFT, 20, 20)); // 左对齐，组件间距20px
        jf.setLocationRelativeTo(null); // 窗口在屏幕居中显示
        // 关闭窗口时终止应用程序
        jf.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

        // 定位要遍历的目录（建议用D盘，避免C盘权限问题）
        File dir = new File("D:\\");
        // 获取目录下所有文件/文件夹（返回File数组）
        File[] files = dir.listFiles();

        // 循环遍历，区分文件和文件夹并展示（关键逻辑）
        if (files != null) {
            for (File file : files) {
                if (file.isFile()) {
                    // 是文件：用JLabel显示（仅展示名称）
                    JLabel fileLabel = new JLabel(file.getName());
                    fileLabel.setPreferredSize(new Dimension(100, 50)); // 固定组件大小
                    jf.add(fileLabel);
                } else if (file.isDirectory()) {
                    // 是文件夹：用JButton显示（可点击）
                    JButton dirButton = new JButton(file.getName());
                    dirButton.setPreferredSize(new Dimension(100, 50)); // 固定组件大小
                    jf.add(dirButton);
                }
            }
        }

        // 显示窗口
        jf.setVisible(true);
    }

    // 主函数：程序入口
    public static void main(String[] args) {
        FileSystemUI_V1 fileSystem = new FileSystemUI_V1();
        fileSystem.showUI(); // 调用界面展示方法
    }
}

3. 运行效果

打开窗口后，会看到所选磁盘下的所有文件和文件夹：

• 文件：纯文字标签（如test1.txt、test2.txt、test3.txt）
• 文件夹：可点击按钮（如Test1、Test2、Test3）

五、注意事项

1. 权限问题

• 不建议用 C 盘，C 盘是系统盘，部分目录受权限保护
• 换成 D 盘、E 盘等非系统盘，修改路径为File(“D:\”)即可

2. 组件无法显示

• 检查setVisible(true)是否放在最后；
• 检查add()方法是否添加了组件；

六、版本规划

• V1.0（已实现）：显示本地目录结构（文件→JLabel、目录→JButton）
• V2.0：新增创建文件、创建文件夹功能
• V3.0：支持点击按钮打开文件夹、点击标签打开文件
• V4.0：新增文件搜索功能

七、总结

V1.0 作为文件管理系统的基础版本，核心是掌握 File 类的目录遍历与类型判断，以及 Swing 组件的生成与布局。通过本版本的开发，可熟练运用 File 类的核心方法，理解 Swing 界面开发的基本流程，为后续功能迭代打下基础。