[Spring 프로젝트] 전적검색 구현

요구사항

• RIOT 에서 제공하는 API  사용
• API KEY 값 공유되지 않도록 설정
• Json 기반의 API 를 자바 객체로 역직렬화
• 검색시 최근 10게임 전적 표기
• 다음 필드 조회 및 커스터마이징
  
  • 소환사 정보 (닉네임, 레벨, 티어, 승/패) 표기
  • 플레이한 챔피언, 승/패, 경기 시간, KDA

 

미리보기

 

1. 소환사 정보 조회

1.1 사용 API: https://developer.riotgames.com/apis#summoner-v4/GET_getBySummonerName

Riot Developer Portal

 

1.2 SummonerDTO.java: 소환사 정보 조회시 사용되는 객체

//SummonerDTO.java

import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Data;

@Data
public class SummonerDTO {
        private String id;
        private String accountId;
        private String puuid;
        private String name;

        @JsonProperty("profileIconId")
        private String profileImg;
        private long revisionDate;
        private int summonerLevel;

	// 프로필 이미지 URL
        public void setProfileImg(String profileImg) {
                this.profileImg = "http://ddragon.leagueoflegends.com/cdn/13.24.1/img/profileicon/"+ profileImg + ".png";
        }
}

 

 

1.3 RiotApi.java: 소환사 정보 조회 API 호출 및 역직렬화

//RiotApi.java

import ...

@Service
@RequiredArgsConstructor
public class RiotApi {

    private final RestTemplate restTemplate;

    @Autowired
    private final RiotApiConfig riotApiConfig; // APIKEY 설정
    private final String RiotUri_getSummoner = "https://kr.api.riotgames.com/lol/summoner/v4/summoners/by-name/{summonerName}";

    public SummonerDTO getSummoner(String summonerName){
        final HttpHeaders headers = new HttpHeaders();
        headers.set("X-Riot-Token", riotApiConfig.getRIOT_API_KEY());
        final HttpEntity<String> entity = new HttpEntity<>(headers);
        return restTemplate.exchange(RiotUri_getSummoner, HttpMethod.GET, entity, SummonerDTO.class, summonerName).getBody();
    }
    ...
}

 

1.4 SummonerService.java: 소환사 정보 조회 로직 구현

//SummonerService.java

import ...

@Service
@RequiredArgsConstructor
public class SummonerService {
    private final RiotApi riotApi;

    public SummonerDTO findSummoner(String summonerName){
        return riotApi.getSummoner(summonerName);
    }
    ...
}

 

2. 리그(티어) 조회

2.1 사용 API: https://developer.riotgames.com/apis#league-v4/GET_getLeagueEntriesForSummoner

Riot Developer Portal

 

2.2 LeagueEntryDTO.java: 리그(티어) 조회시 사용되는 객체

// LeagueEntryDTO.java

import com.fasterxml.jackson.annotation.JsonCreator;
import lombok.*;

@Getter
@ToString
@AllArgsConstructor
@NoArgsConstructor
public class LeagueEntryDTO {

        private String leagueId;
        private String summonerId;
        private String summonerName;
        private String queueType;
        private String tier;
        private String rank;

        private int leaguePoints;
        private int wins;
        private int losses;

        private boolean hotStreak;
        private boolean veteran;
        private boolean freshBlood;
        private boolean inactive;
}

 

2.3 RiotApi.java: 리그(티어) 조회 API 호출 및 역직렬화

//RiotApi.java

import ...

@Service
@RequiredArgsConstructor
public class RiotApi {

    private final RestTemplate restTemplate;

    @Autowired
    private final RiotApiConfig riotApiConfig;
    ...
    private final String RiotUri_getLeagueEntries = "https://kr.api.riotgames.com/lol/league/v4/entries/by-summoner/{encryptedSummonerId}";

