[황민재] Sprint3

[rorm0819]

요구사항

기본 요구사항

프로젝트 초기화

• IntelliJ를 통해 다음의 조건으로 Java 프로젝트를 생성합니다.
  • IntelliJ에서 제공하는 프로젝트 템플릿 중 Java를 선택합니다.
  • 프로젝트의 경로는 스프린트 미션 리포지토리의 경로와 같게 설정합니다.
    • 예를 들어 스프린트 미션 리포지토리의 경로가
      /some/path/1-sprint-mission 이라면:
      • Name: 1-sprint-mission
      • Location: /some/path
        로 설정합니다.
  • Create Git Repository 옵션은 체크하지 않습니다.
  • Build system은 Gradle을 사용합니다. Gradle DSL은 Groovy를 사용합니다.
  • JDK 17을 선택합니다.
  • GroupId는 com.sprint.mission으로 설정합니다.
  • ArtifactId는 수정하지 않습니다.
• .gitignore에 IntelliJ와 관련된 파일이 형상관리 되지 않도록 .idea 디렉토리를 추가합니다.

...
.idea
...

도메인 모델

• 디스코드 서비스를 활용해보면서 각 도메인 모델에 필요한 정보를 도출하고, Java Class로 구현하세요.
  • 패키지명: com.sprint.mission.discodeit.entity
  • 도메인 모델 정의
    • 공통
      • id: 객체를 식별하기 위한 id로 UUID 타입으로 선언합니다.
      • createdAt, updatedAt: 각각 객체의 생성, 수정 시간을 유닉스 타임스탬프로 나타내기 위한 필드로 Long 타입으로 선언합니다.
    • User
    • Channel
    • Message
  • 생성자
    • id는 생성자에서 초기화하세요.
    • createdAt는 생성자에서 초기화하세요.
    • id, createdAt, updatedAt을 제외한 필드는 생성자의 파라미터를 통해 초기화하세요.
  • 메소드
    • 각 필드를 반환하는 Getter 함수를 정의하세요.
    • 필드를 수정하는 update 함수를 정의하세요.

서비스 설계 및 구현

• 도메인 모델 별 CRUD(생성, 읽기, 모두 읽기, 수정, 삭제) 기능을 인터페이스로 선언하세요.
  • 인터페이스 패키지명: com.sprint.mission.discodeit.service
  • 인터페이스 네이밍 규칙: [도메인 모델 이름]Service
• 다음의 조건을 만족하는 서비스 인터페이스의 구현체를 작성하세요.
  • 클래스 패키지명: com.sprint.mission.discodeit.service.jcf
  • 클래스 네이밍 규칙: JCF[인터페이스 이름]
  • Java Collections Framework를 활용하여 데이터를 저장할 수 있는 필드(data)를 final로 선언하고 생성자에서 초기화하세요.
  • data 필드를 활용해 생성, 조회, 수정, 삭제하는 메소드를 구현하세요.

메인 클래스 구현

• 메인 메소드가 선언된 JavaApplication 클래스를 선언하고, 도메인 별 서비스 구현체를 테스트해보세요.
  • 등록
  • 조회(단건, 다건)
  • 수정
  • 수정된 데이터 조회
  • 삭제
  • 조회를 통해 삭제되었는지 확인

심화 요구 사항

서비스 간 의존성 주입

• 도메인 모델 간 관계를 고려해서 검증하는 로직을 추가하고, 테스트해보세요.
  • 힌트: Message를 생성할 때 연관된 도메인 모델 데이터 확인하기

스크린샷

---

요구사항

기본 요구사항

File IO를 통한 데이터 영속화

• 다음의 조건을 만족하는 서비스 인터페이스의 구현체를 작성하세요.
  • 클래스 패키지명: com.sprint.mission.discodeit.service.file
  • 클래스 네이밍 규칙: File[인터페이스 이름]
  • JCF 대신 FileIO와 객체 직렬화를 활용해 메소드를 구현하세요.
    객체 직렬화/역직렬화 가이드
• Application에서 서비스 구현체를 File*Service로 바꾸어 테스트해보세요.

서비스 구현체 분석

• JCF*Service 구현체와 File*Service 구현체를 비교하여 공통점과 차이점을 발견해보세요.
  • "비즈니스 로직"과 관련된 코드를 식별해보세요.
  • "저장 로직"과 관련된 코드를 식별해보세요.

레포지토리 설계 및 구현

• "저장 로직"과 관련된 기능을 도메인 모델 별 인터페이스로 선언하세요.
  • 인터페이스 패키지명: com.sprint.mission.discodeit.repository
  • 인터페이스 네이밍 규칙: [도메인 모델 이름]Repository
• 다음의 조건을 만족하는 레포지토리 인터페이스의 구현체를 작성하세요.
  • 클래스 패키지명: com.sprint.mission.discodeit.repository.jcf
  • 클래스 네이밍 규칙: JCF[인터페이스 이름]
  • 기존에 구현한 JCF*Service 구현체의 "저장 로직"과 관련된 코드를 참고하여 구현하세요.
• 다음의 조건을 만족하는 레포지토리 인터페이스의 구현체를 작성하세요.
  • 클래스 패키지명: com.sprint.mission.discodeit.repository.file
  • 클래스 네이밍 규칙: File[인터페이스 이름]
  • 기존에 구현한 File*Service 구현체의 "저장 로직"과 관련된 코드를 참고하여 구현하세요.

심화 요구 사항

관심사 분리를 통한 레이어 간 의존성 주입

