[SpringBoot] mallangLOG_Level1

📍 GitHub 바로가기

Project Intro

1️⃣ 서비스 요구사항

API 구분	기능
전체게시글 목록조회	- 제목, 작성자명, 작성내용, 작성날짜 조회 - 작성날짜 기준 내림차순 정렬
게시글 작성	- 제목, 작성자명, 비밀번호, 작성내용 저장 - 저장된게시글 Client 반환
선택한게시글 조회	- 선택한게시글 제목, 작성자명, 작성날짜, 작성내용 조회
선택한게시글 수정	- 수정요청 시, 수정할데이터 + 비밀번호 → 서버에서 비밀번호 유효성검사 - 제목, 작성자명, 작성내용 수정 - 수정된게시글 Client 반환
선택한게시글 삭제	- 삭제요청 시, 비밀번호 → 서버에서 비밀번호 유효성검사 - 선택한게시글 삭제 - 성공메시지 Client 반환

2️⃣ Service Architecture

3️⃣ Usecase

4️⃣ API 명세서

기능	Method	URL	Request	Response
게시글작성	POST	/post	{   "title" : "제목",   "username" : "작성자명",   "password" : "비밀번호",   "content" : "작성내용" }	{   "id" : "고유번호",   "title" : "제목",   "username" : "작성자명",   "content" : "작성내용",   "createdAt" : "생성시간",   "modifiedAt" : "수정시간" }
전체게시글목록조회	GET	/posts	-	[ {   "id" : "고유번호",   "title" : "제목",   "username" : "작성자명",   "content" : "작성내용",   "createdAt" : "생성시간",   "modifiedAt" : "수정시간" }, {   "id" : "고유번호",   "title" : "제목",   "username" : "작성자명",   "content" : "작성내용",   "createdAt" : "생성시간",   "modifiedAt" : "수정시간" } ]
선택한게시글조회	GET	/post/{post-id}	-	{   "id" : "고유번호",   "title" : "제목",   "username" : "작성자명",   "content" : "작성내용",   "createdAt" : "생성시간",   "modifiedAt" : "수정시간" }
선택한게시글수정	PUT	/post/{post-id}	{   "title" : "제목",   "username" : "작성자명",   "password" : "비밀번호",   "content" : "작성내용" }	{   "id" : "고유번호",   "title" : "제목",   "username" : "작성자명",   "content" : "작성내용",   "createdAt" : "생성시간",   "modifiedAt" : "수정시간" }
선택한게시글삭제	DELETE	/post/{post-id}	{   "password" : "비밀번호" }	{   "status" : 200,   "message" : "Deleted Post Successfully" } {   "status" : ["The Post does not exist.", "Password is incorrect"] }

---

1 Project Setting

---

2 Entity 설계

1️⃣ Timestamped.java

@MappedSuperclass // 조상클래스 (but, Table설계 X)
@Getter
@EntityListeners(AuditingEntityListener.class) // 해당 Entity 변화감지 -> 테이블데이터조작
public class Timestamped {
    
    // 생성시간
    @CreatedDate
    private LocalDateTime createdAt;
    
    // 수정시간
    @LastModifiedDate
    private LocalDateTime modifiedAt;
    
}

• MallangLogApplication → @EnableJpaAuditing 추가필수

2️⃣ Post.java

@Entity
@Getter
@NoArgsConstructor // 파라미터없는 기본생성자
public class Post extends Timestamped {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false)
    private String title;

    @Column(nullable = false)
    private String username;

    @Column(nullable = false)
    private String password;

    @Column(nullable = false)
    private String content;

}

---

3 Dto 설계

1️⃣ PostRequestDto.java

// Client 요청으로 들어오는 정보를 담는 Dto
@Getter
public class PostRequestDto {

    private String title;

    private String username;

    private String password;

    private String content;

}

2️⃣ Post.java → 생성자(정적팩토리메서드)