    public LeagueEntryDTO[] getLeagueEntries(String encryptedSummonerId) {
        final HttpHeaders headers = new HttpHeaders();
        headers.set("X-Riot-Token", riotApiConfig.getRIOT_API_KEY());
        final HttpEntity<String> entity = new HttpEntity<>(headers);
        return restTemplate.exchange(RiotUri_getLeagueEntries, HttpMethod.GET, entity, LeagueEntryDTO[].class, encryptedSummonerId).getBody();
    }
    ...
}

 

2.4 SummonerService.java: 리그(티어) 조회 로직 구현

//SummonerService.java

import ...

@Service
@RequiredArgsConstructor
public class SummonerService {
    private final RiotApi riotApi;

    public LeagueEntryDTO[] findLeagueEntry(String encryptedSummonerId){
        return riotApi.getLeagueEntries(encryptedSummonerId);
    }
    ...
}

 

3. 최근 매치 ID 조회

3.1 사용 API: https://developer.riotgames.com/apis#match-v5/GET_getMatchIdsByPUUID

Riot Developer Portal

 

3.2 RiotApi.java: 최근 매치 ID 조회 API 호출 및 역직렬화

//RiotApi.java

import ...

@Service
@RequiredArgsConstructor
public class RiotApi {

    private final RestTemplate restTemplate;

    @Autowired
    private final RiotApiConfig riotApiConfig;
    ...
    private final String RiotUri_getMatchList = "https://asia.api.riotgames.com/lol/match/v5/matches/by-puuid/{puuid}/ids?start=0&count=10";

    public String[] getMatchList(String puuid){
        final HttpHeaders headers = new HttpHeaders();
        headers.set("X-Riot-Token", riotApiConfig.getRIOT_API_KEY());
        final HttpEntity<String> entity = new HttpEntity<>(headers);
        return restTemplate.exchange(RiotUri_getMatchList, HttpMethod.GET, entity, String[].class, puuid).getBody();
    }
    ...
}

 

3.3 SummonerService.java: 최근 매치 ID 조회 로직 구현

//SummonerService.java

import ...

@Service
@RequiredArgsConstructor
public class SummonerService {
    private final RiotApi riotApi;

    public String[] findMatchList(String puuid){
        return riotApi.getMatchList(puuid);
    }
    ...
}

 

4. 상세 매치 정보 조회

4.1 사용 API: https://developer.riotgames.com/apis#match-v5/GET_getMatch.

Riot Developer Portal

 

4.2 MatchDto.java: 상세 매치 정보 조회시 역직렬화에 사용되는 객체

// MatchDto.java

import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.annotation.JsonSetter;
import lombok.*;

import java.util.List;

@Data
@JsonIgnoreProperties(ignoreUnknown = true)
@NoArgsConstructor
public class MatchDto {
    @JsonProperty("info")
    private InfoDto info;

    @Getter @Setter
    public static class InfoDto{
        @JsonProperty("participants")
        private List<ParticipantDto> participants;

        @JsonProperty("gameDuration") // 게임 시간(초)
        private String gameDuration;

        @JsonProperty("gameMode") // CLASSIC: 일반, ARAM: 무작위 총력전
        private String gameMode;

        public void setGameDuration(int gameDuration) {
            this.gameDuration = String.valueOf(gameDuration/60) + "분 " + String.valueOf(gameDuration%60) + "초" ;
        }

        public void setGameMode(String gameMode) {
            if (gameMode.equals("CLASSIC")){
                this.gameMode = "일반";
            } else if (gameMode.equals("ARAM")) {
                this.gameMode = "무작위 총력전";
            } else {
                this.gameMode = "기타";
            }
        }
    }

    @Getter @Setter
    public static class ParticipantDto{
        @JsonProperty("win")
        boolean win;

        @JsonProperty("puuid")
        String puuid;

        @JsonProperty("teamId")
        int teamId;

        @JsonProperty("kills")
        int kills;

        @JsonProperty("deaths")
        int deaths;

        @JsonProperty("assists")
        int assists;

        @JsonProperty("championId")
        String championId;