• 다음의 조건을 만족하는 서비스 인터페이스의 구현체를 작성하세요.

  • 클래스 패키지명: com.sprint.mission.discodeit.service.basic
  • 클래스 네이밍 규칙: Basic[인터페이스 이름]
  • 기존에 구현한 서비스 구현체의 "비즈니스 로직"과 관련된 코드를 참고하여 구현하세요.
  • 필요한 Repository 인터페이스를 필드로 선언하고 생성자를 통해 초기화하세요.
  • "저장 로직"은 Repository 인터페이스 필드를 활용하세요. (직접 구현하지 마세요.)

• Basic*Service 구현체를 활용하여 테스트해보세요.

  • 코드 템플릿

public class JavaApplication {
    static User setupUser(UserService userService) {
        User user = userService.create("woody", "woody@codeit.com", "woody1234");
        return user;
    }

    static Channel setupChannel(ChannelService channelService) {
        Channel channel = channelService.create(ChannelType.PUBLIC, "공지", "공지 채널입니다.");
        return channel;
    }

    static void messageCreateTest(MessageService messageService, Channel channel, User author) {
        Message message = messageService.create("안녕하세요.", channel.getId(), author.getId());
        System.out.println("메시지 생성: " + message.getId());
    }

    public static void main(String[] args) {
        // 서비스 초기화
        // TODO Basic*Service 구현체를 초기화하세요.
        UserService userService;
        ChannelService channelService;
        MessageService messageService;

        // 셋업
        User user = setupUser(userService);
        Channel channel = setupChannel(channelService);
        // 테스트
        messageCreateTest(messageService, channel, user);
    }
}

• JCF*Repository 구현체를 활용하여 테스트해보세요.
• File*Repository 구현체를 활용하여 테스트해보세요.
• 이전에 작성했던 코드(JCF*Service 또는 File*Service)와 비교해 어떤 차이가 있는지 정리해보세요.

---

기본 요구사항

Spring 프로젝트 초기화

• Spring Initializr를 통해 zip 파일을 다운로드하세요.
  • 빌드 시스템은 Gradle - Groovy를 사용합니다.
  • 언어는 Java 17를 사용합니다.
  • Spring Boot의 버전은 3.4.0입니다.
  • GroupId는 com.sprint.mission입니다.
  • ArtifactId와 Name은 discodeit입니다.
  • packaging 형식은 Jar입니다
  • Dependency를 추가합니다.
    • Lombok
    • Spring Web
  • zip 파일을 압축해제하고 원래 진행 중이던 프로젝트에 붙여넣기하세요. 일부 파일은 덮어쓰기할 수 있습니다.
  • application.properties 파일을 yaml 형식으로 변경하세요.
  • DiscodeitApplication의 main 메서드를 실행하고 로그를 확인해보세요.

Bean 선언 및 테스트

• File*Repository 구현체를 Repository 인터페이스의 Bean으로 등록하세요.
• Basic*Service 구현체를 Service 인터페이스의 Bean으로 등록하세요.
• JavaApplication에서 테스트했던 코드를 DiscodeitApplication에서 테스트해보세요.
  • JavaApplication 의 main 메소드를 제외한 모든 메소드를 DiscodeitApplication클래스로 복사하세요.
  • JavaApplication의 main 메소드에서 Service를 초기화하는 코드를 Spring Context를 활용하여 대체하세요.

// JavaApplication
public static void main(String[] args) {
    // 레포지토리 초기화
    // ...
    // 서비스 초기화
      UserService userService = new BasicUserService(userRepository);
    ChannelService channelService = new BasicChannelService(channelRepository);
    MessageService messageService = new BasicMessageService(messageRepository, channelRepository, userRepository);

    // ...
}

// DiscodeitApplication
public static void main(String[] args) {
        ConfigurableApplicationContext context = SpringApplication.run(DiscodeitApplication.class, args);
    // 서비스 초기화
        // TODO context에서 Bean을 조회하여 각 서비스 구현체 할당 코드 작성하세요.
      UserService userService;
    ChannelService channelService;
    MessageService messageService;

    // ...
}

• JavaApplication의 main 메소드의 셋업, 테스트 부분의 코드를 DiscodeitApplication클래스로 복사하세요.

public static void main(String[] args) {
    // ...
    // 셋업
    User user = setupUser(userService);
    Channel channel = setupChannel(channelService);
    // 테스트
    messageCreateTest(messageService, channel, user);
}

Spring 핵심 개념 이해하기

• JavaApplication과 DiscodeitApplication에서 Service를 초기화하는 방식의 차이에 대해 다음의 키워드를 중심으로 정리해보세요.
  • IoC Container
  • Dependency Injection
  • Bean

JavaApplication의 경우
IoC Container가 없다.
Service를 생성, 초기화 하는 건 개발자가 한다.
의존성은 개발자가 직접 주입한다.
개발자가 생성자 호출 시에 필요한 객체를 바로 입력해 전달한다.
JavaApplication은 Bean이 없다. Bean은 스프링에서 사용하는 객체를 일컫는 개념

DiscodeitApplication의 경우
Spring IoC Container가 존재한다.
Service의 생성, 초기화, 의존성 주입, 소멸까지 컨테이너가 관리한다.
생성자 주입, 필드 주입 등의 기능으로 Spring이 의존성 주입을 자동으로 수행한다.
@Service 어노테이션으로 Service를 Bean으로 등록한다.
이후 IoC Container가 Bean을 생성하고 의존성 주입을 처리해준다.

Lombok 적용

• 도메인 모델의 getter 메소드를 @Getter로 대체해보세요.
• Basic*Service의 생성자를 @RequiredArgsConstructor로 대체해보세요.

비즈니스 로직 고도화

• 다음의 기능 요구 사항을 구현하세요.
  추가 기능 요구 사항