YDB ORM for Java (YOJ)是一个针对不可变实体的轻量级 ORM。
YOJ 与 YDB 集成良好,并且它还具有内存存储库实现,具有类似 YDB 的语义,可用于闪电般快速的持久性测试。
YOJ 根据 Apache 许可证 2.0 版获得许可。
如果您希望向 YOJ 做出贡献,请参阅外部贡献者通知,并遵循指南。
要在您的项目中使用 YOJ ,只需将 YOJ BOM(物料清单)添加到您的 Maven
中:
<依赖关系>tech.ydb.yoj yoj-bom <版本>2.6.1版本> <类型>pom类型> <范围>导入范围> 依赖>
然后仅依赖于您需要的模块,仅指定groupId
= tech.ydb.yoj
和artifactId
= yoj-
(请参阅下面的
名称)。
? YOJ由以下模块组成:
databind
:核心数据绑定逻辑,用于在 Java 对象和数据库行(或者实际上由 Java Map
表示的任何内容)之间进行转换。
repository
:实体、存储库、事务等的核心抽象和 API。实体 API 被设计为侵入性最小,以便您的域对象(具有所有有趣的业务逻辑!)可以轻松成为实体。
repository-ydb-v2
:YDB 的存储库 API 实现。使用 YDB SDK v2.x。受到推崇的。
repository-inmemory
:使用 Eclipse Collections 中的持久数据结构的内存存储库 API 实现。具有类似 YDB 的数据修改语义,可以轻松快速地测试您的业务逻辑,而无需旋转容器或访问真实的 YDB 安装。强烈推荐。
repository-ydb-common
:所有 YDB 存储库实现的通用逻辑,无论使用什么 YDB SDK 版本。
repository-test
:所有存储库实现都必须通过的基本测试。
json-jackson-v2
:支持实体字段的 JSON 序列化和反序列化,使用 Jackson 2.x。
aspect
:AspectJ 方面和@YojTransactional
注释,用于 AspectJ 和 Spring AOP。为需要启动或继续 YDB 事务的方法提供类似 Spring @Transactional
的体验。
ext-meta-generator
:注释处理器,为每个Entity
字段生成字段路径,与TableQueryBuilder
( Table.query()
DSL) 和YqlPredicate
一起使用。
util
:YOJ 实现中使用的实用程序类。