#23 Reduce code duplication in equalsQueryString() implememtations

Signed-off-by: Sven Strittmatter <sven.strittmatter@iteratec.com>

Author: Weltraumschaf

src/main/java/io/securecodebox/persistence/defectdojo/model/Endpoint.java

@@ -16,7 +16,7 @@
 @AllArgsConstructor
 @EqualsAndHashCode
 @JsonInclude(JsonInclude.Include.NON_NULL)
-public final class Endpoint implements Model {
+public final class Endpoint implements Model, HasId {
   @JsonProperty
   private long id;
 
@@ -49,10 +49,11 @@ public final class Endpoint implements Model {
 
   @Override
   public boolean equalsQueryString(Map<String, Object> queryParams) {
-    if (queryParams == null) {
+    if (QueryParamsComparator.isNull(queryParams)) {
       return false;
     }
 
-    return queryParams.containsKey("id") && queryParams.get("id").equals(this.id);
+    return QueryParamsComparator.isIdEqual(this, queryParams);
   }
+
 }

src/main/java/io/securecodebox/persistence/defectdojo/model/Engagement.java

@@ -17,12 +17,12 @@
 @AllArgsConstructor
 @EqualsAndHashCode
 @JsonInclude(JsonInclude.Include.NON_NULL)
-public final class Engagement implements Model {
+public final class Engagement implements Model, HasId, HasName {
   @JsonProperty("branch_tag")
   private String branch;
 
   @JsonProperty
-  private Long id;
+  private long id;
 
   @JsonProperty
   private String name;
@@ -94,15 +94,15 @@ public final class Engagement implements Model {
 
   @Override
   public boolean equalsQueryString(Map<String, Object> queryParams) {
-    if (queryParams == null) {
+    if (QueryParamsComparator.isNull(queryParams)) {
       return false;
     }
 
-    if (queryParams.containsKey("id") && queryParams.get("id") != null && queryParams.get("id").equals(this.id)) {
+    if (QueryParamsComparator.isIdEqual(this, queryParams)) {
       return true;
     }
 
-    if (queryParams.containsKey("name") && queryParams.get("name") != null && queryParams.get("name").equals(this.name)) {
+    if (QueryParamsComparator.isNameEqual(this, queryParams)) {
       return true;
     }
 

src/main/java/io/securecodebox/persistence/defectdojo/model/Finding.java

@@ -21,7 +21,7 @@
 @AllArgsConstructor
 @EqualsAndHashCode
 @JsonInclude(JsonInclude.Include.NON_NULL)
-public final class Finding implements Model {
+public final class Finding implements Model, HasId {
   @JsonProperty
   private long id;
 
@@ -121,11 +121,11 @@ public String getNumericalSeverity() {
 
   @Override
   public boolean equalsQueryString(Map<String, Object> queryParams) {
-    if (queryParams == null) {
+    if (QueryParamsComparator.isNull(queryParams)) {
       return false;
     }
 
-    return queryParams.containsKey("id") && queryParams.get("id").equals(this.id);
+    return QueryParamsComparator.isIdEqual(this, queryParams);
   }
 
   public enum Severity {

src/main/java/io/securecodebox/persistence/defectdojo/model/Group.java

@@ -17,7 +17,7 @@
 @AllArgsConstructor
 @EqualsAndHashCode
 @JsonInclude(JsonInclude.Include.NON_NULL)
-public final class Group implements Model {
+public final class Group implements Model, HasId, HasName {
   @JsonProperty
   private long id;
 
@@ -36,15 +36,15 @@ public final class Group implements Model {
 
   @Override
   public boolean equalsQueryString(Map<String, Object> queryParams) {
-    if (queryParams == null) {
+    if (QueryParamsComparator.isNull(queryParams)) {
       return false;
     }
 
-    if (queryParams.containsKey("id") && queryParams.get("id").equals(this.id)) {
+    if (QueryParamsComparator.isIdEqual(this, queryParams)) {
       return true;
     }
 
-    if (queryParams.containsKey("name") && queryParams.get("name").equals(this.name)) {
+    if (QueryParamsComparator.isNameEqual(this, queryParams)) {
       return true;
     }
 

src/main/java/io/securecodebox/persistence/defectdojo/model/HasId.java

@@ -0,0 +1,18 @@
+// SPDX-FileCopyrightText: the secureCodeBox authors
+//
+// SPDX-License-Identifier: Apache-2.0
+
+package io.securecodebox.persistence.defectdojo.model;
+
+/**
+ * Interface to mark {@link Model models} which have an id
+ * <p>
+ * This type is package private because it is an implementation detail of the models and
+ * z should not be used outside of this package.
+ * </p>
+ */
+interface HasId {
+  long getId();
+
+  void setId(long id);
+}

src/main/java/io/securecodebox/persistence/defectdojo/model/HasName.java

@@ -0,0 +1,18 @@
+// SPDX-FileCopyrightText: the secureCodeBox authors
+//
+// SPDX-License-Identifier: Apache-2.0
+
+package io.securecodebox.persistence.defectdojo.model;
+
+/**
+ * Interface to mark {@link Model models} which have a name
+ * <p>
+ * This type is package private because it is an implementation detail of the models and
+ * z should not be used outside of this package.
+ * </p>
+ */
+interface HasName {
+  String getName();
+
+  void setName(String id);
+}

src/main/java/io/securecodebox/persistence/defectdojo/model/Product.java

@@ -17,7 +17,7 @@
 @AllArgsConstructor
 @EqualsAndHashCode
 @JsonInclude(JsonInclude.Include.NON_NULL)
-public final class Product implements Model {
+public final class Product implements Model, HasId, HasName {
   @JsonProperty
   private long id;
 
@@ -53,15 +53,15 @@ public final class Product implements Model {
 
   @Override
   public boolean equalsQueryString(Map<String, Object> queryParams) {
-    if (queryParams == null) {
+    if (QueryParamsComparator.isNull(queryParams)) {
       return false;
     }
 
-    if (queryParams.containsKey("id") && queryParams.get("id").equals(this.id)) {
+    if (QueryParamsComparator.isIdEqual(this, queryParams)) {
       return true;
     }
 
-    if (queryParams.containsKey("name") && queryParams.get("name").equals(this.name)) {
+    if (QueryParamsComparator.isNameEqual(this, queryParams)) {
       return true;
     }
 

src/main/java/io/securecodebox/persistence/defectdojo/model/ProductType.java

@@ -16,7 +16,7 @@
 @AllArgsConstructor
 @EqualsAndHashCode
 @JsonInclude(JsonInclude.Include.NON_NULL)
-public final class ProductType implements Model {
+public final class ProductType implements Model, HasId, HasName {
   @JsonProperty
   private long id;
 
@@ -32,15 +32,15 @@ public final class ProductType implements Model {
 
   @Override
   public boolean equalsQueryString(Map<String, Object> queryParams) {
-    if (queryParams == null) {
+    if (QueryParamsComparator.isNull(queryParams)) {
       return false;
     }
 
-    if (queryParams.containsKey("id") && queryParams.get("id").equals(this.id)) {
+    if (QueryParamsComparator.isIdEqual(this, queryParams)) {
       return true;
     }
 
-    if (queryParams.containsKey("name") && queryParams.get("name").equals(this.name)) {
+    if (QueryParamsComparator.isNameEqual(this, queryParams)) {
       return true;
     }
 

src/main/java/io/securecodebox/persistence/defectdojo/model/QueryParamsComparator.java

@@ -0,0 +1,65 @@
+// SPDX-FileCopyrightText: the secureCodeBox authors
+//
+// SPDX-License-Identifier: Apache-2.0
+
+package io.securecodebox.persistence.defectdojo.model;
+
+import java.util.Map;
+
+/**
+ * Pure static helper class
+ * <p>
+ * This type is package private because it is an implementation detail of the models and
+ * should not be used outside of this package.
+ * </p>
+ */
+final class QueryParamsComparator {
+
+  static final String QUERY_PARAM_KEY_FOR_ID = "id";
+  static final String QUERY_PARAM_KEY_FOR_NAME = "name";
+
+  private QueryParamsComparator() {
+    super();
+  }
+
+  static boolean isNull(Object o) {
+    return o == null;
+  }
+
+  static boolean isIdEqual(HasId model, Map<String, Object> queryParams) {
+    if (isNull(model)) {
+      return false;
+    }
+
+    if (isNull(queryParams)) {
+      return false;
+    }
+
+    if (!queryParams.containsKey(QUERY_PARAM_KEY_FOR_ID)) {
+      return false;
+    }
+
+    // FIXME: Since th generic type for value is Object, possible NPE here!
+    return queryParams.get(QUERY_PARAM_KEY_FOR_ID).equals(model.getId());
+  }
+
+  static boolean isNameEqual(HasName model, Map<String, Object> queryParams) {
+    if (isNull(model)) {
+      return false;
+    }
+
+    if (isNull(queryParams)) {
+      return false;
+    }
+
+    if (!queryParams.containsKey(QUERY_PARAM_KEY_FOR_NAME)) {
+      return false;
+    }
+
+    if (isNull(queryParams.get(QUERY_PARAM_KEY_FOR_NAME))) {
+      return false;
+    }
+
+    return queryParams.get(QUERY_PARAM_KEY_FOR_NAME).equals(model.getName());
+  }
+}

src/main/java/io/securecodebox/persistence/defectdojo/model/RiskAcceptance.java

@@ -17,7 +17,7 @@
 @AllArgsConstructor
 @EqualsAndHashCode
 @JsonInclude(JsonInclude.Include.NON_NULL)
-public final class RiskAcceptance implements Model {
+public final class RiskAcceptance implements Model, HasId {
   @JsonProperty
   private long id;
 
@@ -58,10 +58,10 @@ public final class RiskAcceptance implements Model {
 
   @Override
   public boolean equalsQueryString(Map<String, Object> queryParams) {
-    if (queryParams == null) {
+    if (QueryParamsComparator.isNull(queryParams)) {
       return false;
     }
 
-    return queryParams.containsKey("id") && queryParams.get("id").equals(this.id);
+    return QueryParamsComparator.isIdEqual(this, queryParams);
   }
 }