JNoteHelper 给你的java swing或桌面程序提供一双翅膀_gitee上比较好的swing插件项目-优快云博客

本文链接：https://blog.youkuaiyun.com/x308561498/article/details/127987950

JNoteHelper是一款基于Java Swing构建的个人笔记管理工具，支持笔记编辑、问题记录和插件管理等功能，采用MigLayout、SwingX和平坦主题。该项目包括核心组件封装、工具类库和编辑器等模块。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

JNoteHelper

使用swing构建的java程序, 主要基于miglayout,swingx,flatlatf.

开发得初衷,只是打算作为个人笔记的助手, 因为基于java swing开发, 所以就是java-note-helper得简称.

当你得想法太多时,发现扩展为一个庞大得工具,很累. 比如你想增加更多得功能. 因为你发现之前与你设计得初衷背道而驰时, 你需要重构.

重构不得不说,带给你刺激得时候, 也在考验你得意志力和技术.

或许这只是一个开始, 或许这也是一个结束.

项目基于windows测试及开发 ,所以运行效果图片都基于windows 截图

下载地址: https://download.youkuaiyun.com/download/x308561498/87189770?spm=1001.2014.3001.5501

ps: 软件依赖 JDK1.8 +, exe4j打包时为查找windows 注册表jdk 或java_home环境变量

请添加图片描述

1. 项目地址

可以编辑代码自行修改
JNoteHelper github地址
 gitee地址
 gitcode地址

2. 模块说明

note-swing-core

封装了一些常用的swing组件, 可以更简单的创建swing组件
note-swing-toolkit

可以用来构建简单的swing小工具 ,里边有部分示例
note-swing-editor

打算专注于写笔记管理的,封装了jnote文件(记录笔记) 和qa文件(记录问题) ,并且集成了jgit
作为远程同步使用.
note-service-toolkit

使用java封装业务逻辑的 java 工具类或工具包, 与swing无关

note-swing-framework

整合toolkit 和editor页面构建入口应用, 使用bsaf可以缓存上次打开窗口大小.

3. 系统兼容可能存在的问题

SystemFileManager.updateSystemDir2Default() 默认使用了D:/note-helper 作为系统
应用的主目录 ,可能造成与其他系统不兼容
GitRemote 管理,默认使用了注册表存储git信息, 需要修改git保存的相关逻辑
其他应该都是通用的文件存储代码

4. 页面介绍

整体主要受VSCODE 框架影响 ,使用左侧选项卡, 中间目录结构,右侧编辑面板的风格.

4.1 SwingViewApplication 页面总入口

note-swing-framework

cn.note.swing.SwingViewApplication

可以作为整体效果目录, 继承了bsaf 的SingleFrameApplication ,可以记录上次运行后的效果.
当然内嵌 NoteEditorView / QACardView /ToolkitView 也同样可以作为单独应用使用

 ToggleLRCardPanel toggleLRCardPanel = new ToggleLRCardPanel();
        toggleLRCardPanel.addTab(SvgIconFactory.Note.editor, "笔记管理", new NoteEditorView(true), true);
        toggleLRCardPanel.addTab(SvgIconFactory.Note.question, "问答管理", new QACardView(true));
        toggleLRCardPanel.addTab(SvgIconFactory.Note.plugins, "插件管理", new ToolkitView(true));

在这里插入图片描述

4.2 NoteEditorView

主要实现了JTree /JTabbedPane 及JTextPane , 实现笔记文件的记录, 主要关心普通文本,代码块及图片 . 主要实现了查找和全文搜索功能
因为代码属于早期代码, 可能存在很多不合理的设计
主要功能特色:
+ 仿IDE效果, 左侧文件树,右侧选项卡
+ 实现了文本编辑器的按键绑定
+ 扩展了jtextpane的一些特色

主要缺点:
jtextpane 特性了解不够深层, 存在很多bug. 在当作富文本编辑器使用时,存在很多bug. 好多样式效果使用绑定效果, 因为没有时间重构了,所以搁浅了

F1 可以查看主要功能操作
在这里插入图片描述

页面查找
在这里插入图片描述
全文搜索

4.3 QACardView

初始的设计,是为了记录代码过程中,简短的问题Q和答案A , 左侧实现动态questtion添加, 右侧实现动态answer添加 .

主要功能特色

仿制之前的h5页面效果
实现了动态大小的调整
无弹窗的页内编辑

4.4 ToolkitView

动态扩展工具类视图, 左侧为工具目录自定义扩展了(JXTaskPane), 右侧为小工具视图

小工具必须为swing 组件 (必须存在无参构造), 只要你的小工具可以使用main方法运行, 那么在类上使用标记@ItemView注解. 即可自定加入左侧视图控制.

@ItemView(value = "Form示例", order = 101, category = GroupConstants.FORM, description = "Form示例")

主要功能特色

使用@ItemView 注解实现了解耦
使用反射动态扫描

在这里插入图片描述

