jmolecules

jMolecules 项目介绍

jMolecules 是一组专为 Java 设计的库，这些库帮助开发者以简洁、经典的 Java 代码不受干扰地实现领域模型。

jMolecules 的理念

jMolecules 的设计理念主要包括以下几点：

• 明确的架构概念：旨在更容易阅读和编写代码。
• 领域代码的独立性：保持特定领域的代码不受技术依赖的影响，减少冗余代码。
• 自动文档生成与架构验证：系统自动生成文档并验证实现结构，确保架构的一致性。

项目目标

项目的主要目标如下：

1. 简化开发者的工作：让编写和维护代码变得更为简单。
2. 表达架构概念：能够清晰表明某段代码（如 package、类或方法）实现了特定架构概念。
3. 便于阅读的代码：使人类读者更容易理解代码中体现的架构概念。
4. 工具集成：
   • 增强代码功能。（例如：结合 ByteBuddy、Spring 和 JPA）
   • 检查架构规则。（例如：结合 jQAssistant、ArchUnit）

用例：表达 DDD 概念

在领域驱动设计（DDD）中，jMolecules 提供了注解和接口来表达领域概念。例如在银行领域模型中：

基于注解的模型

通过注解来定义领域对象：

import org.jmolecules.ddd.annotation.*;

@Entity
class BankAccount {
    @Identity
    final IBAN iban;
    /* ... */
}

@ValueObject
class IBAN { /* ... */ }

@ValueObject
record Currency { /* ... */ }

@Repository
class Accounts { /* ... */ }

当认真对待普适语言时，希望类的名字仅包含领域语言中的词汇，例如使用 BankAccount, Currency 和 Accounts 替代冗长的命名。同时，jMolecules 提供一组标准注解，用于常见的 DDD 构建块。

基于类型的模型

除注解外，jMolecules 还提供一组接口，帮助在类型系统中表达构建块之间的关系，通过编译器验证模型的正确性，例如：

• Identifier 和 Identifiable<ID>
• Entity<T extends AggregateRoot<T, ?>, ID>
• AggregateRoot<T extends AggregateRoot<T, ID>, ID extends Identifier>

这些接口引导模型设计，利用反射轻松验证一些原则。

用例：表达架构概念

jMolecules 提供的注解还能描述更高层次的架构概念，收录了层次、洋葱以及六边形架构的风格。开发者可以整个包或类上添加注解，统一识别其所处的架构层次或角色，如：

@DomainLayer
package org.acmebank.domain;

import org.jmolecules.architecture.layered.*;

@ApplicationLayer
@Service
public class TransferMoney { /* ... */ }

这使得包内所有类都被视为注解标识的层次。

用例：生成技术模板代码

jMolecules 提供的注解和接口还能生成特定技术所需的模板代码，使代码与特定技术整合时即开即用。例如在 Spring、JPA、MongoDB、JDBC 和 Jackson 等技术环境中无缝使用。

用例：验证与记录架构

jMolecules 概念不仅能方便验证那些源于定义的规则，还能生成架构文档。例如，通过 jQAssistant 插件生成 PlantUML 图示，通过 ArchUnit 规则检查 DDD 构建块之间的关系。

安装方法

要在项目中使用 jMolecules，只需声明依赖。发布版可从 Maven 中央仓库获取。建议在依赖管理部分使用 jmolecules-bom 来简化版本管理。

Maven 示例

<dependency>
  <groupId>org.jmolecules</groupId>
  <artifactId>jmolecules-ddd</artifactId>
  <version>1.9.0</version>
</dependency>

Gradle 示例

repositories {
  mavenCentral()
}
dependencies {
  implementation("org.jmolecules:jmolecules-ddd:1.9.0")
}

通过上述方式，开发者可以快速在项目中集成并使用 jMolecules，享受其带来的种种便利与益处。