고생하셨습니다.

dd-jiyun · web-flow · commit 603ba163b6e3 · 2025-05-31T17:22:14.000+09:00
🎉 PR 머지 완료! 🎉
diff --git a/README.md b/README.md
@@ -0,0 +1,41 @@
+# 🪜 사다리
+
+## 네이버 사다리 게임 흐름
+
+1. 참여 인원을 입력한다.
+2. 시작하면 이름과 항목을 입력한다.
+3. 랜덤한 사다리 라인이 생겨난다. (겹치지 않는 가로라인)
+4. 결과를 출력한다.
+
+## 요구사항
+
+- 사다리는 4x4 크기 고정
+- 클래스는 3개 이상의 인스턴스 변수 가질 수 없음.
+- 모든 엔티티 작게
+
+## 구현 기능
+
+### 사다리
+
+- 여러 개의 라인을 가지고 있다.
+- 전체 구조를 나타낸다.
+
+### 라인
+
+- 한 줄을 나타내는 포인트 들을 가진다.
+- 연결 상태를 관리하고 연결한다.
+
+### 포인트
+
+- 연결 여부를 판단한다.
+
+## 출력 예시
+
+```text
+실행결과
+
+     |     |-----|     |
+     |-----|     |-----|
+     |     |-----|     |
+     |-----|     |     |
+```
diff --git a/src/main/java/.gitkeep b/src/main/java/.gitkeep
diff --git a/src/main/java/LadderApplication.java b/src/main/java/LadderApplication.java
@@ -0,0 +1,17 @@
+import domain.Ladder;
+import strategy.PointGenerator;
+import strategy.RandomGenerator;
+import view.OutputView;
+
+public class LadderApplication {
+    public static void main(String[] args) {
+        int width = 4;
+        int height = 4;
+
+        PointGenerator generator = new RandomGenerator();
+        Ladder ladder = Ladder.create(width, height, generator);
+
+        OutputView.printLadderResultTitle();
+        OutputView.paintLadder(ladder);
+    }
+}
diff --git a/src/main/java/domain/Ladder.java b/src/main/java/domain/Ladder.java
@@ -0,0 +1,27 @@
+package domain;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import strategy.PointGenerator;
+
+public class Ladder {
+    private final List<Line> lines;
+
+    private Ladder(final List<Line> lines) {
+        this.lines = Collections.unmodifiableList(lines);
+    }
+
+    public static Ladder create(final int width, final int height, final PointGenerator generator) {
+        List<Line> lines = new ArrayList<>();
+        for (int i = 0; i < height; i++) {
+            lines.add(Line.create(width, generator));
+        }
+
+        return new Ladder(lines);
+    }
+
+    public List<Line> getLines() {
+        return lines;
+    }
+}
diff --git a/src/main/java/domain/Line.java b/src/main/java/domain/Line.java
@@ -0,0 +1,47 @@
+package domain;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import strategy.PointGenerator;
+
+public class Line {
+
+    private final List<Point> points;
+
+    private Line(final List<Point> points) {
+        this.points = Collections.unmodifiableList(points);
+    }
+
+    public static Line create(final int width, final PointGenerator generator) {
+        return new Line(generatePoints(width, generator));
+    }
+
+     /**
+     * 주어진 너비와 PointGenerator를 바탕으로, 왼쪽에서 오른쪽 방향으로 연결된 Point 리스트를 생성한다.
+     * 첫 번째 Point는 {@code Point.first()} 를 통해 생성되며,
+     * 이후 Point는 이전 Point의 연결 상태를 기준으로 오른쪽으로 순차적으로 생성된다.
+     * <p>
+     * * 사다리는 왼쪽에서 오른쪽으로만 연결된다는 전제 하에 동작한다.
+
+     * @param width 사다리의 너비
+     * @param generator 오른쪽 연결 여부를 결정하는 PointGenerator
+     * @return 연결된 Point 리스트
+     */
+    private static List<Point> generatePoints(final int width, final PointGenerator generator) {
+        List<Point> points = new ArrayList<>();
+        Point first = Point.first(generator.generate());
+        points.add(first);
+
+        for (int i = 1; i < width; i++) {
+            first = first.connectNext(generator.generate());
+            points.add(first);
+        }
+
+        return points;
+    }
+
+    public List<Point> getPoints() {
+        return points;
+    }
+}
diff --git a/src/main/java/domain/Point.java b/src/main/java/domain/Point.java
@@ -0,0 +1,17 @@
+package domain;
+
+public record Point(
+        boolean right
+) {
+
+    public static Point first(final boolean right) {
+        return new Point(right);
+    }
+
+    public Point connectNext(final boolean canConnectRight) {
+        if (this.right) {
+            return new Point(false);
+        }
+        return new Point(canConnectRight);
+    }
+}
diff --git a/src/main/java/strategy/PointGenerator.java b/src/main/java/strategy/PointGenerator.java
@@ -0,0 +1,5 @@
+package strategy;
+
+public interface PointGenerator {
+    boolean generate();
+}
diff --git a/src/main/java/strategy/RandomGenerator.java b/src/main/java/strategy/RandomGenerator.java
@@ -0,0 +1,13 @@
+package strategy;
+
+import java.util.Random;
+
+public class RandomGenerator implements PointGenerator {
+
+    private final Random random = new Random();
+
+    @Override
+    public boolean generate() {
+        return random.nextBoolean();
+    }
+}
diff --git a/src/main/java/view/OutputView.java b/src/main/java/view/OutputView.java
@@ -0,0 +1,48 @@
+package view;
+
+import domain.Ladder;
+import domain.Line;
+import domain.Point;
+import java.util.List;
+
+public final class OutputView {
+
+    private static final String LADDER_RESULT_TITLE = "실행결과";
+    private static final String BLANK = "     ";
+    private static final String VERTICAL = "|";
+    private static final String HORIZONTAL = "-----";
+
+    private OutputView() {
+    }
+
+    public static void printLadderResultTitle() {
+        System.out.println(LADDER_RESULT_TITLE);
+        System.out.println();
+    }
+
+    public static void paintLadder(final Ladder ladder) {
+        for (Line line : ladder.getLines()) {
+            paintLine(line);
+        }
+    }
+
+    private static void paintLine(final Line line) {
+        StringBuilder builder = new StringBuilder();
+        builder.append(BLANK);
+
+        List<Point> points = line.getPoints();
+        for (int i = 0; i < points.size() - 1; i++) {
+            builder.append(VERTICAL);
+            builder.append(paintHorizontalIfConnected(points.get(i)));
+        }
+        builder.append(VERTICAL);
+        System.out.println(builder);
+    }
+
+    private static String paintHorizontalIfConnected(final Point point) {
+        if (point.right()) {
+            return HORIZONTAL;
+        }
+        return BLANK;
+    }
+}
diff --git a/src/test/java/.gitkeep b/src/test/java/.gitkeep
diff --git a/src/test/java/domain/LadderTest.java b/src/test/java/domain/LadderTest.java
@@ -0,0 +1,27 @@
+package domain;
+
+import static org.assertj.core.api.Assertions.assertThatThrownBy;
+
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+class LadderTest {
+
+    @Test
+    @DisplayName("반환된 리스트는 수정 불가능하다.")
+    void shouldReturnUnmodifiableList() {
+        // given
+        int width = 4;
+        int height = 4;
+
+        // when
+        Ladder ladder = Ladder.create(width, height, () -> false);
+
+        // then
+        assertThatThrownBy(() -> {
+            int modifiedWidth = 2;
+            ladder.getLines().add(Line.create(modifiedWidth, () -> true));
+        }).isInstanceOf(UnsupportedOperationException.class);
+    }
+
+}
diff --git a/src/test/java/domain/LineTest.java b/src/test/java/domain/LineTest.java
@@ -0,0 +1,45 @@
+package domain;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.assertj.core.api.Assertions.assertThatThrownBy;
+
+import java.util.List;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import strategy.FixedGenerator;
+import strategy.PointGenerator;
+
+class LineTest {
+
+    @Test
+    @DisplayName("주어진 넓이에 맞게 포인트를 생성한다.")
+    void shouldGeneratePoint_whenGivenWidth() {
+        // given
+        PointGenerator generator = new FixedGenerator(new boolean[]{true, false, true, false});
+        int width = 4;
+
+        // when
+        Line line = Line.create(width, generator);
+        List<Point> points = line.getPoints();
+
+        // then
+        assertThat(points)
+                .extracting(Point::right)
+                .containsExactly(true, false, true, false);
+    }
+
+    @Test
+    @DisplayName("반환된 리스트는 수정 불가능하다.")
+    void shouldReturnUnmodifiableList() {
+        // given
+        PointGenerator generator = new FixedGenerator(new boolean[]{false, false, false, false});
+        int width = 4;
+
+        Line line = Line.create(width, generator);
+        List<Point> points = line.getPoints();
+
+        // when & then
+        assertThatThrownBy(() -> points.add(Point.first(true)))
+                .isInstanceOf(UnsupportedOperationException.class);
+    }
+}
diff --git a/src/test/java/domain/PointTest.java b/src/test/java/domain/PointTest.java
@@ -0,0 +1,53 @@
+package domain;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+class PointTest {
+
+    @Test
+    @DisplayName("포인트 기준 오른쪽의 여부를 받아 객체를 정상적으로 생성한다.")
+    void shouldCreatePoint_whenFirstRightStatus() {
+        // given
+        boolean isRightTrue = true;
+        boolean isRightFalse = false;
+
+        // when
+        Point truePoint = Point.first(isRightTrue);
+        Point falsePoint = Point.first(isRightFalse);
+
+        // then
+        assertThat(truePoint.right()).isTrue();
+        assertThat(falsePoint.right()).isFalse();
+    }
+
+    @Test
+    @DisplayName("포인트는 가로로 연속되지 않는다.")
+    void shouldReturnNextPointFalse_whenPointRightTrue() {
+        // given
+        Point point = Point.first(true);
+
+        // when
+        Point next = point.connectNext(true);
+
+        // then
+        assertThat(next.right()).isFalse();
+    }
+
+    @Test
+    @DisplayName("현재 포인트가 연결되지 않은 경우, 다음 포인트는 입력에 따라 연결된다.")
+    void shouldReturnNextPointTrueOrFalse_whenPointRightFalse() {
+        // given
+        Point point = Point.first(false);
+
+        // when
+        Point nextTrue = point.connectNext(true);
+        Point nextFalse = point.connectNext(false);
+
+        // then
+        assertThat(nextTrue.right()).isTrue();
+        assertThat(nextFalse.right()).isFalse();
+    }
+}
diff --git a/src/test/java/strategy/FixedGenerator.java b/src/test/java/strategy/FixedGenerator.java
@@ -0,0 +1,16 @@
+package strategy;
+
+public class FixedGenerator implements PointGenerator {
+
+    private final boolean[] values;
+    private int index = 0;
+
+    public FixedGenerator(final boolean[] values) {
+        this.values = values;
+    }
+
+    @Override
+    public boolean generate() {
+        return values[index++];
+    }
+}
