JavaFx 21 项目Markdown 预览、编辑、新建、文件树、删除、重命名

项目文件结构

项目的源代码和资源文件存放在以下路径：

1. 源代码：

   • src/main/java/com/kong/markdown/ 包含多个 Java 文件，主要实现了应用的功能：
     • App.java：主类，可能包含应用的启动逻辑。
     • FileService.java：可能与文件操作相关的服务类。
     • MainController.java：控制器类，可能负责与 UI 的交互。
     • MarkdownProcessor.java：处理 Markdown 解析和预览的类。
     • UIHelper.java：辅助类，可能用于界面上的一些常见功能。

2. 资源文件：

   • src/main/resources/ 包含应用的静态资源文件：
     • .css 文件：样式表，如 dark.css、light.css、styles.css。
     • .fxml 文件：JavaFX 的 FXML 文件，用于定义 UI 布局。
     • icons/：图标文件，用于界面显示的图标。
     • markdown.exe：可能是 Markdown 相关的可执行文件，或用于编辑的工具。
     • info.md：Markdown 格式的文本，可能作为应用的一部分或示例内容。
     • META-INF/MANIFEST.MF：包含 JAR 文件元数据的清单文件。

重点文件

1. pom.xml 配置文件

pom.xml 文件已经配置了 JavaFX 依赖，并且包含 javafx-maven-plugin 来处理 JavaFX 应用的构建。

2. App.java

这是应用的主类。它通常是 javafx.application.Application 的子类，并重写了 start() 方法，作为应用的入口。

3. FXML 文件

• main-view.fxml：用于定义应用的用户界面布局，是 JavaFX 的界面描述文件。

4. CSS 文件

• dark.css、light.css：定义了两种主题的样式表，分别用于深色和浅色模式的 UI。

App.java 代码

这是应用的主类，它继承自 javafx.application.Application，并且重写了 start() 方法，这是 JavaFX 应用的入口。以下是该类的关键完整代码：

package com.kong.markdown;import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.scene.Scene;
import javafx.scene.image.Image;
import javafx.stage.Stage;import java.io.InputStream;public class App extends Application {public static void main(String[] args) {launch();  // 启动 JavaFX 应用}@Overridepublic void start(Stage stage) throws Exception {// 加载 FXML 文件，设置主界面FXMLLoader fxmlLoader = new FXMLLoader(App.class.getResource("/main-view.fxml"));Scene scene = new Scene(fxmlLoader.load(), 1200, 600);// 设置窗口标题和图标stage.setTitle("Markdown Editor - 更优雅的Markdown编辑器");InputStream iconStream = getClass().getResourceAsStream("/icons/icon.png");if (iconStream == null) {throw new IllegalStateException("Icon resource not found!");}stage.getIcons().add(new Image(iconStream));// 设置窗口大小及最小限制stage.setWidth(1200);stage.setHeight(600);stage.setMinWidth(800);stage.setMinHeight(400);// 显示窗口stage.setScene(scene);stage.show();}
}

主要功能：

• 主类 App：继承 Application 类，是 JavaFX 应用的入口。
• start() 方法：设置应用的主窗口，包括：
  • 加载 FXML 布局文件：main-view.fxml。
  • 设置窗口的标题、图标以及大小。
  • 使用 FXMLLoader 加载界面布局，设置窗口大小和最小限制。
  • 显示窗口。

该代码简洁地启动了 JavaFX 应用，并且设置了应用窗口的界面和样式。

main-view.fxml 布局文件

<?xml version="1.0" encoding="UTF-8"?><?import javafx.scene.control.*?>
<?import javafx.scene.layout.BorderPane?>
<?import javafx.scene.web.WebView?>
<BorderPane xmlns:fx="http://javafx.com/fxml" xmlns="http://javafx.com/javafx"fx:controller="com.kong.markdown.MainController"><top><MenuBar fx:id="menuBar"><Menu text="文件"><MenuItem text="打开"/><MenuItem text="保存" onAction="#onSaveFile"/><SeparatorMenuItem/><MenuItem text="退出" onAction="#onExitApp"/></Menu><Menu text="视图"><CheckMenuItem text="显示预览" selected="true" onAction="#onTogglePreview"fx:id="togglePreviewMenuItem"/></Menu></MenuBar></top><center><SplitPane dividerPositions="0.2, 0.6" fx:id="splitPane"><!-- 左侧的文件树 --><TreeView fx:id="fileTreeView"/><!-- 左侧的 Markdown 编辑器 --><TextArea fx:id="markdownEditor" prefWidth="200"/><!-- 右侧的 HTML 预览 --><WebView fx:id="markdownPreview" prefWidth="200"/></SplitPane></center><!-- 在底部添加状态栏 --><bottom><Label fx:id="statusLabel" text="状态栏：" style="-fx-padding: 5px;"/></bottom>
</BorderPane>

这是 JavaFX 应用的界面布局文件，使用了 FXML 格式。该文件定义了一个 BorderPane 布局，主要分为几个区域：

1. 顶部菜单栏 (top)：

   • 包含一个 MenuBar，包括两个菜单：
     • 文件菜单：包含 “打开”、“保存” 和 “退出” 功能项。 “保存” 和 “退出” 菜单项绑定了对应的动作（onSaveFile 和 onExitApp）。
     • 视图菜单：包含一个复选框菜单项 “显示预览”，其绑定了 onTogglePreview 动作。

2. 中心区域 (center)：

   • 使用 SplitPane 布局将中心区域分为两个部分：
     • 左侧区域：一个 TreeView 控件，用于显示文件树。
     • 右侧区域：一个 Markdown 编辑器（具体控件未完全显示，可能是 TextArea 或其他控件）。

   SplitPane 控制分隔条的位置，以便用户调整左侧和右侧的区域大小，dividerPositions="0.2, 0.6" 表示初始的比例。

主要控件：

• MenuBar：包含文件操作和视图设置的菜单。
• SplitPane：用于分割左右区域，适合实现 Markdown 编辑器和预览分屏效果。
• TreeView：左侧的文件浏览树，用户可以在其中浏览和选择文件。

MainController.java 控制器类

package com.kong.markdown;import javafx.fxml.FXML;
import javafx.scene.control.*;
import javafx.scene.web.WebView;
import javafx.stage.FileChooser;
import org.apache.commons.lang3.StringUtils;import java.io.File;
import java.io.IOException;
import java.nio.file.Path;
import java.nio.file.Paths;/*** @author kong*/
public class MainController {private final MarkdownProcessor markdownProcessor = new MarkdownProcessor();private final FileService fileService = new FileService();private File currentFile;private boolean isPreviewVisible = true;@FXMLprivate TreeView<String> fileTreeView;@FXMLprivate TextArea markdownEditor;@FXMLprivate WebView markdownPreview;@FXMLprivate Label statusLabel;@FXMLprivate SplitPane splitPane;@FXMLprivate MenuBar menuBar;@FXMLprivate MenuItem togglePreviewMenuItem;@FXMLprivate