MyBox：简易工具箱

用户手册 - 综述

作者：Mara

版本：6.8.1

日期：2024-5-18

1 简介

这是利用JavaFx开发的图形化桌面应用，目标是提供简单易用的功能。免费开源。

1.1 新内容

2024-5-18 版本6.8.1

• 新增：

  • 对PDF批量添加水印。

  • 数据的列类型：可编辑的枚举型。

  • 文档：测试环境、基本功能检验列表、兼容性测试、详细测试。

• 改进：

  • 重新设计和实现"处理数据"，基础框架为：读+处理+写。

  • 选项：编辑数据时检验类型、保存数据时检验类型。

  • 行表达式：以bindings代入变量值，占位符被处理为变量名而不是变量值。

  • 行过滤：当表达式不为空且其值不为true或false，不取此行。

  • 简化"处理数据"的界面。

  • 处理数据：修正和增强“赋值”。

  • 定制颜色时可以设置透明度。

  • ffmpeg可以设置"rtbufsize"和旋转。

  • 笔记：节点是任何html，可以包含head。

• 解决问题：

  • 缺省locale非中文时无法切换语言。

  • 当数据值为多行字串时行表达式会解析混乱。

  • 数据处理中当表达式非法时“赋值”不应清除数据行。

  • 编辑数据行时弹出错误。

  • 对数据库表导入数据时，类型“纪元”转换错误。

  • icon图片显示为空白。

  • 一些界面中“目标文件”的选项未生效。

  • 对SVG绘制形状时，透明背景未正确设置。

  • SVG的“查看”选项未生效。

  • 在网页中显示颜色时透明值未生效。

  • 重命名文件：当未统计文件数时选项“填零”失效。

  • 文件同步：当选择“删除存在于目标目录但不存在于源目录的文件和目录”时功能失效。

  • 解压/解档文件：解开的列表中文件名为空。

  • 检查冗余文件：结果列表中文件名为空。

此版本关闭的需求/问题列表

1.2 注意

MyBox未经足够测试，可靠性低、稳定性差。使用MyBox，可能出现以下情况：

• 毁坏文件/数据。

• 输出错误的结果。

• 功能失效。

• 其它非预期的行为。

1.3 跨平台

MyBox用纯Java实现且只基于开放资源，MyBox可运行于支持Java 21的平台。
MyBox v5.3以前的版本均基于Java 8。

1.4 国际化

1. 所有代码均国际化。可实时切换语言。

2. 每种语言对应一个资源文件：“Messages_语言名.properties”。

3. 支持在线添加语言。提供表格，对照英语翻译。新语言可实时生效。
   例如，新语言名字为“aa”，则它的资源文件是：Messages_aa.properties。

4. 新语言可共享给别人：把资源文件复制到数据目录的子目录"mybox_languages"下，则MyBox可即时感知到新语言。

5. 内置中文和英文， 在目录"MyBox/src/main/resources/bundles/"中：

1.5 个人的

1. 所有功能在本机执行。

2. 所有数据在本机存储。

3. 无注册/登录/数据中心/云存储。

4. 只在用户要求时才访问网络。

5. 只读写用户需要的数据。

1.6 友善的

1. 提供当前功能/界面的提示。

2. 记住用户的输入或选择，提供历史记录。

3. 界面可调整，一些面板可隐藏。

4. 一些控件的行为可选择。

5. 提供文本/图片/网页/表格/树的右键菜单和功能菜单。

6. 可弹出当前文本/图片/网页/数据。

7. 可管理的文本/图片/数据粘贴板。

8. 提供示例和有用的信息。

9. 界面和控件的外观可选择和修改。

1.7 数据兼容

1. 导出的数据是通用的文本格式，如txt/csv/xml/json/html。

2. 导入的数据是通用的文本格式，如txt/csv。

3. 至少有一种导出格式可以被导入。

4. 导入的数据是自包含的，即重建原数据无需辅助数据。

1.8 内置数据库系统

1. 数据库系统derby免费开源：

• 首次启动MyBox时，需要消耗一些时间以创建内部数据库并写入初始数据。

