[feat]: 공연 단건 정보 조회 API 추가

api/src/main/java/dev/hooon/common/exception/ApiExceptionHandler.java

@@ -33,4 +33,14 @@ public ErrorResponseTemplate handleMethodArgumentNotValidException(
 
 		return new ErrorResponseTemplate(message, ARGUMENT_NOT_VALID_ERROR_CODE);
 	}
+
+	@ResponseStatus(HttpStatus.NOT_FOUND)
+	@ExceptionHandler(NotFoundException.class)
+	public ErrorResponseTemplate handleNotFoundException(
+		NotFoundException e
+	) {
+		log.error("NotFoundException : ", e);
+		return new ErrorResponseTemplate(e.getMessage(), e.getCode());
+	}
+
 }

api/src/main/java/dev/hooon/show/ShowDetailApiController.java

@@ -0,0 +1,25 @@
+package dev.hooon.show;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RestController;
+
+import dev.hooon.show.application.ShowService;
+import dev.hooon.show.dto.response.ShowDetailsInfoResponse;
+import lombok.RequiredArgsConstructor;
+
+@RestController
+@RequiredArgsConstructor
+public class ShowDetailApiController {
+
+	private final ShowService showService;
+
+	@GetMapping("/api/shows/{show_id}")
+	public ResponseEntity<ShowDetailsInfoResponse> getShowDetailInfo(
+		@PathVariable("show_id") Long showId
+	) {
+		ShowDetailsInfoResponse showDetailsInfoResponse = showService.getShowDetailInfo(showId);
+		return ResponseEntity.ok(showDetailsInfoResponse);
+	}
+}

api/src/test/java/dev/hooon/show/ShowDetailApiControllerTest.java

@@ -0,0 +1,48 @@
+package dev.hooon.show;
+
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
+
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.test.context.jdbc.Sql;
+import org.springframework.test.web.servlet.MockMvc;
+import org.springframework.test.web.servlet.ResultActions;
+import org.springframework.test.web.servlet.request.MockMvcRequestBuilders;
+
+import dev.hooon.common.support.ApiTestSupport;
+
+@DisplayName("[ShowDetailApiController API 테스트]")
+@Sql("/sql/show_dummy.sql")
+class ShowDetailApiControllerTest extends ApiTestSupport {
+
+	@Autowired
+	private MockMvc mockMvc;
+
+	@DisplayName("[공연 아이디를 통해 API 를 호출하면 해당 공연의 세부 정보를 조회할 수 있다]")
+	@Test
+	void getShowDetailInfoTest() throws Exception {
+		// when
+		ResultActions resultActions = mockMvc.perform(
+			MockMvcRequestBuilders
+				.get("/api/shows/1")
+		);
+
+		// then
+		resultActions.andExpectAll(
+			status().isOk(),
+
+			jsonPath("$.showName").value("레미제라블"),
+			jsonPath("$.showStartDate").value("2023-10-10"),
+			jsonPath("$.showEndDate").value("2023-10-12"),
+			jsonPath("$.showTime").value(150),
+			jsonPath("$.showIntermissionTime").value(15),
+			jsonPath("$.showAgeLimit").value("만 8세 이상"),
+
+			jsonPath("$.placeDetailsInfo.showPlaceName").value("블루스퀘어 신한카드홀"),
+			jsonPath("$.placeDetailsInfo.showPlaceContactInfo").value("1544-1591"),
+			jsonPath("$.placeDetailsInfo.showPlaceAddress").value("서울특별시 용산구 이태원로 294 블루스퀘어(한남동)"),
+			jsonPath("$.placeDetailsInfo.showPlaceUrl").value("http://www.bluesquare.kr/index.asp")
+		);
+	}
+}

core/build.gradle