        @JsonProperty("championName")
        String championImg;

        public void setChampionImg(String championImg) {
            this.championImg = "http://ddragon.leagueoflegends.com/cdn/13.24.1/img/champion/" + championImg + ".png";
        }
    }
}

• @JsonIgnoreProperties(ignoreUnknown = true) : 필드가 전부 선언되지 않아도 가져올수있도록 설정. MatchDto는 매우 복잡한 구조라 필요한 필드만을 선언
• ParticipantDto 등의 복잡한 하위 필드들은 내부 클래스가 아닌 static으로 선언: 다른 디렉토리에서도 참조하기 위해
• 그 외 챔피언 이미지, 게임 타입등이 표기 되도록 적절히 커스터마이징

 

4.3 필드 커스터마이징에 사용되는 객체

package dodgekr.lolcommunity.summoner.domain;

import lombok.Data;

@Data
public class OwnMatchDto {
    MatchDto.ParticipantDto participantDto = new MatchDto.ParticipantDto();
    private String gameMode;
    private String gameDuration;
}

• MatchDto.java 의 경우 ParticipantDto를 리스트 형태의 필드로 가짐.
• 전적 검색한 소환사에 대한 정보만을 가져오기 위해 ParticipantDto를 단일 필드로 가지는 OwnMatchDto 생성

 

4.4 RiotApi.java: 상세 매치 정보 조회  API 호출 및 역직렬화

//RiotApi.java

import ...

@Service
@RequiredArgsConstructor
public class RiotApi {

    private final RestTemplate restTemplate;

    @Autowired
    private final RiotApiConfig riotApiConfig;
    ...
    private final String RiotUri_getMatch = "https://asia.api.riotgames.com/lol/match/v5/matches/{matchId}";
    
    public MatchDto getMatch(String matchId){
        final HttpHeaders headers = new HttpHeaders();
        headers.set("X-Riot-Token", riotApiConfig.getRIOT_API_KEY());
        final HttpEntity<String> entity = new HttpEntity<>(headers);
        return restTemplate.exchange(RiotUri_getMatch, HttpMethod.GET, entity, MatchDto.class, matchId).getBody();
    }
    ...
}

 

 

4.5 SummonerService.java: 상세 매치 정보 조회 로직 구현

//SummonerService.java

import ...

@Service
@RequiredArgsConstructor
public class SummonerService {
    private final RiotApi riotApi;

    public List<OwnMatchDto> getOwnMatchDtoList(String[] matchIds, SummonerDTO summonerDTO) {

        // 1. 조회할 매치 id 값(리스트)과 검색한 소환사 정보값(단일) 파라미터로 들어옴

        // 2. 결과로 출력할 List<OwnMatchDto> 객체 생성
        List<OwnMatchDto> ownMatchDtoList = new ArrayList<>();

        // 3. 매치 id loop
        for (String matchId : matchIds) {

            // 3.1 매치 아이디별 상세 매치 정보 조회
            OwnMatchDto ownMatchDto = new OwnMatchDto();
            MatchDto matchDto = this.findMatch(matchId);

            // 3.2 ownMatchDto 게임 정보 설정
            ownMatchDto.setGameDuration(matchDto.getInfo().getGameDuration());
            ownMatchDto.setGameMode(matchDto.getInfo().getGameMode());

            // 3.3 ParticipantDto 중 소환사 정보값과 일치하는 값만 ownMatchDto 값으로 set
            List<MatchDto.ParticipantDto> participants = matchDto.getInfo().getParticipants();
            for (MatchDto.ParticipantDto p : participants) {
                if (p.getPuuid().equals(summonerDTO.getPuuid())) {
                    ownMatchDto.setParticipantDto(p);
                    break;
                }
            }

            ownMatchDtoList.add(ownMatchDto);
        }
        // 4. ownMatchDtoList 리턴
        return ownMatchDtoList;
    }
    ...
}

 

5. 전체 코드