5. note-swing-core 部分功能介绍

5.1 item包

借助MenuItemView ,可以轻松实现 toolkitview 布局, toolkitview的代码也相当简洁


public class ToolkitView extends AbstractMigCard {

    private MenuItemView menuItemView;

    public ToolkitView() {

    }

    public ToolkitView(boolean card) {
        super(card);
    }

    @Override
    public LRCard getCardView() {
        return new LRCard(this.getClass(), menuItemView.getItemSelector().getSelectorComponent(), menuItemView.getItemContainer());
    }

    @Override
    protected void init() {
        List<ItemNode> menuItems = ItemScanner.scanAllItemView("cn.note.swing.toolkit");
        menuItemView = new MenuItemView(menuItems);
    }

    /**
     * render视图
     */
    @Override
    protected void render() {
        view.add(menuItemView.create(), "grow");
        menuItemView.setDefaultSelectedItem();
    }

    public static void main(String[] args) {
        ThemeFlatLaf.install();
        FrameUtil.launchTime(ToolkitView.class);
    }

}

5.2 form包

受react 的rc-form的影响 ,为了在swing 中轻松构建简单的form 元素,快速抒写小工具 . 以下为FormExample的示例, 点击submit, 可以轻松将form 对象值获取至map对象

@ItemView(value = "Form示例", order = 101, category = GroupConstants.FORM, description = "Form示例")
@Component
public class FormExample extends AbstractMigView {

    /**
     * 定义migLayout布局
     *
     * @return migLayout布局
     */
    @Override
    protected MigLayout defineMigLayout() {
        return new MigLayout("wrap 1", "[grow]", "");
    }


    @Override
    protected void render() {

        // input
        InputFormItem username = new InputFormItem("姓名", "请输入姓名");
        username.setFieldValue("jee");
        username.useLineStyle(view.getBackground());
        username.validEmpty().validMaxLength(5);

        InputFormItem studentId = new InputFormItem("学号", "请输入学号");
        studentId.validMaxLength(3);

        InputFormItem idCard = new InputFormItem("身份证号", "请输入身份证号");
        idCard.validMinLength(3);


        // group button
        List<String> sexList = CollUtil.newArrayList("男", "女");
        RadioGroupFormItem sexRadioGroup = new RadioGroupFormItem("性别", sexList);


//        List<String> hobbyList = CollUtil.newArrayList("书法", "画画", "运动", "爬山");
//        CheckBoxGroupFormItem hobbyCheckBoxGroup = new CheckBoxGroupFormItem("爱好", hobbyList);

        // 文件
        JTextField fileChooser = FileChooserBuilder.inputFileChooser("选择文件");
//        fileChooser.setEnabled(false);
        InputFormItem addFile = new InputFormItem("文件", fileChooser, "选择文件");

        // select
        SelectedFormItem<SelectedItem> interest = new SelectedFormItem<SelectedItem>("兴趣");
        interest.useLineStyle(view.getBackground());
        interest.addSelectItem(new SelectedItem("football", "足球"));
        interest.addSelectItem(new SelectedItem("basketball", "篮球"));
        interest.addSelectItem(new SelectedItem("badminton", "羽毛球"));

        SelectedFormItem<String> code = new SelectedFormItem<String>("代码");
        code.setSelectItems(CollUtil.newArrayList("java", "html", "css"));

        // buttonFileChosser
        ButtonFileChooser saveFile = new ButtonFileChooser("保存", file -> {
            MessageBuilder.ok(this, "保存路径==>" + file);
        });
        saveFile.setFileChooserType(FileChooserType.Directory);

        // checkbox
        CheckBoxFormItem allowAgree = new CheckBoxFormItem("是否同意");
//        allowAgree.setLeftOffset(50);
        CheckBoxFormItem allowUse = new CheckBoxFormItem("是否使用代理", true);
        // form
        Form form = new Form();
        form.addTitleSeparator("input");
        form.addFormItem(username, "username");
        form.addFormItem(studentId, "studentId");
        form.addFormItem(idCard, "idCard");
        form.addFormItem(sexRadioGroup, "sex");
//        form.addFormItem(hobbyCheckBoxGroup, "hobby");

        form.addTitleSeparator("select");
        form.addFormItem(interest, "interest");
        form.addFormItem(code, "code");
        form.addTitleSeparator("fileChooser");
        form.addFormItem(addFile, "addFile");

        form.addTitleSeparator("checkbox");
        form.addFormItem(allowAgree, "allowAgree");
        form.addFormItem(allowUse, "allowUse");

        view.add(form, "center,w 400!");
        JButton submit = ButtonFactory.primaryButton("submit");
        view.add(submit, "center");

        view.add(saveFile, "center");

        submit.addActionListener((e) -> {
            boolean validError = form.validFields();
            if (!validError) {
                Map<String, Object> values = form.getFormValues();
                WinUtil.alertMulti(JSONUtil.toJsonPrettyStr(values));
            }
        });
    }
}