• 所有数据库文件均在数据目录下，因此可以通过切换数据目录来处理不同的数据目标集。

• 通过访问同一数据目录，多个MyBox实例可以共享数据。

• 当数据目录下未发现数据库文件（如文件损毁或意外删除），MyBox自动创建数据库。

2. Derby缺省以内置模式运行：

   • 外部进程无法访问数据库。

   • 同时只能有一个MyBox实例访问数据库。

3. Derby还可以网络运行：

   • 首个访问数据库的MyBox实例成为服务器。

   • 本机进程可通过端口1527来访问数据库、即为客户端。

   • 非本机进程不能直接访问数据库。

4. MyBox内部数据表存放各个功能所需的数据。 用户可以在线访问和修改内部数据。

5. 用户可以自定义数据库表。

6. 用户可以通过分页表格的来查看和编辑数据库表的定义和数据，也可以执行SQL语句。

7. 为了实现数据的排序、转置、统计、和分组，MyBox会生成临时数据库表、并负责及时清除它们。

1.9 辅助自身编码

1. 实时监测内存和CPU占用量。

2. 在线调整和查询日志。

3. 自动生成图标。

4. 在线编辑和应用语言。

5. 自动测试。

6. 各种文档。

2 资源地址

3 文档

4 下载与运行

4.1 源码

源码	大小	开发指南	打包步骤
MyBox-src.zip	80M-	pdf	html

4.2 自包含程序包

自包含的程序包无需java环境、无需安装、解包可用。

双击或者用命令行执行包内的启动文件即可运行程序。可以把图片/文本/PDF文件的打开方式关联到MyBox，这样双击文件名就直接是用MyBox打开了。

4.3 Jar包

在已安装JRE或者JDK Oracle jdk或open jdk均可）的环境下，可以下载jar包。

执行以下命令来启动程序：

     	java   -jar   MyBox.jar

程序可以跟一个文件名作为参数、以用MyBox直接打开此文件。例如以下命令是打开此图片：

     	java   -jar   MyBox.jar   /tmp/a1.jpg 

4.4 版本

本文档的内容可能已过期，但是其中的链接均指向最新版本。

以下网址可以下载到最新版本和已归档的版本：

4.5 配置

配置文件在"用户目录"下:

可以临时改变配置文件：在命令行启动jar包时设置参数"config="配置文件名""。
利用“设置”功能也可以修改配置参数。

4.6 备份与恢复

在MyBox中：

1. 将目录复制到别处，即为备份。

2. 将备份的目录覆盖当前目录，即为恢复。

3. 不必备份数据目录的每个子目录。

以下列出数据目录中预定义的子目录：

4.7 版本迁移

1. 每个版本有自己的配置文件，新版本可以复制已安装版本的参数。

2. 每个版本处理的所有数据都在它指向的“数据目录”下。多个版本可以指向同一数据目录。

3. MyBox向后兼容：新版本可以处理旧版本的数据目录。而不保证向前兼容：旧版本处理新版本的数据目录时可能出错。

5 实现基础

MyBox基于以下开放资源：

6 界面通用功能

6.1 主界面

程序启动后显示主界面，鼠标移过图标时弹出工具菜单，选择后进入相应的工具界面。

6.2 界面的布局

1. 窗口标题显示正在处理的对象名字。

2. 主菜单栏，用于打开各个功能界面。

3. 一些界面包含分页栏，一般显示在底部。

4. 一些界面有鱼形图标，鼠标悬停于上，则弹出提示信息。

5. 一些界面包括左面板或右面板，若有朱雀图标，则可鼠标悬停于上以控制显示/隐藏面板。

6. 对一些按钮、选择框、或图标，鼠标悬停于上可弹出其快捷键或提示信息。

6.3 设置界面字体大小

1. 同时按键“CTRL”和“-”，则界面字体减小一号

2. 同时按键“CTRL”和“=”，则界面字体增大一号

3. 在菜单“设置”下可直接选择三种字体大小：12px、15px、17px。

4. 在“设置”窗口中，可选择或设置字体大小。

6.4 打开新界面

