Tiny RDM用户手册:使用自定义解码器和编码器

自定义解码/编码器

Tiny RDM除了内置部分常用的解码方式(包括Base64/GZip/Deflate/ZStd/Brotli/Msgpack等),也支持用户自定义解码器和编码器,来满足更复杂的数据解析。

相关概念术语

解码器:将数据库中读取到的原始内容,转换为友好的人类可读格式,便于展示和编辑。

编码器:将人类可读格式下的内容,重新转回原始数据,用于保存到数据库中。

工作原理

Tiny RDM通过执行外部应用程序来进行解码/编码操作。

为了方便不同开发语言和程序之间进行传输,原始数据会先进行Base64编码成字符串,再通过参数输出,经由外部应用程序的解码/编码处理后,同样以Base64形式接收输入。外部应用程序如果出现处理数据失败(如无法解码等情况),直接输出普通文本[RDM-ERROR]即可。

基本输出输入流程如下图:

创建使用示例

下面将以编写一个PHP序列化器和反序列化器为例子,来说明如何自行构建和使用解码/编码器

解码器

php 复制代码
<?php  
$decoded = base64_decode($argv[1]);  
if ($decoded !== false) {  
 $obj = unserialize($decoded);
 if ($obj !== false) {
  $unserialized = json_encode($obj, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
  if ($unserialized !== false) {
   echo base64_encode($unserialized);
   return;
  }
 }
}  
echo '[RDM-ERROR]';  

将上面代码保存为文件php_decoder.php,可通过命令行进行简单测试:

ini 复制代码
php /path/to/php_decoder.php YToxOntzOjY6IuS9oOWlvSI7czo4OiJ0aW55X3JkbSI7fQ==  
提示

此处输入的内容YToxOntzOjY6IuS9oOWlvSI7czo4OiJ0aW55X3JkbSI7fQ==为文本a:1:{s:6:"你好";s:8:"tiny_rdm";}的Base64编码

如果逻辑正确,应该会输出eyLkvaDlpb0iOiJ0aW55X3JkbSJ9,即字符串{"你好":"tiny_rdm"}的Base64编码。

编码器

根据上面解码器的示例代码,我们来实现编码器的逻辑。

php 复制代码
<?php  
$decoded = base64_decode($argv[1]);  
if ($decoded !== false) {  
  $json = json_decode($decoded, true);
  if ($json !== false) {
  $serialized = serialize($json);
  if ($serialized !== false) {
   echo base64_encode($serialized);
   return;
  }    
 }
}  
echo '[RDM-ERROR]';

保存为文件php_encoder.php, 同样可以进行简单测试:

bash 复制代码
php /path/to/php_encoder.php eyLkvaDlpb0iOiJ0aW55X3JkbSJ9

如果一切顺利,将会输出YToxOntzOjY6IuS9oOWlvSI7czo4OiJ0aW55X3JkbSI7fQ==。到这一步,自行实现的解码器和编码器都已准备就绪。

使用方式

完成上面两步所创建的解码器和编码器,我们来总结下其命令行使用方式。 此处编写的是php脚本,依赖php运行,所以使用方式如下:

  • 解码执行命令

    php /path/to/php_decoder.php {VALUE}

  • 编码执行命令

    php /path/to/php_encoder.php {VALUE}

提示

除了通过对应环境运行脚本,也可以运行任意可独立执行的二进制文件,只要能提供命令行界面工具运行方式即可

说明
  • /path/to需要替换成对应脚本文件所在目录

  • {VALUE}为输入到解码器/编码器的原始内容Base64编码字符串占位符

添加使用

打开Tiny RDM,依次打开偏好设置=>自定义解码=>新增解码/编码器,填写内容如下:

参数说明
  • 「解码器名称」:用于展示在解码下拉列表中的名称

  • 「解码器执行路径」 :解码器可执行二进制文件所在路径。由于上述例子需要执行的是php脚本,所以将php cli作为执行文件

  • 「运行参数」 :执行外部程序解码所需参数,此处第一个参数为需要执行的php文件路径,第二个为需解码的内容占位符,使用{VALUE}代替。如果不填写内容占位符,则会在执行期间将内容作为最后一个参数传入

  • 「自动解码」:当加载一段尚未被识别类型的内容时,会优先尝试使用此解码器进行解码

同样的,编码器标签页的填写内容如下:

确认保存后,就可以在解码列表中找到这个编码选项了!

至此,自定义解码器和编码器都已完成,尝试使用它来打开一个对应编码的键吧~

Tiny RDM是一款界面现代化的Redis GUI桌面工具,它开源免费,且美观易用。如果你刚好需要,欢迎下载使用:

官方地址:redis.tinycraft.cc/zh/

源码地址:github.com/tiny-craft/...

相关推荐
兆龙电子单片机设计1 小时前
【STM32项目开源】STM32单片机多功能饮水机系统
stm32·单片机·物联网·开源·毕业设计
王嘉俊9252 小时前
HarmonyOS 微服务与 OpenHarmony 开发:构建模块化与开源生态应用
微服务·开源·harmonyos·arkts·开发·鸿蒙
CoderJia程序员甲5 小时前
GitHub 热榜项目 - 日榜(2025-10-27)
ai·开源·大模型·github·ai教程
北邮-吴怀玉5 小时前
2.2.2.3 大数据方法论与实践指南-开源服务跟踪工具对比
大数据·开源
FIT2CLOUD飞致云5 小时前
支持添加外部面板、支持设置水印,1Panel v2.0.12版本正式发布
人工智能·开源
亿坊电商7 小时前
如何检查开源CMS的数据库连接问题?
数据库·开源
蚂蚁数据AntData8 小时前
DB-GPT 0.7.4 版本更新|开源蚂蚁集团Text2SQL数据集:Falcon、支持GLM-4.5大模型
数据库·gpt·语言模型·开源
量子位8 小时前
全球开源大模型杭州霸榜被终结,上海MiniMax M2发布即爆单,百万Tokens仅需8元人民币
开源
Lucky小小吴9 小时前
开源项目解读4-高性能并发缓存库Ristretto
缓存·开源·高并发·高性能缓存·实时数据处理·ristretto·tinylfu
十五年专注C++开发10 小时前
qtmqtt: 一个开源且好用的mqtt开源客户端
c++·qt·mqtt·开源