ReadMe in English

MyBox：简易工具集

这是图形化计算机应用，目标是提供简单易用的功能。免费开源。

新内容

2024-5-18 版本6.8.1

• 新增：
  • 对PDF批量添加水印。
  • 数据的列类型：可编辑的枚举型。
  • 文档：测试环境、基本功能检验列表、兼容性测试、详细测试。
• 改进：
  • 重新设计和实现"处理数据"，基础框架为：读+处理+写。
  • 选项：编辑数据时检验类型、保存数据时检验类型。
  • 行表达式：以bindings代入变量值，占位符被处理为变量名而不是变量值。
  • 行过滤：当表达式不为空且其值不为true或false，不取此行。
  • 简化"处理数据"的界面。
  • 处理数据：修正和增强“赋值”。
  • 定制颜色时可以设置透明度。
  • ffmpeg可以设置"rtbufsize"和旋转。
  • 笔记：节点是任何html，可以包含head。
• 解决问题：
  • 缺省locale非中文时无法切换语言。
  • 当数据值为多行字串时行表达式会解析混乱。
  • 数据处理中当表达式非法时“赋值”不应清除数据行。
  • 编辑数据行时弹出错误。
  • 对数据库表导入数据时，类型“纪元”转换错误。
  • icon图片显示为空白。
  • 一些界面中“目标文件”的选项未生效。
  • 对SVG绘制形状时，透明背景未正确设置。
  • SVG的“查看”选项未生效。
  • 在网页中显示颜色时透明值未生效。
  • 重命名文件：当未统计文件数时选项“填零”失效。
  • 文件同步：当选择“删除存在于目标目录但不存在于源目录的文件和目录”时功能失效。
  • 解压/解档文件：解开的列表中文件名为空。
  • 检查冗余文件：结果列表中文件名为空。

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

注意

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

• 毁坏文件/数据。
• 输出错误的结果。
• 功能失效。
• 其它非预期的行为。

下载与运行

源码

自包含程序包

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

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

Jar包

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

执行以下命令来启动程序：
java -jar MyBox.jar

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

版本

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

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

配置

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

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

迁移

1. 每个版本有自己的配置文件，新版本可以复制已安装版本的参数。
2. 每个版本处理的所有数据都在它指向的“数据目录”下。多个版本可以指向同一数据目录。
3. MyBox向后兼容：新版本可以处理旧版本的数据目录。而不保证向前兼容：旧版本处理新版本的数据目录时可能出错。

备份与恢复

在MyBox中：
1. 将目录复制到别处，即为备份。
2. 将备份的目录覆盖当前目录，即为恢复。
3. 不必备份数据目录的每个子目录。
以下列出数据目录中预定义的子目录：

资源地址

文档

实现基础

MyBox基于以下开放资源：

特点

跨平台

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

国际化

1. 所有代码均国际化。可实时切换语言。
2. 每种语言对应一个资源文件：“Messages_语言名.properties”。
3. 支持在线添加语言。提供表格，对照英语翻译。新语言可实时生效。
   例如，新语言名字为“aa”，则它的资源文件是“Messages_aa.properties”。
4. 新语言可共享给别人：把资源文件复制到数据目录的子目录"mybox_languages"下，则MyBox可即时感知到新语言。
5. 内置中文和英文， 在目录MyBox/src/main/resources/bundles/中：

个人的

1. 所有功能在本机执行。
2. 所有数据在本机存储。
3. 无注册/登录/数据中心/云存储。
4. 只在用户要求时才访问网络。
5. 只读写用户需要的数据。

友善的

1. 提供当前功能/界面的提示。
2. 记住用户的输入或选择，提供历史记录。
3. 界面可调整，一些面板可隐藏。
4. 一些控件的行为可选择。
5. 提供文本/图片/网页/表格/树形的右键菜单和功能菜单。
6. 可弹出当前文本/图片/网页/数据。
7. 可管理的文本/图片/数据粘贴板。
8. 提供示例和有用的信息。
9. 界面和控件的外观可选择和修改。

数据兼容

1. 导出的数据是通用的文本格式，如txt/csv/xml/json/html。
2. 导入的数据是通用的文本格式，如txt/csv。
3. 至少有一种导出格式可以被导入。
4. 导入的数据是自包含的，即重建原数据无需辅助数据。

内置数据库系统

1. 数据库系统derby免费开源：
   • 首次启动MyBox时，需要消耗一些时间以创建内部数据库并写入初始数据。
   • 所有数据库文件均在数据目录下，因此可以通过切换数据目录来处理不同的数据目标集。
   • 通过访问同一数据目录，多个MyBox实例可以共享数据。
   • 当数据目录下未发现数据库文件（如文件损毁或意外删除），MyBox会自动创建数据库。
2. Derby缺省以内置模式运行：
   • 外部进程无法访问数据库。
   • 同时只能有一个MyBox实例访问数据库。
3. Derby还可以网络运行：
   • 首个访问数据库的MyBox实例成为服务器。
   • 本机进程可通过端口1527来访问数据库、即为客户端。
   • 非本机进程不能直接访问数据库。
4. MyBox内部数据表存放各个功能所需的数据。 用户可以在线访问和修改内部数据。
5. 用户可以自定义数据库表。
6. 用户可以通过分页表格的来查看和编辑数据库表的定义和数据，也可以执行SQL语句。
7. 为了实现数据的排序、转置、统计、和分组，MyBox会生成临时数据库表、并负责及时清除它们。

辅助自身编码

1. 实时监测内存和CPU占用量。
2. 在线调整和查询日志。
3. 自动生成图标。
4. 在线编辑和应用语言。
5. 自动测试。
6. 各种文档。

截图