5.1 SummonerController

// SummonerController.java

import dodgekr.lolcommunity.summoner.domain.LeagueEntryDTO;
import dodgekr.lolcommunity.summoner.domain.OwnMatchDto;
import dodgekr.lolcommunity.summoner.domain.SummonerDTO;
import lombok.RequiredArgsConstructor;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

import java.util.List;

@Controller
@RequiredArgsConstructor
public class SummonerController {

    private final SummonerService summonerService;

    @RequestMapping(value = "/summoner/{summonerName}", method = RequestMethod.GET)
    public String searchSummoner(Model model, @PathVariable String summonerName){
        SummonerDTO summonerDTO = summonerService.findSummoner(summonerName);
        LeagueEntryDTO[] leagueEntryDTO = summonerService.findLeagueEntry(summonerDTO.getId());
        String[] matchList = summonerService.findMatchList(summonerDTO.getPuuid());
        List<OwnMatchDto> ownMatchDtoList = summonerService.getOwnMatchDtoList(matchList, summonerDTO);

        model.addAttribute("summonerInfo", summonerDTO);
        model.addAttribute("entryInfo", leagueEntryDTO[0]);
        model.addAttribute("playerRecords", ownMatchDtoList);

       return "summoner_detail";
    }

}

 

5.2 SummonerService

// SummonerService.java

package dodgekr.lolcommunity.summoner;

import dodgekr.lolcommunity.summoner.domain.LeagueEntryDTO;
import dodgekr.lolcommunity.summoner.domain.MatchDto;
import dodgekr.lolcommunity.summoner.domain.OwnMatchDto;
import dodgekr.lolcommunity.summoner.domain.SummonerDTO;
import lombok.RequiredArgsConstructor;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import java.util.ArrayList;
import java.util.List;

@Service
@RequiredArgsConstructor
public class SummonerService {
    private final RiotApi riotApi;

    public SummonerDTO findSummoner(String summonerName) {
        return riotApi.getSummoner(summonerName);
    }

    public LeagueEntryDTO[] findLeagueEntry(String encryptedSummonerId) {
        return riotApi.getLeagueEntries(encryptedSummonerId);
    }

    public String[] findMatchList(String puuid) {
        return riotApi.getMatchList(puuid);
    }

    public MatchDto findMatch(String matchId) {
        return riotApi.getMatch(matchId);
    }

    public List<OwnMatchDto> getOwnMatchDtoList(String[] matchIds, SummonerDTO summonerDTO) {

        // 1. 조회할 매치 id 값(리스트)과 검색한 소환사 정보값(단일) 파라미터로 들어옴

        // 2. 결과로 출력할 List<OwnMatchDto> 객체 생성
        List<OwnMatchDto> ownMatchDtoList = new ArrayList<>();

        // 3. 매치 id loop
        for (String matchId : matchIds) {

            // 3.1 매치 아이디별 상세 매치 정보 조회
            OwnMatchDto ownMatchDto = new OwnMatchDto();
            MatchDto matchDto = this.findMatch(matchId);

            // 3.2 ownMatchDto 게임 정보 설정
            ownMatchDto.setGameDuration(matchDto.getInfo().getGameDuration());
            ownMatchDto.setGameMode(matchDto.getInfo().getGameMode());

            // 3.3 ParticipantDto 중 소환사 정보값과 일치하는 값만 ownMatchDto 값으로 set
            List<MatchDto.ParticipantDto> participants = matchDto.getInfo().getParticipants();
            for (MatchDto.ParticipantDto p : participants) {
                if (p.getPuuid().equals(summonerDTO.getPuuid())) {
                    ownMatchDto.setParticipantDto(p);
                    break;
                }
            }

            ownMatchDtoList.add(ownMatchDto);
        }
        // 4. ownMatchDtoList return
        return ownMatchDtoList;
    }
}

 

5.3 RiotApi.java

// RiotApi.java

