Merge branch 'main' into add-approach-change

exercises/practice/queen-attack/.approaches/config.json

@@ -0,0 +1,22 @@
+{
+  "introduction": {
+    "authors": [
+      "jagdish-15"
+    ],
+    "contributors": [
+      "kahgoh",
+      "tasxatzial"
+    ]
+  },
+  "approaches": [
+    {
+      "uuid": "b2e474c8-b778-41e7-83c0-8e41cc84af9e",
+      "slug": "difference-comparison",
+      "title": "Difference Comparison Approach",
+      "blurb": "Use difference comparison checks to determine if queens can attack each other.",
+      "authors": [
+        "jagdish-15"
+      ]
+    }
+  ]
+}

exercises/practice/queen-attack/.approaches/difference-comparison/content.md

@@ -0,0 +1,46 @@
+# Difference Comparison Approach
+
+```java
+class QueenAttackCalculator {
+    private final Queen queen1;
+    private final Queen queen2;
+
+    QueenAttackCalculator(Queen queen1, Queen queen2) {
+        if (queen1 == null || queen2 == null) {
+            throw new IllegalArgumentException("You must supply valid positions for both Queens.");
+        }
+        if (queen1.getRow() == queen2.getRow() && queen1.getColumn() == queen2.getColumn()) {
+            throw new IllegalArgumentException("Queens cannot occupy the same position.");
+        }
+        this.queen1 = queen1;
+        this.queen2 = queen2;
+    }
+
+    boolean canQueensAttackOneAnother() {
+        int rowDifference = Math.abs(queen1.getRow() - queen2.getRow());
+        int columnDifference = Math.abs(queen1.getColumn() - queen2.getColumn());
+        return rowDifference == 0 || columnDifference == 0 || rowDifference == columnDifference;
+    }
+}
+```
+
+## Explanation
+
+### Constructor
+
+The constructor takes two `Queen` objects, `queen1` and `queen2`, and stores them as instance variables after validating the following conditions:
+
+- Either queen is `null`.
+- Both queens occupy the same position.
+
+If either of these conditions is true, an exception is thrown.
+
+### `canQueensAttackOneAnother` Method
+
+This method calculates the row and column differences between the two queens and checks the following conditions:
+
+- The row difference is zero (the queens are on the same row).
+- The column difference is zero (the queens are on the same column).
+- The row and column differences are equal (the queens are on the same diagonal).
+
+If any of these conditions are true, the method returns `true`, indicating that the queens can attack each other.

exercises/practice/queen-attack/.approaches/difference-comparison/snippet.txt

@@ -0,0 +1,5 @@
+boolean canQueensAttackOneAnother() {
+    int rowDifference = Math.abs(queen1.getRow() - queen2.getRow());
+    int columnDifference = Math.abs(queen1.getColumn() - queen2.getColumn());
+    return rowDifference == 0 || columnDifference == 0 || rowDifference == columnDifference;
+}

exercises/practice/queen-attack/.approaches/introduction.md

@@ -0,0 +1,43 @@
+# Introduction
+
+In this exercise, we determine if two queens on a chessboard can attack each other based on their positions.
+A queen in chess can move any number of squares horizontally, vertically, or diagonally.
+The task is to check if two queens, placed on specific coordinates, can attack each other.
+
+## General Guidance
+
+The problem boils down to checking three conditions:
+
+1. **Same Row**: The queens are on the same row.
+2. **Same Column**: The queens are on the same column.
+3. **Same Diagonal**: The queens are on the same diagonal, i.e., the absolute difference between their row and column positions is equal.
+
+## Approach: Difference Comparison Approach
+
+```java
+class QueenAttackCalculator {
+    private final Queen queen1;
+    private final Queen queen2;
+
+    QueenAttackCalculator(Queen queen1, Queen queen2) {
+        if (queen1 == null || queen2 == null) {
+            throw new IllegalArgumentException("You must supply valid positions for both Queens.");
+        }
+        if (queen1.getRow() == queen2.getRow() && queen1.getColumn() == queen2.getColumn()) {
+            throw new IllegalArgumentException("Queens cannot occupy the same position.");
+        }
+        this.queen1 = queen1;
+        this.queen2 = queen2;
+    }
+
+    boolean canQueensAttackOneAnother() {
+        int rowDifference = Math.abs(queen1.getRow() - queen2.getRow());
+        int columnDifference = Math.abs(queen1.getColumn() - queen2.getColumn());
+        return rowDifference == 0 || columnDifference == 0 || rowDifference == columnDifference;
+    }
+}
+```
+
+For more details on the implementation of this approach, check out the [Difference Comparison Approach][difference-comparison-approach].
+
+[difference-comparison-approach]: https://exercism.org/tracks/java/exercises/queen-attack/approaches/difference-comparison