📚 TIL 16일차

오늘의 주요사항 (6/7, 수요일)

1. 호텔 예약 프로젝트 시작
   • 객실 예약·취소 기능

이틀 전 메모장 프로젝트에서 컨트롤러 부분을 맡으면서, 개인적으로 찜찜했던 부분들이 많이 해소되었다. 그래서 이번엔 컨트롤러에 대한 미련을 던지고... 예약 부분을 맡았다!

이번에는 칠판에 다같이 모여서 이렇게 구조도도 같이 그려보았다. 그리고 나니 요구사항이 머리 속에서 더 잘 정리되었다 👍 기능에 따라 일을 분배해야하는데, 제시된 필수 요구사항만으로는 부족해서 '예약가능한 호텔 조회'라는 기능도 추가하기로 했다.

✋ 상황에 맞는 .gitignore 파일 생성

작업을 하다보면 개인 환경 설정 파일이나, 캐시 파일 등이 생성된다. 이걸 일일히 제외해주지 않으면 리포지토리에 커밋되어 충돌이 일어나는 경우가 종종 생기는데, 이런 상황을 .gitignore로 방지할 수 있다.

gitignore.io

위의 사이트에 상황에 맞는 키워드를 입력하면 그에 맞는 .gitignore 파일을 생성해준다. 우리 팀은 여기서 생성된 파일을 복사하여 사용하였다.

(알려주신 팀원 분 짱,,,~~👍)

객실 예약·취소 기능

🔧 정보는 Reservation이 갖고 있고요, 실행은 Reserve에서 합니다

Reservation 객체에서 백그라운드 작업을 실행하지 않고, Reserve 객체를 따로 만든 이유는 다음과 같다.

1. 공통으로 사용하는 클래스를 건드리면 충돌할 가능성이 있다.

   말 그대로 Reservation 클래스는 공통으로 사용해야할 정보를 담고 있기 때문에, 나 이외의 팀원이 건드릴 가능성이 크다. 이 클래스에 이어서 작업을 하게 되면, 충돌 문제 뿐만 아니라 정보를 관리하는데 혼선을 겪을 수 있다. 작업에 혼선이 생기거나, 파일을 머지할 때 충돌이 일어나는 걸 해결하는 것보다 실행 함수들을 따로 분리해서 작성하는 것이 훨씬 쉽기 때문에 이를 선택했다.

2. 컨트롤러 (역할을 하는 클래스)에서 예약 실행 메서드를 편하게 호출할 수 있도록 하기 위함이다.

   위에서도 언급했듯이 Reservation에서 계속 작업을 하다보면 정보 관리에 혼선이 생길 확률이 높아진다. 혼선이 생기면 최종적인 실행을 담당해야할 컨트롤러의 부담이 커질 뿐더러, 가독성도 좋지 않아지기 마련이다. 그래서 Reserve 객체가 필요한 행동들을 실행을 하게 하면, 컨트롤러는 Reserve가 갖고 있는 실행 함수들을 호출시키기만 하면 되는 형태가 되어서 수정이나 사용하기도 편하고 보기에도 좋을 것이라고 생각했다.

객실 예약 → uuid도 생성해서 반환하기

📁 Reserve.java

순서는 단순하게 UUID를 랜덤으로 생성한 다음, Reservation 객체를 만들고, 생성된 UUID와 Reservation 객체를 HashMap<K,V> reservedRoom에 추가한다. 이 때 생성된 UUID를 LinkedList<UUID> 형태의 컨테이너 변수를 만들어서 따로 한 번 더 저장해주었다. (아직 사용되진 않지만, 사용될 수도 있을 것 같아서 저장해두었다.)

// 예약 정보를 저장할 HashMap
private Map<UUID, Reservation> reservedRoom = new HashMap<>();

// 예약 키 값 (uuid)을 저장할 LinkedList
private LinkedList<UUID> reservedUUIDList = new LinkedList<>();

/*** 1. 예약 생성 -> 예약 번호 반환 ***/
public UUID createReservation(Room room, Customer customer){
    
    // UUID 랜덤으로 생성
    UUID uuid = UUID.randomUUID();
    
    // 예약 생성
    Reservation reservation = new Reservation(
            room, customer.getName(), customer.getPhoneNumber(),
            LocalDateTime.now(), uuid
    );
    
    // 생성한 예약을 추가
    reservedRoom.put(uuid, reservation);
    
    // list에 생성된 uuid 값 저장
    reservedUUIDList.add(uuid);
    
    // uuid 반환
    return uuid;
}

정보가 제대로 저장되었는지 확인해보기 위해 개별 예약 조회가 되는 메서드를 만들어서 테스트해주었다.

/*** 3-2. 개별 예약 조회 - 출력 형식 ***/
public void printMyReservation(UUID myUUID) {

    System.out.printf("[%s 님의 예약 정보]\n", getCustomerName(myUUID));
    System.out.printf("- 예약 번호: %s\n", myUUID.toString());        
    System.out.printf("- 예약 날짜: %s\n\n", getParseDateTime(myUUID));
    
    // System.out.printf("- 예약 날짜: %s\n\n", getParseDate(myUUID)); -> 날짜만 출력
    System.out.printf("- 예약자: %s 님\n", getCustomerName(myUUID));
    System.out.printf("- 예약자 전화번호: %s\n\n", getCustomerPhoneNumber(myUUID));
    
    System.out.printf("- 예약 객실 번호: %s\n", getRoom(myUUID).getRoomNumber());
    System.out.printf("- 예약 객실 크기: %s\n", getRoom(myUUID).getRoomSize());
    System.out.printf("- 예약 객실 가격: %s 원\n", getRoom(myUUID).getRoomPrice());
}

📁 Main.java (객체 생성 테스트)

예상 시나리오대로 출력되었는지 main() 함수를 통해 테스트 해보았다.

public static void main(String[] args) {

	// 예약 실행 객체 생성
    Reserve reserve = new Reserve();
    
    // 예약 후 uuid 반환하여 저장
    UUID uuid = reserve.createReservation(
		    new Room(101, RoomSize.Standard, 59000),
            new Customer("테스트 손님", "010-1234-5678", 12345678)
    );
          
	// 출력 함수
    reserve.printMyReservation(uuid);
}

▶ 출력 결과

[테스트 손님 님의 예약 정보]
- 예약 번호: 77d24cea-6cd7-4173-8ad4-c3fea4ccbd6b
- 예약 날짜: 2023-06-07 21:51:03

- 예약자: 테스트 손님 님
- 예약자 전화번호: 010-1234-5678

- 예약 객실 번호: 101
- 예약 객실 크기: Standard
- 예약 객실 가격: 59000 원

예상대로 잘 출력되었고, 오늘의 할 일은 이정도로 끝!인 것 같다. (아마)

그 외: enum RoomSize

RoomSize를 초반에 int형 같은 숫자 값으로 입력하려고 했는데, 보통의 호텔은 방 크기를 숫자로 표현하기 보다는, 트윈 룸, 스위트룸 같은 단위(?)를 보편적으로 사용한다. int형을 사용해도, 조건문을 통해 트윈 룸이라고 충분히 출력해줄 수는 있었지만, 코드의 가독성에는 썩 좋지 않은 방법이라고 판단했다. 그래서 String[]을 사용하는 방법과, enum 열거형을 사용하는 방법을 고안해냈고, enum 열거형을 사용해보기로 했다.

public enum RoomSize {
    Standard, Twin, Delux, Family, Suite,
}

출력도 위의 [▶ 출력 결과]처럼 별다른 변환없이 잘 출력되었다.