详解java如何实现将数据导出为yaml

 更新时间:2023年11月22日 09:53:08   作者:棒棒糖_  
这篇文章主要为大家详细介绍了java如何利用snakeyaml和freemarker实现将数据导出为yaml文件,文中的示例代码讲解详细,有需要的小伙伴可以参考一下

需求描述

需求:根据用户在web界面勾选的配置生成一份如下格式文档,保留注释。

# 我是注释
VERSION: '1.0'

# 我是注释
FILE_NAME: foo

# 我是注释
UNWIND:
  COUNT: 3
  UNWIND_CHECK: true
  
# 我是注释
FLAGS:
  FLAG1: true
  FLAG2: false
  FLAG3: true
  FLAG4: true
  
 # 我是注释
 DEFINES:
  - DEFINE1
  - DEFINE2
  - DEFINE3

技术调研

这里直接给结论,关于下面提及的技术在网上资料很多,我也会把我参考的资料贴在文章尾部。

简单介绍一下这里提及的两个技术:

  • snakeyaml: 支持javabean转为yaml文件,也支持读取yaml文件为javabean对象。类似fastjson可以实现javabean与json相互转化。
  • freemark:比较成熟的template engine之一。

1.采用snakeyaml

优点:生成yaml文件简单,有相应的api可直接调用。只要把封装数据传给snakeyaml即可

缺点:

  • 和需求文档中的变量顺序不一致,生成的按照字母顺序排序;注释不好处理 。
  • java对象属性名需要和yaml中的一致。但是yaml中采用大写加下划线的风格、java中变量名采用驼峰命名风格。(初步尝试了做变量风格转换,要继承snakeyaml的一些类重写部分函数,比较复杂。而且后面要读取yaml文档时,又要做一次逆向风格替换。)

2.采用freemarker

优点:

  • 以按照需求文档中的配置项顺序生成yaml文件
  • 变量名风格可以不一致

缺点:

  • 需要自己写yaml语法规则
  • 如果变量名风格不一致,在读取yaml文件时会增加复杂度

3.snakeyaml + freemarker

优点:

  • 可以按照需求文档中的配置项顺序生成yaml文件
  • 生成yaml文件逻辑较为简单

缺点:

  • 需求文档中使用块序列风格,这种方式将以流序列风格生成文档
  • 如果变量名风格不一致,在读取yaml文件时会增加复杂度

调研反馈

和产品沟通后,第三种方式提到的两个缺点不是问题。

结论:1.读取yaml文件功能不需要开发(是我多虑了,哈哈);2.块序列风格转为流序列风格。

理论落地

snakeyaml + freemarker的实现思路是:根据需求中的yaml文件提取出一个模板,然后通过数据填充的方式,给模板填充使用snakeyaml预处理过的数据,如此即可生成一份令产品满意的yaml文档。

step 1:提取freemark模板

# 我是注释
VERSION: ${dumpHelper.settingBO.version!}

# 我是注释
FILE_NAME: ${dumpHelper.settingBO.fileName!}

# 我是注释
UNWIND: ${dumpHelper.getUnwind()!}

# 我是注释
FLAGS: ${dumpHelper.getFlags()!}

# 我是注释
DEFINES: ${dumpHelper.getDefines()!}

step 2: 编写生成yaml文件工具类

public class YamlGeneratorUtil {
    private static final Configuration freemarkerConfig;

    static {
        // 初始化Freemarker配置
        freemarkerConfig = new Configuration(Configuration.VERSION_2_3_0);
        freemarkerConfig.setClassForTemplateLoading(YamlGeneratorUtil.class, "/templates/");
    }

