add ArchUnit examples

Author: rieckpil

spring-boot-example/pom.xml

@@ -32,6 +32,7 @@
     <selenide.version>7.7.0</selenide.version>
     <selenium.version>4.27.0</selenium.version>
     <awaitility.version>4.2.2</awaitility.version>
+    <archunit.version>1.3.0</archunit.version>
     <rest-assured.version>5.5.0</rest-assured.version>
     <greenmail.version>2.1.2</greenmail.version>
     <groovy.version>4.0.24</groovy.version>
@@ -275,6 +276,11 @@
       <artifactId>rest-assured</artifactId>
       <scope>test</scope>
     </dependency>
+    <dependency>
+      <groupId>com.tngtech.archunit</groupId>
+      <artifactId>archunit-junit5</artifactId>
+      <version>${archunit.version}</version>
+    </dependency>
 
     <!-- Performance Testing -->
     <dependency>

spring-boot-example/src/main/java/de/rieckpil/blog/controller/SomeController.java

@@ -0,0 +1,4 @@
+package de.rieckpil.blog.controller;
+
+public class SomeController {
+}

spring-boot-example/src/main/java/de/rieckpil/blog/service/SomeService.java

@@ -0,0 +1,5 @@
+package de.rieckpil.blog.service;
+
+public class SomeService {
+
+}

spring-boot-example/src/test/java/de/rieckpil/blog/archunit/ArchitectureTest.java

@@ -0,0 +1,73 @@
+package de.rieckpil.blog.archunit;
+
+import java.time.Clock;
+import java.time.LocalDate;
+
+import com.tngtech.archunit.core.domain.JavaClasses;
+import com.tngtech.archunit.core.importer.ClassFileImporter;
+import com.tngtech.archunit.core.importer.ImportOption;
+import com.tngtech.archunit.lang.ArchRule;
+import com.tngtech.archunit.lang.syntax.ArchRuleDefinition;
+import com.tngtech.archunit.library.dependencies.SlicesRuleDefinition;
+import org.junit.jupiter.api.Test;
+
+import static com.tngtech.archunit.lang.syntax.ArchRuleDefinition.noClasses;
+
+class ArchitectureTest {
+
+  @Test
+  void servicesShouldNotDependOnControllers() {
+    JavaClasses importedClasses = new ClassFileImporter().importPackages("de.rieckpil.blog");
+
+    noClasses()
+      .that().resideInAPackage("de.rieckpil.blog.service")
+      .should().dependOnClassesThat().resideInAPackage("de.rieckpil.blog.controller")
+      .check(importedClasses);
+  }
+
+  @Test
+  void localDateNowShouldUseClock() {
+    ArchRule rule = noClasses().should()
+      .callMethod(LocalDate.class, "now");
+
+    rule.check(new ClassFileImporter()
+      .withImportOption(ImportOption.Predefined.DO_NOT_INCLUDE_TESTS)
+      .importPackages("de.rieckpil"));
+  }
+
+  @Test
+  void noCyclicDependencies() {
+    JavaClasses importedClasses = new ClassFileImporter().importPackages("de.rieckpil");
+
+    SlicesRuleDefinition.slices()
+      .matching("de.rieckpil.(*)..")
+      .should().beFreeOfCycles()
+      .check(importedClasses);
+  }
+
+  @Test
+  void serviceClassesShouldHaveProperNaming() {
+    JavaClasses importedClasses = new ClassFileImporter().importPackages("de.rieckpil");
+
+    ArchRuleDefinition.classes()
+      .that().resideInAPackage("de.rieckpil.blog.service")
+      .should().haveSimpleNameEndingWith("Service")
+      .check(importedClasses);
+  }
+
+  @Test
+  void shouldNotUseJavaUtilLogging() {
+    JavaClasses importedClasses = new ClassFileImporter()
+      .withImportOption(ImportOption.Predefined.DO_NOT_INCLUDE_TESTS)
+      .importPackages("de.rieckpil");
+
+    noClasses()
+      .should().dependOnClassesThat().belongToAnyOf(java.util.logging.Logger.class)
+      .check(importedClasses);
+  }
+
+  public static final ArchRule serviceLayerShouldNotAccessRepositoriesDirectly =
+    noClasses()
+      .that().resideInAPackage("de.rieckpil")
+      .should().dependOnClassesThat().resideInAPackage("de.rieckpil");
+}