[续]使用 Scala Macro Annotation 实现配置项绑定

2024-01-23 22:38

本文主要是介绍[续]使用 Scala Macro Annotation 实现配置项绑定,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

v0.1.2

续 上篇, 因 @连城404 的转发原文:

@连城404:很有趣,有可能把 @conf val port = 0 中的 "= 0" 去掉换成现实的类型说明吗?即 @conf port: Int 这个赋值在此处完全没有实际意义,更像是实现限制而引入的噪声。

class Server {
@conf val port = 0 
//  上面的赋值闲得多余, 可以写成:
// @conf val port: Int
}

确实没有必要, 但意义还是有的: IDE 不会报错. (至少我用的IDEA 14 的 scala plugin 还不支持 Scala Macro)

= 0 可以去掉吗?

答案是可以, 只是在被 @连城404 问到的时候我还没有想到办法.

解决办法方法其实不难, 前提是要对 Scala AST 很熟悉.

经查:

case class ValDef(mods: Modifiers, name: TermName, tpt: Tree, rhs: Tree)

Modifiers 中有个 flags 属性, 其中标记了val port 的各种特征.

那么 val port: Intval port = 0 之间的区别则可以从 flags 中体现出来.

class ModifierFlags {
final val DEFERRED      = 1 << 4        // was `abstract' for members | trait is virtual
final val DEFAULTINIT   = 1L << 41      // symbol is initialized to the default value: used by -Xcheckinit
...
}

ModifierFlags 里定义了所有的 flags 值, 这里摘录其中两个枚举则对应上面两种不同的写法.

具体实现的代码的提交, 请见0475d92c.

如何发现这些细节 ?

  • print(x), 探查未知对象的展现信息, 多半能够提供重要线索;
  • print(x.getClass), 上面的办法不管用, 则需要查明它的类型, 然后去翻源码了.

v0.2.0

上面 v0.1.x 是一种基于ValDef 的声明风格, 实际使用的时候会发现:

编写简单的同时, 代价是类名定义要与配置路径要严格一致, 这并非适合所有场景

比如写个 Kafka 的消费客户端, 要为它设计其访问服务的配置项

kafka_broker {
host = 10.0.0.1
port = 12306
}

此时, 对应的类名就要是KafkaBroker, 这显然违背了设计意图, 像 KafkaConsumer 才是最为自然的选择.

与其大量时间纠结于命名上, 不如换个更好的声明方式.

@conf 带参数可以更改默认配置项路径 :

class KafkaConsumer {
@conf("kafka_broker.host") val host: String
}

嗯, 不错, 能够解决问题. 只是觉得像绕了一圈又回去了的感觉:

class KafkaConsumer {
val host = conf.getString("kafka_broker.host")
}

对比这两种写法, 前者似乎没什么优势了.

回顾用 Macro Annotation 解决配置项绑定的初衷, 是希望 将代码的元信息与配置项建立映射关系, 减少因中间字符串的 Hard Code 为重构带来的额外成本.

为此, 另一种写法诞生了, 它是受这篇 Adding Reflection to Scala Macros 的启发.

其中的细节请见 v0.2.0 的 README, 就不累述于此了.

这种新写法还有个好处, 就是能够方便通过从代码来生成配置文件, 转义的代价很小.

嗯...再写个 sbt plugin 吧 :)

这篇关于[续]使用 Scala Macro Annotation 实现配置项绑定的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/637747

相关文章

使用Java将各种数据写入Excel表格的操作示例

《使用Java将各种数据写入Excel表格的操作示例》在数据处理与管理领域,Excel凭借其强大的功能和广泛的应用,成为了数据存储与展示的重要工具,在Java开发过程中,常常需要将不同类型的数据,本文... 目录前言安装免费Java库1. 写入文本、或数值到 Excel单元格2. 写入数组到 Excel表格

redis中使用lua脚本的原理与基本使用详解

《redis中使用lua脚本的原理与基本使用详解》在Redis中使用Lua脚本可以实现原子性操作、减少网络开销以及提高执行效率,下面小编就来和大家详细介绍一下在redis中使用lua脚本的原理... 目录Redis 执行 Lua 脚本的原理基本使用方法使用EVAL命令执行 Lua 脚本使用EVALSHA命令

Python中pywin32 常用窗口操作的实现

《Python中pywin32常用窗口操作的实现》本文主要介绍了Python中pywin32常用窗口操作的实现,pywin32主要的作用是供Python开发者快速调用WindowsAPI的一个... 目录获取窗口句柄获取最前端窗口句柄获取指定坐标处的窗口根据窗口的完整标题匹配获取句柄根据窗口的类别匹配获取句

Java 中的 @SneakyThrows 注解使用方法(简化异常处理的利与弊)

《Java中的@SneakyThrows注解使用方法(简化异常处理的利与弊)》为了简化异常处理,Lombok提供了一个强大的注解@SneakyThrows,本文将详细介绍@SneakyThro... 目录1. @SneakyThrows 简介 1.1 什么是 Lombok?2. @SneakyThrows

在 Spring Boot 中实现异常处理最佳实践

《在SpringBoot中实现异常处理最佳实践》本文介绍如何在SpringBoot中实现异常处理,涵盖核心概念、实现方法、与先前查询的集成、性能分析、常见问题和最佳实践,感兴趣的朋友一起看看吧... 目录一、Spring Boot 异常处理的背景与核心概念1.1 为什么需要异常处理?1.2 Spring B

SpringBoot3.4配置校验新特性的用法详解

《SpringBoot3.4配置校验新特性的用法详解》SpringBoot3.4对配置校验支持进行了全面升级,这篇文章为大家详细介绍了一下它们的具体使用,文中的示例代码讲解详细,感兴趣的小伙伴可以参考... 目录基本用法示例定义配置类配置 application.yml注入使用嵌套对象与集合元素深度校验开发

Python位移操作和位运算的实现示例

《Python位移操作和位运算的实现示例》本文主要介绍了Python位移操作和位运算的实现示例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一... 目录1. 位移操作1.1 左移操作 (<<)1.2 右移操作 (>>)注意事项:2. 位运算2.1

如何在 Spring Boot 中实现 FreeMarker 模板

《如何在SpringBoot中实现FreeMarker模板》FreeMarker是一种功能强大、轻量级的模板引擎,用于在Java应用中生成动态文本输出(如HTML、XML、邮件内容等),本文... 目录什么是 FreeMarker 模板?在 Spring Boot 中实现 FreeMarker 模板1. 环

Qt实现网络数据解析的方法总结

《Qt实现网络数据解析的方法总结》在Qt中解析网络数据通常涉及接收原始字节流,并将其转换为有意义的应用层数据,这篇文章为大家介绍了详细步骤和示例,感兴趣的小伙伴可以了解下... 目录1. 网络数据接收2. 缓冲区管理(处理粘包/拆包)3. 常见数据格式解析3.1 jsON解析3.2 XML解析3.3 自定义

使用Python和Pyecharts创建交互式地图

《使用Python和Pyecharts创建交互式地图》在数据可视化领域,创建交互式地图是一种强大的方式,可以使受众能够以引人入胜且信息丰富的方式探索地理数据,下面我们看看如何使用Python和Pyec... 目录简介Pyecharts 简介创建上海地图代码说明运行结果总结简介在数据可视化领域,创建交互式地