@@ -2,6 +2,7 @@ dependencies {
     runtimeOnly 'org.postgresql:postgresql'
     implementation 'org.springframework.boot:spring-boot-starter'
     implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
+    implementation 'com.fasterxml.jackson.core:jackson-databind'
     //테스트 픽쳐에서 사용할 의존성
     testFixturesImplementation 'org.springframework.boot:spring-boot-starter-test'
     testFixturesImplementation "org.testcontainers:testcontainers:1.19.3"

core/src/main/java/dev/hooon/show/application/ShowService.java

@@ -1,13 +1,19 @@
 package dev.hooon.show.application;
 
 import java.util.List;
+import java.util.Optional;
 
 import org.springframework.stereotype.Service;
 
+import dev.hooon.common.exception.NotFoundException;
+import dev.hooon.show.domain.entity.Show;
 import dev.hooon.show.domain.repository.SeatRepository;
+import dev.hooon.show.domain.repository.ShowRepository;
 import dev.hooon.show.dto.ShowMapper;
 import dev.hooon.show.dto.query.SeatDateRoundDto;
 import dev.hooon.show.dto.response.AbleBookingDateRoundResponse;
+import dev.hooon.show.dto.response.ShowDetailsInfoResponse;
+import dev.hooon.show.exception.ShowErrorCode;
 import lombok.RequiredArgsConstructor;
 
 @Service
@@ -16,8 +22,18 @@ public class ShowService {
 
 	private final SeatRepository seatRepository;
 
+	private final ShowRepository showRepository;
+
 	public AbleBookingDateRoundResponse getAbleBookingDateRoundInfo(Long showId) {
 		List<SeatDateRoundDto> seatDateRoundDtoList = seatRepository.findSeatDateRoundInfoByShowId(showId);
 		return ShowMapper.toSeatDateRoundResponse(seatDateRoundDtoList);
 	}
+
+	public ShowDetailsInfoResponse getShowDetailInfo(Long showId) {
+		Optional<Show> showOptional = showRepository.findById(showId);
+		if (showOptional.isEmpty()) {
+			throw new NotFoundException(ShowErrorCode.SHOW_NOT_FOUND);
+		}
+		return ShowMapper.toShowDetailInfoResponse(showOptional.get());
+	}
 }

core/src/main/java/dev/hooon/show/domain/entity/Show.java

@@ -17,40 +17,42 @@
 import jakarta.persistence.JoinColumn;
 import jakarta.persistence.ManyToOne;
 import jakarta.persistence.Table;
+import lombok.AllArgsConstructor;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
 
 @Entity
 @Getter
 @Table(name = "show_table")
 @NoArgsConstructor
+@AllArgsConstructor
 public class Show extends TimeBaseEntity {
 
-    @Id
-    @GeneratedValue(strategy = IDENTITY)
-    @Column(name = "show_id")
-    private Long id;
+	@Id
+	@GeneratedValue(strategy = IDENTITY)
+	@Column(name = "show_id")
+	private Long id;
 
-    @Column(name = "show_name", nullable = false)
-    private String name;
+	@Column(name = "show_name", nullable = false)
+	private String name;
 
-    @Enumerated(STRING)
-    @Column(name = "show_category", nullable = false)
-    private ShowCategory category;
+	@Enumerated(STRING)
+	@Column(name = "show_category", nullable = false)
+	private ShowCategory category;
 
-    @Embedded
-    private ShowPeriod showPeriod;
+	@Embedded
+	private ShowPeriod showPeriod;
 
-    @Embedded
-    private ShowTime showTime;
+	@Embedded
+	private ShowTime showTime;
 
-    @Column(name = "show_age_limit", nullable = false)
-    private String showAgeLimit;
+	@Column(name = "show_age_limit", nullable = false)
+	private String showAgeLimit;
 
-    @Column(name = "show_total_seats")
-    private int totalSeats;
+	@Column(name = "show_total_seats")
+	private int totalSeats;
 
-    @ManyToOne(fetch = LAZY)
-    @JoinColumn(name = "show_place_id", nullable = false, foreignKey = @ForeignKey(value = NO_CONSTRAINT))
-    private Place place;
+	@ManyToOne(fetch = LAZY)
+	@JoinColumn(name = "show_place_id", nullable = false, foreignKey = @ForeignKey(value = NO_CONSTRAINT))
+	private Place place;
 }

core/src/main/java/dev/hooon/show/domain/entity/ShowPeriod.java

@@ -6,6 +6,7 @@
 
 import jakarta.persistence.Column;
 import jakarta.persistence.Embeddable;
+import lombok.AllArgsConstructor;
 import lombok.EqualsAndHashCode;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
@@ -14,11 +15,12 @@
 @Embeddable
 @EqualsAndHashCode
 @NoArgsConstructor(access = PROTECTED)
+@AllArgsConstructor
 public class ShowPeriod {
 
-    @Column(name = "show_start_date", nullable = false)
-    private LocalDate startDate;
+	@Column(name = "show_start_date", nullable = false)
+	private LocalDate startDate;
 
-    @Column(name = "show_end_date", nullable = false)
-    private LocalDate endDate;
+	@Column(name = "show_end_date", nullable = false)
+	private LocalDate endDate;
 }

core/src/main/java/dev/hooon/show/domain/entity/ShowTime.java

@@ -4,6 +4,7 @@
 
 import jakarta.persistence.Column;
 import jakarta.persistence.Embeddable;
+import lombok.AllArgsConstructor;
 import lombok.EqualsAndHashCode;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
@@ -12,11 +13,12 @@
 @Embeddable
 @EqualsAndHashCode
 @NoArgsConstructor(access = PROTECTED)
+@AllArgsConstructor
 public class ShowTime {
 
-    @Column(name = "show_total_minutes", nullable = false)
-    private int totalMinutes;
+	@Column(name = "show_total_minutes", nullable = false)
+	private int totalMinutes;
 
-    @Column(name = "show_intermission_minutes", nullable = false)
-    private int intermissionMinutes;
+	@Column(name = "show_intermission_minutes", nullable = false)
+	private int intermissionMinutes;
 }

core/src/main/java/dev/hooon/show/domain/entity/place/Place.java

@@ -8,29 +8,31 @@
 import jakarta.persistence.GeneratedValue;
 import jakarta.persistence.Id;
 import jakarta.persistence.Table;
+import lombok.AllArgsConstructor;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
 
 @Entity
 @Getter
 @Table(name = "place_table")
 @NoArgsConstructor
+@AllArgsConstructor
 public class Place extends TimeBaseEntity {
 
-    @Id
-    @GeneratedValue(strategy = IDENTITY)
-    @Column(name = "place_id")
-    private Long id;
+	@Id
+	@GeneratedValue(strategy = IDENTITY)
+	@Column(name = "place_id")
+	private Long id;
 
-    @Column(name = "place_name", nullable = false)
-    private String name;
+	@Column(name = "place_name", nullable = false)
+	private String name;
 
-    @Column(name = "place_contact_info")
-    private String contactInfo;
+	@Column(name = "place_contact_info")
+	private String contactInfo;
 
-    @Column(name = "place_address", nullable = false)
-    private String address;
+	@Column(name = "place_address", nullable = false)
+	private String address;
 
-    @Column(name = "place_url")
-    private String placeUrl;
+	@Column(name = "place_url")
+	private String placeUrl;
 }

core/src/main/java/dev/hooon/show/domain/repository/PlaceRepository.java

@@ -0,0 +1,8 @@
+package dev.hooon.show.domain.repository;
+
+import dev.hooon.show.domain.entity.place.Place;
+
+public interface PlaceRepository {
+
+	Place save(Place place);
+}

core/src/main/java/dev/hooon/show/domain/repository/ShowRepository.java

@@ -0,0 +1,12 @@
+package dev.hooon.show.domain.repository;
+
+import java.util.Optional;
+
+import dev.hooon.show.domain.entity.Show;
+
+public interface ShowRepository {
+
+	Optional<Show> findById(Long id);
+
+	Show save(Show show);
+}

core/src/main/java/dev/hooon/show/dto/ShowMapper.java

@@ -2,9 +2,12 @@
 
 import java.util.List;
 
+import dev.hooon.show.domain.entity.Show;
 import dev.hooon.show.dto.query.SeatDateRoundDto;
 import dev.hooon.show.dto.response.AbleBookingDateRoundResponse;
 import dev.hooon.show.dto.response.AbleBookingDateRoundResponse.AvailableDate;
+import dev.hooon.show.dto.response.PlaceDetailsInfo;
+import dev.hooon.show.dto.response.ShowDetailsInfoResponse;
 import lombok.AccessLevel;
 import lombok.NoArgsConstructor;
 
@@ -21,4 +24,21 @@ public static AbleBookingDateRoundResponse toSeatDateRoundResponse(List<SeatDate
 
 		return new AbleBookingDateRoundResponse(availableDates);
 	}
+
+	public static ShowDetailsInfoResponse toShowDetailInfoResponse(Show show) {
+		return new ShowDetailsInfoResponse(
+			show.getName(),
+			show.getShowPeriod().getStartDate(),
+			show.getShowPeriod().getEndDate(),
+			show.getShowTime().getTotalMinutes(),
+			show.getShowTime().getIntermissionMinutes(),
+			show.getShowAgeLimit(),
+			new PlaceDetailsInfo(
+				show.getPlace().getName(),
+				show.getPlace().getContactInfo(),
+				show.getPlace().getAddress(),
+				show.getPlace().getPlaceUrl()
+			)
+		);
+	}
 }