// Client Request 값 -> Dto에서 받아와서 -> 덮어씌움
    @Builder // 빌더패턴 : 생성자를 통해 값을 받음 (-> 정적팩토리메서드)
    private Post(String title, String username, String password, String content) {
        this.title = title;
        this.username = username;
        this.password = password;
        this.content = content;
    }

    // 정적팩토리메서드
    public static Post of(PostRequestDto postRequestDto) {
        return Post.builder()
                .title(postRequestDto.getTitle())
                .username(postRequestDto.getUsername())
                .password(postRequestDto.getPassword())
                .content(postRequestDto.getContent())
                .build();
    }

3️⃣ PostResponseDto.java

// Post Entity 값(모든변경이 끝남) getter -> Dto 덮어씌운 후 -> Client에 반환
@Getter
public class PostResponseDto {

    private Long id;

    private String title;

    private String username;

    private String content;

    private LocalDateTime createdAt;

    private LocalDateTime modifiedAt;

}

4️⃣ PostResponseDto.java → 생성자(정적팩토리메서드)

// 생성자
    @Builder
    private PostResponseDto(Long id,
                            String title, String username, String content,
                            LocalDateTime createdAt, LocalDateTime modifiedAt) {
        this.id = id;
        this.title = title;
        this.username = username;
        this.content = content;
        this.createdAt = createdAt;
        this.modifiedAt = modifiedAt;
    }

    // 정적팩토리메서드
    public static PostResponseDto of(Post post) {
        return PostResponseDto.builder()
                .id(post.getId())
                .title(post.getTitle())
                .username(post.getUsername())
                .content(post.getContent())
                .createdAt(post.getCreatedAt())
                .modifiedAt(post.getModifiedAt())
                .build();
    }

---

4 Post생성 설계

1️⃣ PostController.java

@RestController // @Controller + @ResponseBody -> JSON형태 데이터반환
@RequiredArgsConstructor // final, @Notnull 필드 -> 생성자생성
public class PostController {

    private final PostService postService;

    // Post 생성
    @PostMapping("/post")
    public PostResponseDto createPost(@RequestBody PostRequestDto postRequestDto) {
        return postService.createPost(postRequestDto);
    }
        // 느슨한결합 : Entity 바로 반환 X, Dto에 담아 반환 !
        // @RequestBody : Client 입력값 -> HTTP Body에 JSON형태로 지정객체에 담아옴

}

2️⃣ PostService.java

@Service
@RequiredArgsConstructor // final, @Notnull 필드 -> 생성자생성
public class PostService {

    private final PostRepository postRepository;

    // Post 생성
    @Transactional // DB처리 작업 중 오류 -> 모든작업 원상태로 복구
    public PostResponseDto createPost(PostRequestDto postRequestDto) {

        // Entity 객체 생성 -> 정적팩토리메서드(생성자) 초기화
        Post post = Post.of(postRequestDto);

        // 초기화 된 Entity 객체 -> Repository 저장
        postRepository.save(post);

        // 초기화 된 Entity 객체 -> ResponseDto 생성자에 전달
        return PostResponseDto.of(post);

    }

}

3️⃣ Postman 확인

📍 application.properties H2설정

spring.h2.console.enabled=true
spring.datasource.url=jdbc:h2:mem:db;MODE=MYSQL;
spring.datasource.username=mallang
spring.datasource.password=

---

5 Post전체조회 설계

1️⃣ PostController.java

<// Post 전체조회
@GetMapping("/posts")
public List<PostResponseDto> getPosts() {
    return postService.getPosts();
}

2️⃣ PostService.java

// Post 전체조회
@Transactional(readOnly = true)
public List<PostResponseDto> getPosts() {

    // Repository -> Entity 객체배열
    List<Post> postList = postRepository.findAllByOrderByModifiedAtDesc();

    // ResponseDto 배열 생성
    List<PostResponseDto> postResponseDtoList = new ArrayList<>();

    // postList -> postResponseDtoList (List -> List로 바로 못 옮김)
    for (Post post : postList) {
       	postResponseDtoList.add(PostResponseDto.of(post));
    }

   return postResponseDtoList;

}

3️⃣ PostRepository.java