import dodgekr.lolcommunity.RiotApiConfig;
import dodgekr.lolcommunity.summoner.domain.LeagueEntryDTO;
import dodgekr.lolcommunity.summoner.domain.MatchDto;
import dodgekr.lolcommunity.summoner.domain.SummonerDTO;
import lombok.RequiredArgsConstructor;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpEntity;
import org.springframework.http.HttpMethod;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;

import org.springframework.http.HttpHeaders;

@Service
@RequiredArgsConstructor
public class RiotApi {

    private final RestTemplate restTemplate;

    @Autowired
    private final RiotApiConfig riotApiConfig;
    private final String RiotUri_getSummoner = "https://kr.api.riotgames.com/lol/summoner/v4/summoners/by-name/{summonerName}";
    private final String RiotUri_getLeagueEntries = "https://kr.api.riotgames.com/lol/league/v4/entries/by-summoner/{encryptedSummonerId}";
    private final String RiotUri_getMatchList = "https://asia.api.riotgames.com/lol/match/v5/matches/by-puuid/{puuid}/ids?start=0&count=10";
    private final String RiotUri_getMatch = "https://asia.api.riotgames.com/lol/match/v5/matches/{matchId}";

    public SummonerDTO getSummoner(String summonerName){
        final HttpHeaders headers = new HttpHeaders();
        headers.set("X-Riot-Token", riotApiConfig.getRIOT_API_KEY());
        final HttpEntity<String> entity = new HttpEntity<>(headers);
        return restTemplate.exchange(RiotUri_getSummoner, HttpMethod.GET, entity, SummonerDTO.class, summonerName).getBody();
    }

    public LeagueEntryDTO[] getLeagueEntries(String encryptedSummonerId) {
        final HttpHeaders headers = new HttpHeaders();
        headers.set("X-Riot-Token", riotApiConfig.getRIOT_API_KEY());
        final HttpEntity<String> entity = new HttpEntity<>(headers);
        return restTemplate.exchange(RiotUri_getLeagueEntries, HttpMethod.GET, entity, LeagueEntryDTO[].class, encryptedSummonerId).getBody();
    }

    public String[] getMatchList(String puuid){
        final HttpHeaders headers = new HttpHeaders();
        headers.set("X-Riot-Token", riotApiConfig.getRIOT_API_KEY());
        final HttpEntity<String> entity = new HttpEntity<>(headers);
        return restTemplate.exchange(RiotUri_getMatchList, HttpMethod.GET, entity, String[].class, puuid).getBody();
    }

    public MatchDto getMatch(String matchId){
        final HttpHeaders headers = new HttpHeaders();
        headers.set("X-Riot-Token", riotApiConfig.getRIOT_API_KEY());
        final HttpEntity<String> entity = new HttpEntity<>(headers);
        return restTemplate.exchange(RiotUri_getMatch, HttpMethod.GET, entity, MatchDto.class, matchId).getBody();
    }
}

 

5.4 summoner_detail.com

<html xmlns:th="http://www.thymeleaf.org"
      xmlns:sec="http://www.thymeleaf.org/thymeleaf-extras-springsecurity6"
      xmlns:layout="http://www.ultraq.net.nz/thymeleaf/layout"
      layout:decorate="~{layout}">

