[BE] feat: 발자국 - image URL 필드 추가, 쿨타임 검증 추가, 마지막 발자국 조회 기능 구현 #122

takoyakimchi · 2024-07-18T12:08:06Z

이슈

발자국 - 기능 추가 #84

개발 사항

발자국은 30초마다 찍을 수 있다.
발자국에 image url 필드 추가(일단은 이미지가 1장이라고 생각하고 구현)
자신이 마지막으로 발자국 찍은 시간 조회 API 구현
- 안드로이드에서 오른쪽 아래 시간초(쿨타임)를 렌더링할 때 필요해요.

전달 사항

앨범 기능이 확정되고 나서 기능을 더 붙여야 할 것 같아요.
발자국에 이미지가 몇 장까지 가능한지 회의로 정해 보아요.
AWS S3 연동 관련 코드가 완성되고 나면 이미지 업로드 관련 작업할게요.
아직 다른 기능이 완성되지 않아 작성하지 못한 코드는 주석을 남겨 놓았어요.

- 요청에서 Member ID 사용 - 응답에서 내 발자국인지 여부도 반환

github-actions · 2024-07-18T12:09:22Z

Unit Test Results

56 tests 56 ✔️ 2s ⏱️
11 suites   0 💤
11 files   0 ❌

Results for commit 19eb0a5.

♻️ This comment has been updated with latest results.

jimi567

리뷰 남겼어요~~ 고생하셨습니다 트레!!

jimi567 · 2024-07-19T02:12:49Z

backend/src/main/java/com/woowacourse/friendogly/footprint/controller/FootprintController.java