core/src/main/java/dev/hooon/show/dto/response/PlaceDetailsInfo.java

@@ -0,0 +1,9 @@
+package dev.hooon.show.dto.response;
+
+public record PlaceDetailsInfo(
+	String showPlaceName,
+	String showPlaceContactInfo,
+	String showPlaceAddress,
+	String showPlaceUrl
+) {
+}

core/src/main/java/dev/hooon/show/dto/response/ShowDetailsInfoResponse.java

@@ -0,0 +1,18 @@
+package dev.hooon.show.dto.response;
+
+import java.time.LocalDate;
+
+import com.fasterxml.jackson.annotation.JsonFormat;
+
+public record ShowDetailsInfoResponse(
+	String showName,
+	@JsonFormat(pattern = "yyyy-MM-dd")
+	LocalDate showStartDate,
+	@JsonFormat(pattern = "yyyy-MM-dd")
+	LocalDate showEndDate,
+	int showTime,
+	int showIntermissionTime,
+	String showAgeLimit,
+	PlaceDetailsInfo placeDetailsInfo
+) {
+}

core/src/main/java/dev/hooon/show/exception/ShowErrorCode.java

@@ -0,0 +1,15 @@
+package dev.hooon.show.exception;
+
+import dev.hooon.common.exception.ErrorCode;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum ShowErrorCode implements ErrorCode {
+
+	SHOW_NOT_FOUND("공연을 찾을 수 없습니다.", "S_001");
+
+	private final String message;
+	private final String code;
+}