    /**
     * 根据模板生成单个yaml配置文件
     * @param templateName 模板名称
     * @param outputFileName 生成的文件名
     * @param settingDumpHelper 配置转储辅助类
     */
    public static void generate(String templateName, String outputFileName, SettingDumpHelper settingDumpHelper) {
        try (FileWriter fileWriter = new FileWriter(outputFileName)) {
            Template template = freemarkerConfig.getTemplate(templateName);
            Map<String, Object> dataModel = new HashMap<>();
            dataModel.put("dumpHelper", freemarkerConfig.getObjectWrapper().wrap(settingDumpHelper));
            String config = FreeMarkerTemplateUtils.processTemplateIntoString(template, dataModel);
            fileWriter.write(config);
            System.out.println(config);
        } catch (IOException | TemplateException e) {
            throw new BusinessException(ErrorEnum.build(ErrorEnum.INTERNAL_SERVER_ERROR, "生成yaml文件失败:" + e.toString()));
        }
    }
}

step 3:编写SettingDumpHelper转储辅助类

由于业务特殊,源码就不贴了。这个类具体怎么写根据大家自己的业务逻辑,它的作用是利用snakeyaml对数据进行预处理,把数据转换成yaml的流序列格式。

//示例:
DumperOptions dumperOptions = new DumperOptions();
// 指定流序列格式
dumperOptions.setDefaultFlowStyle(DumperOptions.FlowStyle.FLOW);
Yaml settingDumper = new Yaml(dumperOptions);
// 把数据转换成yaml的流序列格式。
public String getFlags() {
       return settingDumper.dump(settingBO.getFlags());
}

step 4:利用工具类生成yaml文件

YamlGeneratorUtil.generate("config.ftl", your_output_file, your_dump_helper);

到此这篇关于详解java如何实现将数据导出为yaml的文章就介绍到这了,更多相关java数据导出为yaml内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Spring Boot整合web层实现过程详解

    Spring Boot整合web层实现过程详解

    这篇文章主要介绍了Spring Boot整合web层实现过程详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-04-04
  • 如何使用Java生成具有安全哈希的QR码

    如何使用Java生成具有安全哈希的QR码

    这篇文章主要介绍了如何使用Java生成具有安全哈希的QR码,这是关于如何在Java中使用salt生成QR代码和安全散列字符串的分步教程。,需要的朋友可以参考下
    2019-06-06
  • java利用jacob将word转pdf

    java利用jacob将word转pdf

    这篇文章主要为大家详细介绍了java利用jacob将word转pdf,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-12-12
  • java boolean占用内存大小说明

    java boolean占用内存大小说明

    这篇文章主要介绍了java boolean占用内存大小,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-06-06
  • Elasticsearch查询Range Query语法示例

    Elasticsearch查询Range Query语法示例

    这篇文章主要为大家介绍了Elasticsearch查询Range Query语法示例解析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-04-04
  • Java实现冒泡排序

    Java实现冒泡排序

    这篇文章主要为大家详细介绍了Java实现冒泡排序,把一列数组按从小到大或从大到小排序,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-08-08
  • 看完这篇文章获得一些java if优化技巧

    看完这篇文章获得一些java if优化技巧

    if 是每个语言都有的语法,也是最基础的语法。因为代码本来就很晦涩,所以才有了程序员这个中间件,今天就聊一下我的一些关于 if 思路和总结
    2021-07-07
  • openGauss数据库JDBC环境连接配置的详细过程(Eclipse)

    openGauss数据库JDBC环境连接配置的详细过程(Eclipse)

    这篇文章主要介绍了openGauss数据库JDBC环境连接配置(Eclipse),演示基于JDBC开发的主要步骤,会涉及创建数据库、创建表、插入数据等,本文通过实例代码给大家介绍的非常详细,需要的朋友可以参考下
    2022-06-06
  • Java中二叉树的建立和各种遍历实例代码

    Java中二叉树的建立和各种遍历实例代码

    这篇文章主要介绍了Java中二叉树的建立和各种遍历实例代码,涉及树节点的定义,后序遍历,层序遍历,深度优先和广度优先等相关内容,具有一定借鉴价值,需要的朋友可以参考下
    2018-01-01
  • Java 为什么要避免使用finalizer和Cleaner

    Java 为什么要避免使用finalizer和Cleaner

    这篇文章主要介绍了Java 为什么要避免使用finalizer和Cleaner,帮助大家更好的理解和学习使用Java,感兴趣的朋友可以了解下
    2021-03-03

最新评论