<div layout:fragment="content" class="container my-3">

    <div class="card" style="border-radius: 15px;">
        <div class="card-body p-4">
            <div class="d-flex text-black">
                <div class="flex-shrink-0">
                    <img th:src="${summonerInfo.profileImg}"
                         alt="Generic placeholder image" class="img-fluid"
                         style="width: 180px; border-radius: 10px;">
                </div>
                <div class="flex-grow-1 ms-3">
                    <h5 class="mb-1" th:text="${summonerInfo.name}">Danny McLoan</h5>
                    <p class="mb-2 pb-1" style="color: #2b2a2a;" th:text="|LEVEL ${summonerInfo.summonerLevel}|"></p>
                    <div class="d-flex justify-content-start rounded-3 p-2 mb-2"
                         style="background-color: #efefef;">
                        <div>
                            <p class="small text-muted mb-1">티어</p>
                            <p class="mb-0" th:text="|${entryInfo.tier} ${entryInfo.rank}|"></p>
                        </div>
                        <div class="px-3">
                            <p class="small text-muted mb-1">승</p>
                            <p class="mb-0" th:text="${entryInfo.wins}"></p>
                        </div>
                        <div>
                            <p class="small text-muted mb-1">패</p>
                            <p class="mb-0" th:text="${entryInfo.losses}"></p>
                        </div>
                    </div>
                </div>
            </div>
        </div>
    </div>
    <br>
    <div class="card" style="padding: 5px;">
        <table>
            <tbody style="border-radius: 15px;">
            <tr th:each="match, loop : ${playerRecords}" th:style="${match.participantDto.win} == false ? 'background: #FFD8D9; border-radius: 15px;'  : 'background: #D5E3FF; border-radius: 15px;' ">
                <td><img th:src="${match.participantDto.championImg}" class="img-fluid" style="width: 70px; border-radius: 15px; margin:10px"></td>
                <td th:text="${match.participantDto.win} ? '승리': '패배'"></td>
                <td th:text="${match.gameMode}"></td>
                <td th:text="${match.gameDuration}"></td>
                <td th:text="|${match.participantDto.kills} / ${match.participantDto.deaths} / ${match.participantDto.assists}|"></td>
            </tr>
            </tbody>
        </table>
    </div>
</div>
</html>

 

6. 참조

오픈 API 사용해서 데이터 가져오기 (네이버 영화 검색 API)

https://leveloper.tistory.com/24

[스프링] 오픈 api 사용해서 데이터 가져오기 (네이버 영화 검색 api)

 

이미지파싱

https://ondolroom.tistory.com/708

라이엇 api CDN

 

롤 전적 검색 사이트 예시1

https://onda2me.github.io/springboot/riot-api-of-lol1/

라이엇 게임즈의 오픈API를 이용한 롤 전적 검색 사이트 만들기 (1/2)

 

롤 전적 검색 사이트 예시2

https://velog.io/@y00913/%EB%A1%A4-%EC%A0%84%EC%A0%81-%EA%B2%80%EC%83%89-%EC%82%AC%EC%9D%B4%ED%8A%B8-%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8

롤 전적 검색 사이트 프로젝트

 

롤 API 정보 DB 에 저장하기(DB 캐싱)

https://pigstew.tistory.com/11

[fLOL] 01. 롤 API를 이용해 유저 정보 불러와 DB에 저장하기(1)

 

API 키 값 숨기기

https://wpioneer.tistory.com/223

[Spring Boot] properties 를 통해서 키 값 숨기기

 

CDN 이미지 파싱 & DB 캐싱

https://velog.io/@poding84/League-of-Legends-%EC%B1%94%ED%94%BC%EC%96%B8-%EB%8D%B0%EC%9D%B4%ED%84%B0-%EA%B0%80%EC%A0%B8%EC%98%A4%EA%B8%B0

League of Legends 챔피언 데이터 가져오기

 

롤 API 사용예시

https://iamiet.tistory.com/entry/%EB%A6%AC%EA%B7%B8%EC%98%A4%EB%B8%8C%EB%A0%88%EC%A0%84%EB%93%9C%EB%A1%A4-NoobGG-Riot-API-APIS-%EC%97%90-%EC%A1%B4%EC%9E%AC%ED%95%98%EB%8A%94-API%EB%93%A4-%ED%98%B8%EC%B6%9C%ED%95%B4%EB%B3%B4%EA%B8%B0-Update-%EC%A7%84%ED%96%89%EC%A4%91

Riot API - APIS 에 존재하는 API들 호출해보기

 

복잡한 api 역직렬화

https://jjingho.tistory.com/22

[Java] 역직렬화(Deserialize)