+
+    @PostMapping("/image/{footprintId}")
+    public ResponseEntity<UpdateFootprintImageResponse> updateFootprintImage(
+        @PathVariable Long footprintId,
+        @ModelAttribute UpdateFootprintImageRequest request
+    ) {


해당 핸들러는 이미지 업데이트를 위한 것 같은데
@PostMapping을 사용한 이유가 있을까요?

@PathVariable이랑 ModelAttribute를 같이 받기 보단 하나의 requestBody로 받으면 어떨까 싶은데 저렇게 한 이유가 있을까 궁금해요!!

patch로 바꿔 봐도 좋겠네요.

+파일을 받으려면 ModelAttribute를 써야 한다고 하더라구요. 이 부분은 S3 연동 잘 되는지에 따라 결정해야 할 것 같아요.

jimi567 · 2024-07-19T02:15:33Z

backend/src/main/java/com/woowacourse/friendogly/footprint/domain/Footprint.java

 import lombok.Builder;
 import lombok.Getter;
 import lombok.NoArgsConstructor;

 @Entity
 @Getter
-@NoArgsConstructor
+@NoArgsConstructor(access = AccessLevel.PROTECTED)


꼼꼼함 굿

jimi567 · 2024-07-19T02:17:51Z

backend/src/main/java/com/woowacourse/friendogly/footprint/domain/Footprint.java

+
+    public void setImageUrl(String imageUrl) {
+        this.imageUrl = imageUrl;
+    }


해당 메서드는 jpa 변경감지를 위해 만들어진 setter같은데,
변경 감지를 위해 다른 로직이 들어 갈 가능성도 있으니, 기존의 setter와 목적과 의도가 조금 다르다고 생각합니다. update~ 또는 change~ 와 같은 형태로 메소드명을 통일하면 어떨까 싶어요

동의합니다 👍

jimi567 · 2024-07-19T02:18:41Z

...end/src/main/java/com/woowacourse/friendogly/footprint/dto/request/SaveFootprintRequest.java

+    @NotNull
+    Long memberId,


이왕이면 @positive 검증도 해주면 좋겠네요

jimi567 · 2024-07-19T02:21:05Z

...ava/com/woowacourse/friendogly/footprint/dto/response/FindMyLatestFootprintTimeResponse.java

+import java.time.LocalDateTime;
+
+public record FindMyLatestFootprintTimeResponse(
+    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss") LocalDateTime createdAt


이 부분 날짜, 시간 형식에 대한 포맷팅 코드가 추가된 이후 잊지 않고 삭제해주세염

TODO 써봐도 좋겠네요.

jimi567 · 2024-07-19T02:23:07Z

backend/src/main/java/com/woowacourse/friendogly/footprint/service/FootprintCommandService.java

 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
+import org.springframework.web.multipart.MultipartFile;

 @Service
 @Transactional
 @RequiredArgsConstructor


jimi567 · 2024-07-19T02:24:05Z

backend/src/main/java/com/woowacourse/friendogly/footprint/service/FootprintCommandService.java

+
+    private void validateRecentFootprintExists(Long memberId) {
+        boolean exists = footprintRepository.existsByMemberIdAndCreatedAtAfter(
+            memberId,
+            LocalDateTime.now().minusSeconds(FootprintCommandService.FOOTPRINT_COOLDOWN)
+        );
+
+        if (exists) {
+            throw new FriendoglyException("마지막 발자국을 찍은 뒤 30초가 경과되지 않았습니다.");
+        }
+    }


해당 로직은 foorPrint 도메인 내부에 내려줄 수 있을 것 같은데 어떠신가요?

jimi567 · 2024-07-19T02:26:35Z

backend/src/main/java/com/woowacourse/friendogly/footprint/service/FootprintQueryService.java

        LocalDateTime startTime = LocalDateTime.now().minusHours(FOOTPRINT_DURATION_HOURS);
        List<Footprint> recentFootprints = footprintRepository.findByCreatedAtAfter(startTime);

        Location currentLocation = new Location(request.latitude(), request.longitude());

        return recentFootprints.stream()
            .filter(footprint -> footprint.isNear(currentLocation))
-            .map(FindNearFootprintResponse::from)
+            .map(footprint -> FindNearFootprintResponse.from(footprint, memberId))


어떤건 정적팩토리메소드를 사용하고 어떤건 생성자를 통해 응답 DTO를 생성하는데, 일관성이 유지되면 좋을 것 같아요.

일단 저희 팀은 생성자로 만드는 걸 컨벤션으로 정했었던 것 같아요.!

매개변수가 2개 이상인 정적팩토리메소드의 네이밍 컨벤션은 일반적으로 of를 썼던 것 같아요.

jimi567 · 2024-07-19T02:33:27Z

.../src/test/java/com/woowacourse/friendogly/footprint/service/FootprintCommandServiceTest.java

+    @Autowired
+    private JdbcTemplate jdbcTemplate;
+


저희 JPA 사용하고 있는데 초기 데이터를 jdbcTemplate 사용해서 넣어주는 이유가 있을까요?

J-I-H-O

트레 고생하셨어요~ 리뷰 남겼으니 확인 부탁드려요!

J-I-H-O · 2024-07-18T12:29:51Z

...src/main/java/com/woowacourse/friendogly/footprint/dto/request/FindNearFootprintRequest.java

+    double longitude) {



Suggested change

double longitude) {

double longitude

) {

아이고야

J-I-H-O · 2024-07-18T12:30:55Z

...end/src/main/java/com/woowacourse/friendogly/footprint/dto/request/SaveFootprintRequest.java

+    @NotNull
+    @DecimalMin(value = "-180.0", message = "경도는 -180도 이상 180도 이하로 입력해 주세요.")
+    @DecimalMax(value = "180.0", message = "경도는 -180도 이상 180도 이하로 입력해 주세요.")
+    double longitude) {


Suggested change

double longitude) {

double longitude

) {

어익후야

J-I-H-O · 2024-07-18T12:32:13Z

backend/src/main/java/com/woowacourse/friendogly/footprint/controller/FootprintController.java

        Long id = footprintCommandService.save(request);
        return ResponseEntity.created(URI.create("/footprints/" + id))
            .build();
    }

    @GetMapping("/near")
-    public List<FindNearFootprintResponse> findNear(FindNearFootprintRequest request) {
-        return footprintQueryService.findNear(request);
+    public ResponseEntity<List<FindNearFootprintResponse>> findNear(@Valid FindNearFootprintRequest request) {


List를 반환할 때에는 ResponseEntity를 생략해도 좋을 것 같아요.
추후 response 객체로 감쌀 것을 고려했을 때, 반환 타입이 너무 길어질 것 같습니다.

제 생각은 좀 다르긴 한데
일단 공통 응답을 만들고 생각해 보죠!

J-I-H-O · 2024-07-18T12:52:39Z

backend/src/main/java/com/woowacourse/friendogly/footprint/service/FootprintCommandService.java

+    private void validateRecentFootprintExists(Long memberId) {
+        boolean exists = footprintRepository.existsByMemberIdAndCreatedAtAfter(
+            memberId,
+            LocalDateTime.now().minusSeconds(FootprintCommandService.FOOTPRINT_COOLDOWN)


Suggested change

LocalDateTime.now().minusSeconds(FootprintCommandService.FOOTPRINT_COOLDOWN)

LocalDateTime.now().minusSeconds(FOOTPRINT_COOLDOWN)

J-I-H-O · 2024-07-18T12:53:33Z

backend/src/main/java/com/woowacourse/friendogly/footprint/service/FootprintCommandService.java

 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
+import org.springframework.web.multipart.MultipartFile;

 @Service
 @Transactional
 @RequiredArgsConstructor


저희 컨벤션에서 @RequiredArgsConstructor 는 사용하지 않기로 했어요!

J-I-H-O · 2024-07-19T02:48:34Z

backend/src/test/java/com/woowacourse/friendogly/footprint/domain/LocationTest.java

+            .hasMessage("위도 범위가 올바르지 않습니다.");
+    }
+
+    @DisplayName("생성 실패 - 올바르지 않은 위도 범위")


Suggested change

@DisplayName("생성 실패 - 올바르지 않은 위도 범위")

@DisplayName("위도 범위를 벗어난 값을 입력하는 경우 예외가 발생한다.")

@DisplayName 은 컨벤션에 맞춰 작성해주세요!

J-I-H-O · 2024-07-19T03:00:07Z

...c/main/java/com/woowacourse/friendogly/footprint/dto/response/FindNearFootprintResponse.java

+    Long footprintId,
+    double latitude,
+    double longitude,
+    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss") LocalDateTime createdAt,


@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss") 가 없으면 어떤 형식으로 반환되나요?

{ "createdAt": "2024-07-20T08:42:51.613518" }

@JsonFormat 없이 테스트 해보니 위와 같은 형태로 응답합니다. 소수점까지 함께 응답하네요.
이 부분은 추후에 다시 얘기 나눠봐요!

확인을 까먹고 있었네요
공통 포맷 작성할 때 다시 이야기해 보면 좋겠네요 :)

J-I-H-O · 2024-07-19T03:01:11Z

...c/main/java/com/woowacourse/friendogly/footprint/dto/response/FindNearFootprintResponse.java

+            footprint.getLocation().getLatitude(),
+            footprint.getLocation().getLongitude(),
+            footprint.getCreatedAt(),
+            memberId.equals(footprint.getMember().getId())


내 발자국인지 확인하는 로직은 도메인 로직 아닐까요? Footprint 도메인에 넣어주는 편이 좋겠습니다.

추가로 이렇게 변경하면 DTO로 memberId를 넘겨주기보단, service에서 footprint.isMine() 메서드를 호출하고 DTO에는 그 결과값인 boolean을 넘겨주면 되겠어요.

좋은 생각이네요!

J-I-H-O · 2024-07-19T03:59:15Z

backend/src/main/java/com/woowacourse/friendogly/footprint/service/FootprintQueryService.java

        return recentFootprints.stream()
            .filter(footprint -> footprint.isNear(currentLocation))
-            .map(FindNearFootprintResponse::from)
+            .map(footprint -> FindNearFootprintResponse.from(footprint, memberId))
            .toList();


return recentFootprints.stream() .filter(footprint -> footprint.isNear(currentLocation)) .map(footprint -> FindNearFootprintResponse.from(footprint, footprint.isMine(memberId))) .toList();

위에서 말씀드린 방식으로 변경하면 이런식으로 변경되겠쭁?

ehtjsv2

고생하셨습니ㄷ

jimi567

반영 수고하셨슴다!!!!! 주말 화이팅

J-I-H-O · 2024-07-19T23:44:08Z

...c/main/java/com/woowacourse/friendogly/footprint/dto/response/FindNearFootprintResponse.java

+    Long footprintId,
+    double latitude,
+    double longitude,
+    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss") LocalDateTime createdAt,


{ "createdAt": "2024-07-20T08:42:51.613518" }

@JsonFormat 없이 테스트 해보니 위와 같은 형태로 응답합니다. 소수점까지 함께 응답하네요.
이 부분은 추후에 다시 얘기 나눠봐요!

J-I-H-O · 2024-07-19T23:48:57Z

...c/main/java/com/woowacourse/friendogly/footprint/dto/response/FindNearFootprintResponse.java

+            footprint.getLocation().getLatitude(),
+            footprint.getLocation().getLongitude(),
+            footprint.getCreatedAt(),
+            footprint.isCreatedBy(memberId)


이 부분 한 번만 다시 확인 부탁드릴게요!
DTO는 단순 데이터 전송의 책임만 가지는게 좋을 것 같아요.
도메인 로직 호출은 service에서 수행하고, DTO에는 그 결과값만 넣어주는게 좋겠어요.
#122 (comment)

이것만 진행해주시고 DM 주시면 바로 어푸루부 가겠습니다!

DTO가 로직 호출하는 게 어색하네요~!~! 반영할게요 🙇‍♂️

J-I-H-O

고생 많으셨습니다!!

ehtjsv2 · 2024-07-20T04:36:19Z

...c/main/java/com/woowacourse/friendogly/footprint/dto/response/FindNearFootprintResponse.java

        this(
            footprint.getId(),
            footprint.getLocation().getLatitude(),
            footprint.getLocation().getLongitude(),
            footprint.getCreatedAt(),
-            footprint.isCreatedBy(memberId)
+            isMine


takoyakimchi added 10 commits July 18, 2024 13:28

refactor: 요청 DTO에 위도, 경도 검증 로직 추가

df76f3b

refactor: Location 도메인에 위도, 경도 검증 로직 추가

d35164a

refactor: 발자국 저장 DTO에 검증 로직 추가

63015de

feat: 30초마다 발자국을 남길 수 있도록 검증 추가

894334d

feat: 주변 발자국 조회 명세 변경

ced9183

- 요청에서 Member ID 사용 - 응답에서 내 발자국인지 여부도 반환

feat: 자신이 마지막으로 발자국 찍은 시간 조회 API 구현

76e5072

refactor: not null 옵션 추가하는 어노테이션 추가

c5a92f3

refactor: 기본 생성자 접근제한자 protected로 변경

f9f1448

feat: 발자국에 이미지 추가하는 API 구현

dcf0766

refactor: 컨트롤러에서 ResponseEntity 리턴하도록 통일

e07724e

takoyakimchi added 🖥 backend backend ✨ feat 기능 개발 labels Jul 18, 2024

takoyakimchi added this to the Sprint2 milestone Jul 18, 2024

takoyakimchi requested review from jimi567, ehtjsv2 and J-I-H-O July 18, 2024 12:08

takoyakimchi self-assigned this Jul 18, 2024

takoyakimchi changed the title ~~[BE] feat: 발자국 기능 추가~~ [BE] feat: 발자국 - image URL 필드 추가, 쿨타임 검증 추가, 마지막 발자국 조회 기능 구현 Jul 18, 2024

test: 밀리초 단위가 달라 테스트 실패하던 오류 수정

efa00d6

takoyakimchi linked an issue Jul 18, 2024 that may be closed by this pull request

발자국 - 기능 추가 #84

Closed

jimi567 reviewed Jul 19, 2024

View reviewed changes

J-I-H-O requested changes Jul 19, 2024

View reviewed changes

takoyakimchi added 7 commits July 19, 2024 14:19

refactor: 이미지 URL 업데이트에 대해서 POST -> PATCH 메서드 사용

2a9bf13

refactor: setter 느낌이 나는 메서드 네이밍을 수정

ba91dba

refactor: memberId 검증 추가

81f26ef

style: 개행 정리

64e779d

comment: TODO 주석 추가

1b9abe1

refactor: Lombok의 RequiredArgsConstructor 제거

d2ff93f

refactor: 불필요한 의존 제거

20c51ef

takoyakimchi added 2 commits July 19, 2024 16:42

refactor: 응답 DTO에서 정적 팩토리 제거

3923be8

style: 개행 정리

92ee691

ehtjsv2 reviewed Jul 19, 2024

View reviewed changes

takoyakimchi added 3 commits July 19, 2024 16:47

style: 어노테이션 순서 컨벤션 정리

9c5e7f1

test: DisplayName을 문장형으로 수정

b425599

refactor: 해당 memberId의 발자국인지 확인하는 로직을 도메인으로 이동

6e156d7

jimi567 self-requested a review July 19, 2024 08:38

ehtjsv2 previously approved these changes Jul 19, 2024

View reviewed changes

jimi567 previously approved these changes Jul 19, 2024

View reviewed changes

J-I-H-O reviewed Jul 19, 2024

View reviewed changes

refactor: DTO가 직접 로직을 호출하지 않도록 수정

19eb0a5

takoyakimchi dismissed stale reviews from jimi567 and ehtjsv2 via 19eb0a5 July 20, 2024 02:45

J-I-H-O approved these changes Jul 20, 2024

View reviewed changes

ehtjsv2 approved these changes Jul 20, 2024

View reviewed changes

jimi567 approved these changes Jul 20, 2024

View reviewed changes

takoyakimchi merged commit 463bf95 into develop Jul 20, 2024
3 checks passed

takoyakimchi deleted the feature/be/footprint branch July 20, 2024 07:24

This was linked to issues Jul 20, 2024

발자국(Footprint) 마커 클릭 시 호출되는 API 구현 #124

Closed

발자국(Footprint) 주변 조회 시 해당 발자국의 이미지 URL도 같이 응답 #125

Closed

takoyakimchi added a commit that referenced this pull request Oct 23, 2024

[BE] feat: 발자국 - image URL 필드 추가, 쿨타임 검증 추가, 마지막 발자국 조회 기능 구현 (#122)

30a261b

	LocalDateTime.now().minusSeconds(FootprintCommandService.FOOTPRINT_COOLDOWN)
	LocalDateTime.now().minusSeconds(FOOTPRINT_COOLDOWN)

	@DisplayName("생성 실패 - 올바르지 않은 위도 범위")
	@DisplayName("위도 범위를 벗어난 값을 입력하는 경우 예외가 발생한다.")

[BE] feat: 발자국 - image URL 필드 추가, 쿨타임 검증 추가, 마지막 발자국 조회 기능 구현 #122

[BE] feat: 발자국 - image URL 필드 추가, 쿨타임 검증 추가, 마지막 발자국 조회 기능 구현 #122

Conversation

takoyakimchi commented Jul 18, 2024 • edited Loading

이슈

개발 사항

전달 사항

github-actions bot commented Jul 18, 2024 • edited Loading

Unit Test Results

jimi567 left a comment • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

takoyakimchi Jul 19, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

J-I-H-O left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

J-I-H-O Jul 19, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

ehtjsv2 left a comment

Choose a reason for hiding this comment

jimi567 left a comment

Choose a reason for hiding this comment

J-I-H-O Jul 19, 2024 • edited Loading

Choose a reason for hiding this comment

J-I-H-O Jul 19, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

J-I-H-O left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

takoyakimchi commented Jul 18, 2024 •

edited

Loading

github-actions bot commented Jul 18, 2024 •

edited

Loading

jimi567 left a comment •

edited

Loading

takoyakimchi Jul 19, 2024 •

edited

Loading

J-I-H-O Jul 19, 2024 •

edited

Loading

J-I-H-O Jul 19, 2024 •

edited

Loading

J-I-H-O Jul 19, 2024 •

edited

Loading