feat: deprecate sourceClass() method in Relation and create the annot…

README.md

@@ -77,7 +77,7 @@ relations are only working with classed which are **annotated with @Entity**!
 
 ```java
 
-@Relation(sourceClass = Person.class)
+@Relation
 @Entity
 @Getter
 @Setter
@@ -108,7 +108,7 @@ This is useful for:
 
 ```java
 @IgnoreRelation
-@Relation(sourceClass = DisabledRelationEntity.class)
+@Relation
 @Entity
 public class DisabledRelationEntity {
 
@@ -124,7 +124,7 @@ Implement the relationIdentity, each dynamic relation need a Long id and a Strin
 
 ```java
 
-@Relation(sourceClass = Person.class)
+@Relation
 @Entity
 @Getter
 @Setter
@@ -142,14 +142,15 @@ public class Person implements RelationIdentity {
 
 ```
 
-## <a name="ImportConfig"></a> Import Config Module for Component Scan
+## <a name="ImportConfig"></a> Import Configuration Module for Component Scanning and Relation Support
 
-Import the DrmConfig in your Spring Boot Application, so that you can use the RelationService
+Enable the `DrmConfig` configuration in your Spring Boot application by using the custom `@EnableDynamicRelation` annotation.   
+This activates component scanning for the `at.drm.*` packages and makes the `RelationService` and related beans available for use.
 
 ```java
 
+@EnableDynamicRelation
 @SpringBootApplication
-@Import(DrmConfig.class)
 public class App {
 
     public static void main(String[] args) {

dynamic-relations/src/main/java/at/drm/DrmConfig.java

@@ -5,5 +5,5 @@
 
 @Configuration
 @ComponentScan(basePackageClasses = DrmConfig.class)
-public class DrmConfig {
+class DrmConfig {
 }

dynamic-relations/src/main/java/at/drm/EnableDynamicRelation.java

@@ -0,0 +1,14 @@
+package at.drm;
+
+import org.springframework.context.annotation.Import;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Target(ElementType.TYPE)
+@Retention(RetentionPolicy.RUNTIME)
+@Import(DrmConfig.class)
+public @interface EnableDynamicRelation {
+}

dynamic-relations/src/main/java/at/drm/annotation/Relation.java

@@ -8,5 +8,4 @@
 @Target(ElementType.TYPE)
 @Retention(RetentionPolicy.CLASS)
 public @interface Relation {
-    Class<?> sourceClass();
 }

dynamic-relations/src/main/java/at/drm/processor/RelationProcessor.java

@@ -97,7 +97,7 @@ private RelationMetaData createEntityMetaData(Element relationElement) {
         Relation relationAnnotation = relationElement.getAnnotation(Relation.class);
         String elementPackage = processingEnv.getElementUtils()
             .getPackageOf(relationElement).getQualifiedName().toString();
-        TypeName sourceObjectName = getSourceObjectTypeName(relationAnnotation);
+        TypeName sourceObjectName = ClassName.get(relationElement.asType());
         String sourceObjectWithoutPackages = sourceObjectName.toString().replace(elementPackage + ".", "");
         String generatedEntityName = sourceObjectWithoutPackages + "Relation";
         return new RelationMetaData(sourceObjectName, elementPackage, generatedEntityName, relationAnnotation);
@@ -203,12 +203,6 @@ private static FieldSpec createTargetIdField() {
             .build();
     }
 
-    private TypeName getSourceObjectTypeName(Relation annotation) {
-        TypeMirror typeMirror = getSourceClass(annotation);
-        assert typeMirror != null;
-        return ClassName.get(typeMirror);
-    }
-
     private FieldSpec createSourceObjectField(TypeName typeName) {
         return FieldSpec.builder(typeName, "sourceObject", Modifier.PRIVATE)
             .addAnnotation(ManyToOne.class)
@@ -255,16 +249,4 @@ private void createJavaClass(JavaFile javaFile) {
                     e.getMessage());
         }
     }
-
-
-    //TODO refactor with the more right way see:
-    // https://stackoverflow.com/questions/7687829/java-6-annotation-processing-getting-a-class-from-an-annotation
-    private TypeMirror getSourceClass(Relation annotation) {
-        try {
-            annotation.sourceClass(); // this should throw
-        } catch (MirroredTypeException mte) {
-            return mte.getTypeMirror();
-        }
-        return null; // can this ever happen ??
-    }
 }

dynamic-relations/src/test/resources/TestFile.java

@@ -6,7 +6,7 @@
 import jakarta.persistence.GenerationType;
 import jakarta.persistence.Id;
 
-@Relation(sourceClass = TestFile.class)
+@Relation
 @Entity
 public class TestFile {
     @Id

dynamic-relations/src/test/resources/TestFileWithIgnoreRelation.java

@@ -8,7 +8,7 @@
 import jakarta.persistence.Id;
 
 @IgnoreRelation
-@Relation(sourceClass = TestFileWithIgnoreRelation.class)
+@Relation
 @Entity
 public class TestFileWithIgnoreRelation {
     @Id

testing/src/main/java/at/test/drm/AnnotationTest.java

@@ -9,7 +9,7 @@
 import jakarta.persistence.GenerationType;
 import jakarta.persistence.Id;
 
-@Relation(sourceClass = AnnotationTest.class)
+@Relation
 @Entity
 @Data
 public class AnnotationTest implements RelationIdentity {

testing/src/main/java/at/test/drm/AnnotationTest2.java

@@ -9,7 +9,7 @@
 import jakarta.persistence.GenerationType;
 import jakarta.persistence.Id;
 
-@Relation(sourceClass = AnnotationTest2.class)
+@Relation
 @Entity
 @Data
 public class AnnotationTest2 implements RelationIdentity {

testing/src/main/java/at/test/drm/AnnotationTest3.java

@@ -9,7 +9,7 @@
 import jakarta.persistence.GenerationType;
 import jakarta.persistence.Id;
 
-@Relation(sourceClass = AnnotationTest3.class)
+@Relation
 @Entity
 @Data
 public class AnnotationTest3 implements RelationIdentity {

testing/src/test/java/at/test/drm/ApplicationIntegrationTest.java

@@ -1,6 +1,6 @@
 package at.test.drm;
 
-import at.drm.DrmConfig;
+import at.drm.EnableDynamicRelation;
 import at.drm.model.RelationLink;
 import at.drm.service.RelationService;
 import io.zonky.test.db.AutoConfigureEmbeddedDatabase;
@@ -9,15 +9,14 @@
 import org.junit.jupiter.api.Test;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.test.context.SpringBootTest;
-import org.springframework.context.annotation.Import;
 import org.springframework.test.context.ActiveProfiles;
 
 import java.util.List;
 import java.util.Set;
 
 @SpringBootTest
 @ActiveProfiles("integration")
-@Import(DrmConfig.class)
+@EnableDynamicRelation
 @AutoConfigureEmbeddedDatabase(provider = DatabaseProvider.ZONKY)
 class ApplicationIntegrationTest {