[🚀 사이클1 - 미션 (보드 초기화 + 기물 이동)] 이프 미션 제출합니다.

README.md

@@ -1,3 +1,186 @@
-# java-janggi
+# 1단계 - 보드 초기화
 
-장기 미션 저장소
+```
+한나라의 상차림을 선택해주세요.
+1. 상마상마
+2. 마상마상
+3. 마상상마
+4. 상마마상
+
+3
+
+초나라의 상차림을 선택해주세요.
+1. 상마상마
+2. 마상마상
+3. 마상상마
+4. 상마마상
+
+5
+[ERROR] 유효하지 않은 상차림 번호입니다.
+
+3
+
+　　　０　１　２　３　４　５　６　７　８
+　＋－－－－－－－－－－－－－－－－－－－＋
+０｜　車　馬　象　士　＊　士　象　馬　車　｜
+１｜　＊　＊　＊　＊　漢　＊　＊　＊　＊　｜
+２｜　＊　包　＊　＊　＊　＊　＊　包　＊　｜
+３｜　兵　＊　兵　＊　兵　＊　兵　＊　兵　｜
+４｜　＊　＊　＊　＊　＊　＊　＊　＊　＊　｜
+５｜　＊　＊　＊　＊　＊　＊　＊　＊　＊　｜
+６｜　卒　＊　卒　＊　卒　＊　卒　＊　卒　｜
+７｜　＊　包　＊　＊　＊　＊　＊　包　＊　｜
+８｜　＊　＊　＊　＊　楚　＊　＊　＊　＊　｜
+９｜　車　馬　象　士　＊　士　象　馬　車　｜
+　＋－－－－－－－－－－－－－－－－－－－＋
+```
+
+## 기능 정리
+
+- 상차림 순서 관리
+    - 한나라부터 상차림 입력을 받는다.
+    - 다음으로 초나라 상차림 입력을 받는다.
+    - 잘못된 입력시 예외
+- 상차림 별 상태 관리
+    - 상마상마
+    - 마상마상
+    - 마상상마
+    - 상마마상
+- 초기 배치를 위한 보드 정보
+    - 위치
+    - 격자 범위
+    - 배치될 장기말
+- 장기말 정보
+    - 차, 마, 상, 사, 졸(병), 포, 장
+    - 자신의 나라 정보
+- 나라 정보
+    - 한, 초
+
+## 구현 순서
+
+* 초나라/한나라 상차림 입력
+    * 나라 별 유효한 상차림을 입력받는다.
+* 상차림에 따른 장기판 초기 배치
+    * 장기판에 위치할 장기말이 필요하다.
+        * 차, 상, 마, 포, 졸, 사, 장
+        * 이름
+          정보: [나무위키](https://namu.wiki/w/%EC%9E%A5%EA%B8%B0/%EA%B8%B0%EB%AC%BC%20%EB%B0%8F%20%ED%96%89%EB%A7%88%EB%B2%95)
+          참조
+    * 장기말이 위치할 위치 정보가 필요하다.
+        * 장기판 위치 범위를 초과하면 예외가 발생해야한다.
+    * 장기판이 필요하다.
+
+# 2단계 - 기물 이동
+
+- 2단계에서는 기물 이동 구현이 목적이니까 종료는 `Ctrl+C`로 강제 종료한다.
+
+## 잘못된 기물 선택 시나리오
+
+1. 다른 나라의 기물을 선택했을 때
+    1. 예외: 다른나라의 기물 선택
+    2. `[ERROR] 다른 나라의 기물을 선택할 수 없습니다.`
+2. 기물이 없는 곳을 선택했다. (빈칸 or 장기판 외부)
+    1. 예외: 기물이 없는 곳을 선택
+    2. `[ERROR] 현재 위치에 존재하는 기물이 없습니다.`
+
+## 기물 이동 규칙
+
+- 궁성 영역 - 고려하지 않는다. (사이클 2)
+- 기물 이동 규칙 공통
+    - 현재 위치로 이동할 수 없다.
+    - 보드 영역 밖으로 이동할 수 없다.
+    - 목적지에 아군이 있으면 이동할 수 없다.
+    - 목적지에 적군이 있으면 잡아낸다.
+
+- `차`: 4방위로 이동한다.
+    - 목적지까지의 경로에 기물이 있으면 이동할 수 없다.
+- `포`: 4방위로 이동한다.
+    - 무조건 목적지까지의 경로에 포를 제외한 기물이 하나만 존재해야 한다.
+- `마`: 4방위 중 한 방향으로 한 칸 이동하고 대각선의 한 방향으로 1칸 이동해야 한다.
+    - 목적지까지의 경로에 기물이 있으면 이동할 수 없다.
+- `상`: 4방위 중 한 방향으로 한 칸 이동하고 대각선의 한 방향으로 2칸 이동해야 한다.
+    - 목적지까지의 경로에 기물이 있으면 이동할 수 없다.
+- `졸`: 직진과 좌, 우로만 한 칸 이동해야 한다.
+    - 한 칸이라서 경로에 기물이 있을 리가 없다.
+- `사, 장`: 궁성 영역이므로 구현하지 않는다.
+
+## 입출력 예시
+
+```
+1단계 ...
+
+　　　０　１　２　３　４　５　６　７　８
+　＋－－－－－－－－－－－－－－－－－－－＋
+０｜　車　馬　象　士　＊　士　象　馬　車　｜
+１｜　＊　＊　＊　＊　漢　＊　＊　＊　＊　｜
+２｜　＊　包　＊　＊　＊　＊　＊　包　＊　｜
+３｜　兵　＊　兵　＊　兵　＊　兵　＊　兵　｜
+４｜　＊　＊　＊　＊　＊　＊　＊　＊　＊　｜
+５｜　＊　＊　＊　＊　＊　＊　＊　＊　＊　｜
+６｜　卒　＊　卒　＊　卒　＊　卒　＊　卒　｜
+７｜　＊　包　＊　＊　＊　＊　＊　包　＊　｜
+８｜　＊　＊　＊　＊　楚　＊　＊　＊　＊　｜
+９｜　車　馬　象　士　＊　士　象　馬　車　｜
+　＋－－－－－－－－－－－－－－－－－－－＋
+
+[초나라] 이동할 기물을 선택해주세요. (쉼표 기준으로 분리)
+기물: 6,8
+
+[초나라] 기물 卒의 다음 위치를 선택해주세요. (쉼표 기준으로 분리)
+위치: 6,7
+
+
+　　　０　１　２　３　４　５　６　７　８
+　＋－－－－－－－－－－－－－－－－－－－＋
+０｜　車　馬　象　士　＊　士　象　馬　車　｜
+１｜　＊　＊　＊　＊　漢　＊　＊　＊　＊　｜
+２｜　＊　包　＊　＊　＊　＊　＊　包　＊　｜
+３｜　兵　＊　兵　＊　兵　＊　兵　＊　兵　｜
+４｜　＊　＊　＊　＊　＊　＊　＊　＊　＊　｜
+５｜　＊　＊　＊　＊　＊　＊　＊　＊　＊　｜
+６｜　卒　＊　卒　＊　卒　＊　卒　卒　＊　｜
+７｜　＊　包　＊　＊　＊　＊　＊　包　＊　｜
+８｜　＊　＊　＊　＊　楚　＊　＊　＊　＊　｜
+９｜　車　馬　象　士　＊　士　象　馬　車　｜
+　＋－－－－－－－－－－－－－－－－－－－＋
+
+[한나라] 이동할 기물을 선택해주세요. (쉼표 기준으로 분리)
+기물: 3,1
+
+[ERROR] 현재 위치에 존재하는 기물이 없습니다.
+
+
+[한나라] 이동할 기물을 선택해주세요. (쉼표 기준으로 분리)
+기물: 3,0
+
+
+[한나라] 기물 兵의 다음 위치를 선택해주세요. (쉼표 기준으로 분리)
+위치: 3,1
+
+　　　０　１　２　３　４　５　６　７　８
+　＋－－－－－－－－－－－－－－－－－－－＋
+０｜　車　馬　象　士　＊　士　象　馬　車　｜
+１｜　＊　＊　＊　＊　漢　＊　＊　＊　＊　｜
+２｜　＊　包　＊　＊　＊　＊　＊　包　＊　｜
+３｜　＊　兵　兵　＊　兵　＊　兵　＊　兵　｜
+４｜　＊　＊　＊　＊　＊　＊　＊　＊　＊　｜
+５｜　＊　＊　＊　＊　＊　＊　＊　＊　＊　｜
+６｜　卒　＊　卒　＊　卒　＊　卒　卒　＊　｜
+７｜　＊　包　＊　＊　＊　＊　＊　包　＊　｜
+８｜　＊　＊　＊　＊　楚　＊　＊　＊　＊　｜
+９｜　車　馬　象　士　＊　士　象　馬　車　｜
+　＋－－－－－－－－－－－－－－－－－－－＋
+```
+
+## 구현 순서
+
+1. 기물 이동 기능 추가
+    * 나라 별 입력
+        * 이동할 기물의 위치를 입력 받는다.
+            * 해당 위치에 기물이 존재하지 않다면 예외가 발생한다.
+            * 해당 위치의 기물이 다른 팀이라면 예외가 발생한다.
+            * 잘못된 범위라면 예외를 발생한다. (보드 범위 벗어남)
+        * 기물의 이동할 위치를 입력 받는다.
+            * 잘못된 범위라면 예외를 발생한다.
+            * 해당 위치에 아군의 기물이 존재한다면 예외가 발생한다.
+        * 기물 별로 이동할 수 없는 목적지라면 예외가 발생한다.

src/main/java/Application.java

@@ -0,0 +1,10 @@
+import controller.JanggiController;
+import view.InputView;
+import view.OutputView;
+
+public class Application {
+    public static void main(String[] args) {
+        JanggiController janggiController = new JanggiController(new InputView(), new OutputView());
+        janggiController.run();
+    }
+}

src/main/java/controller/JanggiController.java

@@ -0,0 +1,61 @@
+package controller;
+
+import static controller.Retrier.retry;
+import static model.Team.CHO;
+import static model.Team.HAN;
+
+import java.util.function.Consumer;
+import model.JanggiGame;
+import model.Team;
+import model.board.Board;
+import model.board.BoardFactory;
+import model.board.JanggiFormation;
+import model.board.Position;
+import model.piece.Piece;
+import view.InputView;
+import view.OutputView;
+
+public class JanggiController {
+    private final InputView inputView;
+    private final OutputView outputView;
+
+    public JanggiController(InputView inputView, OutputView outputView) {
+        this.inputView = inputView;
+        this.outputView = outputView;
+    }
+
+    public void run() {
+        Board board = createBoardByFormation();
+        outputView.displayBoard(board.board());
+
+        JanggiGame janggiGame = new JanggiGame(board);
+        while (true) {
+            retry(() -> playByTurn(janggiGame), processError());
+            outputView.displayBoard(board.board());
+        }
+    }
+
+    private Board createBoardByFormation() {
+        JanggiFormation hanFormation = retry(() -> inputView.readFormationByTeam(HAN), processError());
+        JanggiFormation choFormation = retry(() -> inputView.readFormationByTeam(CHO), processError());
+
+        Board board = BoardFactory.generateDefaultPieces();
+        board.arrangePieces(hanFormation.generateByTeam(HAN));
+        board.arrangePieces(choFormation.generateByTeam(CHO));
+        return board;
+    }
+
+    private void playByTurn(JanggiGame janggiGame) {
+        Team currentTurn = janggiGame.getTurn();
+
+        Position current = inputView.readPiecePositionForMove(currentTurn);
+        Piece piece = janggiGame.selectPiece(current);
+
+        Position next = inputView.readPiecePositionForArrange(currentTurn, piece);
+        janggiGame.movePiece(current, next);
+    }
+
+    private Consumer<IllegalArgumentException> processError() {
+        return (e) -> outputView.displayError(e.getMessage());
+    }
+}

src/main/java/controller/Retrier.java

@@ -0,0 +1,31 @@
+package controller;
+
+import java.util.function.Consumer;
+import java.util.function.Supplier;
+
+public final class Retrier {
+    private Retrier() {
+    }
+
+    public static <T> T retry(Supplier<T> task, Consumer<IllegalArgumentException> consumer) {
+        while (true) {
+            try {
+                return task.get();
+            } catch (IllegalArgumentException e) {
+                consumer.accept(e);
+            }
+        }
+    }
+
+
+    public static void retry(Runnable task, Consumer<IllegalArgumentException> consumer) {
+        while (true) {
+            try {
+                task.run();
+                return;
+            } catch (IllegalArgumentException e) {
+                consumer.accept(e);
+            }
+        }
+    }
+}

src/main/java/model/JanggiGame.java

@@ -0,0 +1,39 @@
+package model;
+
+import java.util.List;
+import model.board.Board;
+import model.board.Position;
+import model.piece.Piece;
+
+public class JanggiGame {
+
+    private final Board board;
+    private Team turn;
+
+    public JanggiGame(Board board) {
+        this.board = board;
+        this.turn = Team.CHO;
+    }
+
+    public void movePiece(Position current, Position next) {
+        Piece piece = selectPiece(current);
+
+        List<Position> path = piece.extractPath(current, next);
+        List<Piece> pieces = board.extractPiecesByPath(path);
+
+        piece.validatePathCondition(pieces);
+        board.move(current, next);
+
+        this.turn = turn.next();
+    }
+
+    public Piece selectPiece(Position position) {
+        Piece piece = board.pickPiece(position);
+        turn.validateAlly(piece);
+        return piece;
+    }
+
+    public Team getTurn() {
+        return turn;
+    }
+}

src/main/java/model/Team.java

@@ -0,0 +1,34 @@
+package model;
+
+import model.piece.Piece;
+
+public enum Team {
+    HAN("한나라"), CHO("초나라");
+
+    private final String name;
+
+    Team(String name) {
+        this.name = name;
+    }
+
+    public void validateAlly(Piece piece) {
+        if (piece.isOtherTeam(this)) {
+            throw new IllegalArgumentException(this.name + "의 기물이 아닙니다.");
+        }
+    }
+
+    public boolean isHan() {
+        return this == HAN;
+    }
+
+    public Team next() {
+        if (isHan()) {
+            return CHO;
+        }
+        return HAN;
+    }
+
+    public String getName() {
+        return name;
+    }
+}