feat: Spotify 곡 조회 기능 구현 (#43)

* chore: spotify 의존성 추가

* chore: spotify.yml 생성

* chore: spotify properties 추가

* chore: spotify config 추가

* feat: 장르 기반 스포티파이 음악 검색 기능 구현

* refactor: 장르, 년도 기반 검색 로직 개선

Author: ht3064

build.gradle

@@ -55,6 +55,9 @@ dependencies {
 
     // MySQL
     implementation 'mysql:mysql-connector-java:8.0.33'
+
+    // Spotify
+    implementation 'se.michaelthelin.spotify:spotify-web-api-java:8.4.1'
 }
 
 tasks.named('test') {

src/main/java/com/amcamp/domain/spotify/api/SpotifyController.java

@@ -0,0 +1,24 @@
+package com.amcamp.domain.spotify.api;
+
+import com.amcamp.domain.spotify.application.SpotifyService;
+import com.amcamp.domain.spotify.dto.response.SpotifySearchResponse;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/music")
+public class SpotifyController {
+
+    private final SpotifyService spotifyService;
+
+    @GetMapping("/search")
+    public List<SpotifySearchResponse> searchSpotify(@RequestParam List<String> genres) {
+        return spotifyService.searchByGenre(genres);
+    }
+}

src/main/java/com/amcamp/domain/spotify/application/SpotifyService.java

@@ -0,0 +1,94 @@
+package com.amcamp.domain.spotify.application;
+
+import com.amcamp.domain.spotify.dto.response.SpotifySearchResponse;
+import com.amcamp.global.error.exception.CustomException;
+import com.amcamp.global.error.exception.ErrorCode;
+import com.amcamp.global.util.MemberUtil;
+import com.amcamp.infra.config.spotify.SpotifyConfig;
+import lombok.RequiredArgsConstructor;
+import org.apache.hc.core5.http.ParseException;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import se.michaelthelin.spotify.SpotifyApi;
+import se.michaelthelin.spotify.exceptions.SpotifyWebApiException;
+import se.michaelthelin.spotify.model_objects.specification.*;
+import se.michaelthelin.spotify.requests.data.search.simplified.SearchTracksRequest;
+
+import java.io.IOException;
+import java.util.Arrays;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Set;
+
+import static com.neovisionaries.i18n.CountryCode.KR;
+
+@Transactional
+@Service
+@RequiredArgsConstructor
+public class SpotifyService {
+
+    private final SpotifyConfig spotifyConfig;
+    private final MemberUtil memberUtil;
+
+    public List<SpotifySearchResponse> searchByGenre(List<String> genres) {
+        memberUtil.getCurrentMember();
+
+        Track[] tracks = getTrackInfoByGenre(genres);
+
+        return Arrays.stream(tracks)
+                .map(this::getTrackData)
+                .toList();
+    }
+
+    /*
+     * 장르에 따른 검색 결과를 반환합니다.
+     */
+    public Track[] getTrackInfoByGenre(List<String> genres) {
+        try {
+            SpotifyApi spotifyApi = new SpotifyApi.Builder()
+                    .setAccessToken(spotifyConfig.generateAccessToken())
+                    .build();
+
+            Set<Track> uniqueTracks = new LinkedHashSet<>();
+
+            for (String genre : genres) {
+                String query = "genre:" + genre + " year:2024-2025";
+
+                SearchTracksRequest searchTrackRequest = spotifyApi.searchTracks(query)
+                        .market(KR)
+                        .limit(10)
+                        .build();
+
+                Paging<Track> searchResult = searchTrackRequest.execute();
+
+                List<Track> selectedTracks = Arrays.stream(searchResult.getItems())
+                        .limit(3)
+                        .toList();
+
+                uniqueTracks.addAll(selectedTracks);
+
+                if (uniqueTracks.size() >= 10) {
+                    break;
+                }
+            }
+
+            return uniqueTracks.toArray(new Track[0]);
+        } catch (IOException | ParseException | SpotifyWebApiException e) {
+            throw new CustomException(ErrorCode.SPOTIFY_EXCEPTION);
+        }
+    }
+
+    private SpotifySearchResponse getTrackData(Track track) {
+        ArtistSimplified[] artists = track.getArtists();
+        String artistName = artists[0].getName();
+
+        AlbumSimplified album = track.getAlbum();
+        String albumName = album.getName();
+
+        Image[] images = album.getImages();
+        String imageUrl = (images.length > 0) ? images[0].getUrl() : "NO_IMAGE";
+
+        return SpotifySearchResponse.of(artistName, track.getName(), albumName, imageUrl);
+    }
+}
+

src/main/java/com/amcamp/domain/spotify/dto/response/SpotifySearchResponse.java

@@ -0,0 +1,7 @@
+package com.amcamp.domain.spotify.dto.response;
+
+public record SpotifySearchResponse(String artistName, String title, String albumName, String imageUrl) {
+    public static SpotifySearchResponse of(String artistName, String title, String albumName, String imageUrl) {
+        return new SpotifySearchResponse(artistName, title, albumName, imageUrl);
+    }
+}

src/main/java/com/amcamp/global/error/exception/ErrorCode.java

@@ -12,6 +12,8 @@ public enum ErrorCode {
     AUTH_NOT_FOUND(HttpStatus.UNAUTHORIZED, "사용자 인증 정보를 찾을 수 없습니다. 올바른 토큰으로 요청해주세요."),
 
     MEMBER_NOT_FOUND(HttpStatus.NOT_FOUND, "회원을 찾을 수 없습니다."),
+
+    SPOTIFY_EXCEPTION(HttpStatus.SERVICE_UNAVAILABLE, "스포티파이 라이브러리 사용 중 예외가 발생했습니다."),
     ;
 
     private final HttpStatus httpStatus;

src/main/java/com/amcamp/infra/config/properties/PropertiesConfig.java

@@ -4,6 +4,7 @@
 import com.amcamp.infra.config.jwt.JwtProperties;
 import com.amcamp.infra.config.oauth.KakaoProperties;
 import com.amcamp.infra.config.redis.RedisProperties;
+import com.amcamp.infra.config.spotify.SpotifyProperties;
 import org.springframework.boot.context.properties.EnableConfigurationProperties;
 import org.springframework.context.annotation.Configuration;
 
@@ -12,6 +13,7 @@
         KakaoProperties.class,
         JwtProperties.class,
         ChatProperties.class,
+        SpotifyProperties.class,
 })
 @Configuration
 public class PropertiesConfig {

src/main/java/com/amcamp/infra/config/spotify/SpotifyConfig.java

@@ -0,0 +1,40 @@
+package com.amcamp.infra.config.spotify;
+
+import com.amcamp.global.error.exception.CustomException;
+import com.amcamp.global.error.exception.ErrorCode;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.hc.core5.http.ParseException;
+import org.springframework.stereotype.Component;
+import se.michaelthelin.spotify.SpotifyApi;
+import se.michaelthelin.spotify.exceptions.SpotifyWebApiException;
+import se.michaelthelin.spotify.model_objects.credentials.ClientCredentials;
+import se.michaelthelin.spotify.requests.authorization.client_credentials.ClientCredentialsRequest;
+
+import java.io.IOException;
+
+@Component
+@Slf4j
+public class SpotifyConfig {
+
+    private final SpotifyApi spotifyApi;
+
+    private SpotifyConfig(SpotifyProperties spotifyProperties) {
+        this.spotifyApi =
+                new SpotifyApi.Builder()
+                        .setClientId(spotifyProperties.clientId())
+                        .setClientSecret(spotifyProperties.clientSecret())
+                        .build();
+    }
+
+    public String generateAccessToken() {
+        ClientCredentialsRequest clientCredentialsRequest = spotifyApi.clientCredentials().build();
+        try {
+            final ClientCredentials clientCredentials = clientCredentialsRequest.execute();
+            spotifyApi.setAccessToken(clientCredentials.getAccessToken());
+            return spotifyApi.getAccessToken();
+        } catch (IOException | SpotifyWebApiException | ParseException e) {
+            log.error(e.getMessage());
+            throw new CustomException(ErrorCode.SPOTIFY_EXCEPTION);
+        }
+    }
+}

src/main/java/com/amcamp/infra/config/spotify/SpotifyProperties.java

@@ -0,0 +1,7 @@
+package com.amcamp.infra.config.spotify;
+
+import org.springframework.boot.context.properties.ConfigurationProperties;
+
+@ConfigurationProperties("spotify")
+public record SpotifyProperties(String clientId, String clientSecret) {
+}

src/main/resources/application-spotify.yml

@@ -0,0 +1,7 @@
+spring:
+  config:
+    activate:
+      on-profile: "spotify"
+spotify:
+  client-id: ${SPOTIFY_CLIENT_ID}
+  client-secret: ${SPOTIFY_CLIENT_SECRET}

src/main/resources/application.yml

@@ -6,4 +6,5 @@ spring:
     include:
       - security
       - redis
-      - gemini
+      - gemini
+      - spotify