Add ArchUnit example.

Author: odrotbohm

jmolecules-example-archunit/pom.xml

@@ -0,0 +1,49 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+	<modelVersion>4.0.0</modelVersion>
+
+	<parent>
+		<groupId>org.jmolecules.examples</groupId>
+		<artifactId>jmolecules-examples</artifactId>
+		<version>1.0.0-SNAPSHOT</version>
+	</parent>
+
+	<artifactId>jmolecules-example-archunit</artifactId>
+	<name>jMolecules Examples - ArchUnit</name>
+	
+	<dependencies>
+	
+		<dependency>
+			<groupId>org.jmolecules</groupId>
+			<artifactId>jmolecules-ddd</artifactId>
+		</dependency>
+	
+		<dependency>
+			<groupId>org.jmolecules.integrations</groupId>
+			<artifactId>jmolecules-archunit</artifactId>
+			<scope>test</scope>
+		</dependency>
+		
+		<dependency>
+			<groupId>com.tngtech.archunit</groupId>
+			<artifactId>archunit-junit5</artifactId>
+			<version>${archunit.version}</version>
+			<scope>test</scope>
+		</dependency>
+
+		<dependency>
+			<groupId>org.junit.jupiter</groupId>
+			<artifactId>junit-jupiter</artifactId>
+			<scope>test</scope>
+		</dependency>
+
+		<dependency>
+			<groupId>org.assertj</groupId>
+			<artifactId>assertj-core</artifactId>
+			<scope>test</scope>
+		</dependency>
+
+	</dependencies>
+	
+</project>

jmolecules-example-archunit/src/main/java/example/MyAggregateRoot.java

@@ -0,0 +1,14 @@
+package example;
+
+import org.jmolecules.ddd.types.AggregateRoot;
+import org.jmolecules.ddd.types.Identifier;
+
+public class MyAggregateRoot implements AggregateRoot<MyAggregateRoot, Identifier> {
+
+	MyAggregateRoot aggregate;
+
+	@Override
+	public Identifier getId() {
+		return null;
+	}
+}

jmolecules-example-archunit/src/test/java/example/ArchitectureTests.java

@@ -0,0 +1,38 @@
+/*
+ * Copyright 2024 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package example;
+
+import static org.assertj.core.api.Assertions.*;
+
+import org.jmolecules.archunit.JMoleculesDddRules;
+
+import com.tngtech.archunit.core.domain.JavaClasses;
+import com.tngtech.archunit.junit.AnalyzeClasses;
+import com.tngtech.archunit.junit.ArchTest;
+
+@AnalyzeClasses(packagesOf = MyAggregateRoot.class)
+class ArchitectureTests {
+
+	@ArchTest
+	void detectsArchitectureViolation(JavaClasses classes) {
+
+		var violations = JMoleculesDddRules.all().evaluate(classes);
+
+		assertThat(violations.getFailureReport().getDetails()).hasSize(1)
+				.element(0).asString()
+				.contains("Field", "aggregate", "Association");
+	}
+}

pom.xml

@@ -13,6 +13,7 @@
 	<modules>
 		<module>jmolecules-axon</module>
 		<module>jmolecules-ddd-apt</module>
+		<module>jmolecules-example-archunit</module>
 		<module>jmolecules-kotlin</module>
 		<module>jmolecules-presentation</module>
 		<module>jmolecules-spring-data-jdbc</module>