jmolecules
1.10
개발자가 주의가 산만하지 않고 단순하고 오래된 Java로 도메인 모델을 구현하는 데 도움이 되는 라이브러리 세트입니다.
보다 쉬운 코드 읽기 및 쓰기를 위해 아키텍처 개념을 명시적으로 표현합니다.
도메인별 코드를 기술적 종속성으로부터 보호하세요. 상용구 코드를 줄입니다.
문서를 자동으로 생성하고 구현 구조와 아키텍처를 검증합니다.
개발자의 삶을 더욱 편리하게 만들어 드립니다.
코드 조각(패키지, 클래스 또는 메서드)이 아키텍처 개념을 구현한다고 표현합니다.
인간 독자가 주어진 코드 조각이 어떤 종류의 아키텍처 개념인지 쉽게 결정할 수 있도록 하십시오.
도구 통합 허용:
코드 확장. (도구 예: Spring 및 JPA 통합이 포함된 ByteBuddy)
아키텍처 규칙을 확인하세요. (도구 예: jQAssistant, ArchUnit).
예: 뱅킹 도메인.
import org . jmolecules . ddd . annotation .*;
@ Entity
class BankAccount {
@ Identity
final IBAN iban ;
/* ... */
}
@ ValueObject
class IBAN { /* ... */ }
@ ValueObject
record Currency { /* ... */ }
@ Repository
class Accounts { /* ... */ } 유비쿼터스 언어를 진지하게 받아들일 때 우리는 도메인 언어의 단어만 포함하는 이름(클래스, 메소드 등)을 원합니다. 즉, 빌딩 블록의 제목이 이름의 일부가 되어서는 안 됩니다. 따라서 은행 도메인에서는 BankAccountEntity , CurrencyVO 또는 심지어 AccountRepository 유형으로 원하지 않습니다. 대신 위의 예와 같이 BankAccount , Currency 및 Accounts 필요합니다.
그럼에도 불구하고 우리는 특정 클래스(또는 기타 아키텍처 요소)가 특별한 구성 요소임을 표현하고 싶습니다. 즉, 디자인 패턴을 사용합니다. jMolecules는 DDD에서 알려진 빌딩 블록에 대한 표준 주석 세트를 제공합니다.
위에서 언급한 주석에 대한 대안으로 jMolecules는 John Sullivan의 "Advancing Enterprise DDD" 시리즈에서 제시된 아이디어를 기반으로 하는 인터페이스 세트도 제공합니다. 이를 통해 유형 시스템 내에서 바로 빌딩 블록 간의 관계를 표현할 수 있으므로 컴파일러는 모델의 정확성을 확인하는 데 도움을 줄 수 있으며 Java 리플렉션을 통해 정보를 더 쉽게 처리할 수도 있습니다.
Identifier — 식별자 역할을 하는 유형을 나타내는 유형입니다.
Identifiable<ID> — 식별자를 노출하는 모든 것.
Entity<T extends AggregateRoot<T, ?>, ID> extends Identifiable<ID> — 자신이 속한 AggregateRoot 와 노출되는 식별자를 선언하는 엔터티입니다.
AggregateRoot<T extends AggregateRoot<T, ID>, ID extends Identifier> extends Entity<T, ID> — 전용 Identifier 노출하는 자체에 속하는 Entity 인 집계 루트
Association<T extends AggregateRoot<T, ID>, ID extends Identifier> extends Identifiable<ID> — 대상 AggregateRoot 에 대한 명시적 연결입니다.
이 배열은 모델링에 대한 지침을 제공하고 잠재적으로 반영을 통해 다음 규칙을 쉽게 확인할 수 있도록 합니다.
서로 다른 집계에 대한 식별자가 혼합되는 것을 방지하기 위해 집계별로 전용 식별자 유형을 적용합니다.
AggregateRoot 자신에 속한다고 선언된 Entity 인스턴스만 참조해야 합니다.
AggregateRoot 및 Entity 는 Association 인스턴스를 통해서만 다른 AggregateRoots 를 참조해야 합니다.
자동화된 검증 및 런타임 기술 통합에 대해서는 jMolecules 통합을 참조하세요.
jmolecules-ddd — 코드에서 DDD 빌딩 블록(값 개체, 엔터티, 집계 루트 등)을 표현하기 위한 주석 및 인터페이스입니다.
jmolecules-events — 코드에서 이벤트의 개념을 표현하기 위한 주석 및 인터페이스입니다.
kmolecules-ddd — 유형 기반 모델의 Kotlin/Java 상호 운용성 문제를 완화하기 위한 jmolecules-ddd 의 Kotlin 기반 버전입니다.
jMolecules는 Layered, Onion 및 Hexagonal Architectures 스타일에 따라 더 높은 수준의 아키텍처 개념을 설명하는 주석을 제공합니다. 이를 통해 전체 패키지를 레이어, 링 또는 포트와 어댑터가 포함된 패키지로 표시할 수 있습니다. 이는 주석을 추가하려는 각 패키지에 대한 package-info.java 파일에 나타납니다. 예:
package-info.java : @ DomainLayer
package org . acmebank . domain ;
import org . jmolecules . architecture . layered .*;package-info.java : @ ApplicationLayer
package org . acmebank . application ;
import org . jmolecules . architecture . layered .*;이렇게 하면 해당 패키지의 모든 클래스가 주석이 달린 레이어, 링의 일부로 간주되거나 포트/어댑터로 간주됩니다.
또는 클래스에 직접 주석을 달 수 있습니다.
import org . jmolecules . architecture . layered .*;
@ DomainLayer
@ Entity
public class BankAccount { /* ... */ }
@ ApplicationLayer
@ Service
public class TransferMoney { /* ... */ }현재 Layered, Onion 및 Hexagonal Architecture에 대한 주석이 존재합니다.
jmolecules-architecture — 코드에서 아키텍처 스타일을 표현하는 주석입니다.
jmolecules-cqrs-architecture — CQRS 아키텍처
@Command
@CommandDispatcher
@CommandHandler
@QueryModel
jmolecules-layered-architecture — 계층화된 아키텍처
@DomainLayer
@ApplicationLayer
@InfrastructureLayer
@InterfaceLayer
jmolecules-onion-architecture — 양파 아키텍처
권위 있는
@DomainModelRing
@DomainServiceRing
@ApplicationServiceRing
@InfrastructureRing
단순화 (도메인 모델과 서비스를 분리하지 않음)
@DomainRing
@ApplicationRing
@InfrastructureRing
jmolecules-hexagonal-architecture — 육각형 아키텍처
@Application
@(Primary|Secondary)Adapter
@(Primary|Secondary)Port
jMolecules 주석과 인터페이스는 특정 대상 기술의 개념을 표현하는 데 필요한 기술 코드를 생성하는 데 사용될 수 있습니다.
Spring, Data JPA, Data MongoDB, Data JDBC 및 Jackson 통합 - jMolecules 주석을 사용하는 코드가 해당 기술에서 즉시 작동하도록 합니다.
코드로 표현된 jMolecules 개념은 개념 정의에서 비롯된 규칙을 확인하고 문서를 생성하는 데 사용될 수 있습니다.
jQAssistant 플러그인 — 다양한 아키텍처 스타일, DDD 빌딩 블록, CQRS 및 이벤트에 적용되는 규칙을 확인합니다. 또한 코드베이스에서 사용 가능한 정보로부터 PlantUML 다이어그램을 생성합니다.
ArchUnit 규칙 — DDD 빌딩 블록 간의 관계를 확인할 수 있습니다.
Spring Modulith — 모듈 모델 및 문서화 목적을 위한 jMolecules 구성 요소, DDD 빌딩 블록 및 이벤트 감지를 지원합니다(자세한 내용은 Spring Modulith 문서 참조).
프로젝트에서 jMolecules를 사용하려면 이에 대한 종속성을 선언하기만 하면 됩니다. 릴리스 바이너리는 Maven 중앙 저장소에서 사용할 수 있습니다. 모든 버전을 명시적으로 선언하지 않으려면 종속성 관리 섹션에서 jmolecules-bom 사용하는 것이 좋습니다.
< dependency >
< groupId >org.jmolecules</ groupId >
< artifactId >jmolecules-ddd</ artifactId >
< version >1.9.0</ version >
</ dependency >repositories {
mavenCentral()
}
dependencies {
implementation( " org.jmolecules:jmolecules-ddd:1.9.0 " )
} mvn release:prepare -DscmReleaseCommitComment="$ticketId - Release version $version." -DscmDevelopmentCommitComment="$ticketId - Prepare next development iteration."
mvn release:perform -Dgpg.keyname=$keyname