若要保持当前界面的同时打开其它界面，则不要选择菜单项“设置”-“当打开新工具时关闭当前窗口”。

6.5
维持界面尺寸

在“设置”中选择“保存窗口的尺寸和位置”，则每个界面的最后尺寸将被保存、并在下次打开时恢复。

6.6 最近访问的文件/目录

在“设置”中选择了“弹出最近访问的文件/目录”，则每次文件/目录被访问时都被记录，并当鼠标移至选择文件/目录的按钮时弹出选择列表。

6.7 数据表

1. 选择数据行：

• 按住SHIFT键、并点击数据行，以选择多行的范围。

• 按住CTRL键、并点击数据行，以一行一行地选择多行。

• 点击行开头的复选框。

2. 编辑数据：

• 可编辑列的题头文字为蓝色（可编辑的主键仍为红色）。

• 点击可编辑的单元，则它的输入框会被显示出来。

• 按ESC键以取消编辑、按ENTER键以提交修改。

• 选项：当可编辑单元失去焦点时自动提交修改。

• 当数据被提交时，它的值将被检查、非法值将被拒绝。

3. 要显示/隐藏列，点击表格头行右边的按钮"+"。

此操作不影响数据。

4. 要调整列的顺序，点击并拖动列头。

此操作不影响数据。

5. 要对表行进行排序：

• 点击列头以按此列的升序排序。

• 再次点击列头以按此列的降序排序。

• 第三次点击列头以取消此列的排序。

• 按住SHIFT键并点击更多的列头以按多列排序。

此操作只影响表中当前数据。

6. 主键的题头文字为红色。自增主键的题头文字为橙色。

6.8 右键菜单

1. 又称“上下文菜单”，在对象（文本/图像/表格）中点击右键会弹出此菜单。

2. 若界面有“烟云按钮”，点击此按钮也可弹出右键菜单。

6.9 “示例”窗口

悬停或点击“示例”按钮以弹出示例窗口。

6.10 “历史”窗口

悬停或点击“历史”按钮以弹出示例窗口。

6.11 颜色块与调色板

1. 悬停颜色块，可弹出颜色的信息。

2. 点击颜色块，可弹出调色板以选择或修改颜色。

7 设置

在主菜单上选择“设置...”则显示设置窗口。

7.1 界面

1. 语言、字体大小、图标大小

2. 控件颜色、是否显示控件文字、界面风格

3. 可以定制按钮的颜色。

4. 是否恢复界面上次尺寸

5. 是否在新窗口中打开界面

6. 是否在鼠标经过按钮时弹出“设置颜色”

7. 是否在鼠标经过按钮时显示/隐藏面板

8. 界面消息的颜色、时长和字体大小。

7.2 基础

1. JVM最大可用内存

2. 网络超时

7.3 数据

1. 数据目录

2. Derby运行模式：嵌入模式、网络模式（只允许本地），及批处理的大小。

3. 文件/目录最近访问历史的个数

4. 是否在退出前清除过期数据

7.4 PDF工具

PDF可用最大主内存

7.5
图像

1. 画笔/锚点的宽度和颜色、锚点是否实心

2. 不支持Alpha时要替换的颜色（建议为白色）

3. 缩略图宽度

4. 渲染参数

7.6 地图

设置数据密钥

8 窗口

1. 刷新/重置/全屏/置顶窗口

2. 关闭其它窗口

3. 重启MyBox

4. 最近访问的界面

5. 窗口/面板截屏

9 窗口列表

1. 在“窗口”菜单中选择“窗口列表”以打开此界面。

2. 显示MyBox所有正在运行的窗口。

3. 选择一些窗口，点击按钮“关闭”。

4. 选择一些窗口，点击按钮“总是在上面”。

5. 选择一些窗口，点击按钮“解除总是在上面”。

10 清除过期数据

1. 在“设置”菜单中选择“清除过期数据”以打开此界面。

2. 选择要处理的数据

3. 在清除过期数据过程中，不要用MyBox功能读写文件或数据。

4. 可选退出前自动清除过期数据。

<文档结束>