// Post 전체조회 (작성시간기준 내림차순)
    List<Post> findAllByOrderByModifiedAtDesc(); // 반환타입 + 조건

4️⃣ Postman 확인

---

6 Post선택조회 설계

1️⃣ PostController.java

// Post 선택조회
@GetMapping("/post/{id}")
public PostResponseDto getSelectedPost(@PathVariable Long id) {
    return postService.getSelectedPost(id);
}

2️⃣ PoserService.java

// Post 선택조회
@Transactional(readOnly = true)
public PostResponseDto getSelectedPost(Long id) {

    // Repository -> Entity 객체 담아옴 -> 예외처리
    Post selectedPost = postRepository.findById(id).orElseThrow(
            // IllegalStateException : 적절하지못한 인자를 메서드로 넘겨주었을 때 예외
            () -> new IllegalStateException("The Post does not exist.")
    );

    // Entity 객체에 담아온 것 -> ResponseDto 생성자 초기화 -> Client 반환
    return PostResponseDto.of(selectedPost);

}

3️⃣ Postman 확인

Id가 존재할 때

Id가 존재하지 않을 때 예외처리

---

7 Post수정 설계

1️⃣ PostController.java

// Post 수정
@PutMapping("/post/{id}")
public PostResponseDto updatePost(@PathVariable Long id,
                                  @RequestBody PostRequestDto postRequestDto) {
    return postService.updatePost(id, postRequestDto);
}

2️⃣ PostService.java

// Post 수정
@Transactional
public PostResponseDto updatePost(Long id, PostRequestDto postRequestDto) {

    // Entity 객체 생성 -> Repository에서 id로 불러옴 -> 예외처리
    Post updatePost = postRepository.findById(id).orElseThrow(
            () -> new IllegalStateException("The Post does not exist.")
    );

    // 비밀번호 유효성검사
    if (! postRequestDto.getPassword().equals(updatePost.getPassword())) {
        throw new IllegalStateException("Password is incorrect");
    }

    // RequestDto -> 불러온 Entity에 덮어씌움
    updatePost.update(postRequestDto);

    // 수정이 끝난 불러온 Entity 객체 -> ResponseDto 생성자 초기화 -> Client 반환
    return PostResponseDto.of(updatePost);

}

3️⃣ Post.java

// Post 수정 (Service -> RequestDto -> update 메서드)
public void update(PostRequestDto postRequestDto) {
    this.title = postRequestDto.getTitle();
    this.content = postRequestDto.getContent();
}

4️⃣ Postman 확인

Post 수정

예외처리1 - Id가 존재하지 않을 때

예외처리2 - 비밀번호 유효성검사

---

8 Post삭제 설계

1️⃣ PostController.java

// Post 삭제
@DeleteMapping("/post/{post-id}")
public Map<Integer, String> deletePost(@PathVariable(name="post-id") Long postId,
                                      @RequestBody PostRequestDto postRequestDto) {
    return postService.deletePost(postId, postRequestDto);
}

2️⃣ PostService.java

// Post 삭제
@Transactional
public Map<Integer, String> deletePost(Long postId, PostRequestDto postRequestDto) {

    // HashMap<key : value> -> 비밀번호 유효성 검사 후, 상태메시지 반환
    Map<Integer, String> statusMessage = new HashMap<>();

    // Entity 객체 생성 -> Repository에서 id로 불러옴 -> 예외처리
    Post deletePost = postRepository.findById(postId).orElseThrow(
            () -> new IllegalStateException("The Post does not exist")
        );

    // 비밀번호 유효성검사 -> 상태메시지 반환
    if (postRequestDto.getPassword().equals(deletePost.getPassword())) {
        postRepository.deleteById(postId);
        statusMessage.put(200, "Deleted Post Successfully");
        return statusMessage;
    } else {
        statusMessage.put(500, "Password is incorrect");
        return statusMessage;
    }

}

3️⃣ Postman 확인

Post삭제 성공메시지 반환

Post삭제 실패메시지 반환 (비밀번호불일치)