🚨 RIOT API를 이용해서 롤 전적 검색 사이트 만들기 (2) - RIOT API 파싱하기

이번 포스트는 프로젝트 첫번째 이슈 Riot API 승인 및 파싱에서 두번째 항목, Riot API 파싱하기다. 나는 개발부분이 아닌과정 중 미리 준비해야하는 부분을 Preparations로 구분하고있다.

---

유명한 리그오브레전드 전적 사이트를 클론코딩하여 프로젝트를 진행해보기로 했다. 혼자서 진행하는만큼 1차적인 목표는 간단히 아래와 같은 과정을 거치기로 했다.

• ✔️ Riot API를 인증
• 🔛 Jackson을 이용해서 Riot API 데이터 파싱
• AWS RDS로 DB 설계 및 구축
• Spring Boot를 이용해서 MVC 구조 만들기 (with mybatis)
• Vue를 이용해서 프론트를 구축
• EC2로 배포

🚨 RESTFUL Project 🚨 ⇢ RIOT API + Spring Boot + AWS EC2 & RDS

---

채택한 파싱 방법

나는 Spring Boot를 이용해서 프로젝트를 진행중이다. 마침 이 프레임워크에는 Jackson 이라는 훌륭한 라이브러리가 존재한다. Jackson은 java를 json으로 json을 java로 바꿔주는 역할을 한다. 따라서 Riot으로부터 얻어온 json을 자바 DTO에 대입시켜주는 방식을 채택했다.

라이엇으로부터 json 데이터 가져오기

앞서 API키를 인증해서 받았다면 더욱 좋지만, 굳이 받지 않았어도 DEVELOPMENT API KEY를 이용해서 임시적으로 파싱하거나 라이엇 API에서 테스트 할수있다.

예를 들어, 소환사 정보를 담고있는 json 데이터를 라이엇 API에서 테스트해보자. SUMMONER이라는 API가 소환사 정보를 가지고있다. 탭을 눌러서 보게되면, 다음과같이 4가지 방법이 나온다.

오른쪽 파란색 글씨를 자세히보면 4가지 모두 summoner를 가져올수있다. 다만 모두 방법이 다른데, 그중 소환사 이름으로 검색하는 2번째 탭을 선택했다. 클릭하게되면 DTO부터 방법까지 굉장히 자세히 소개해주고있다. 테스트하기위해서는 단순히 소환사명을 적고 DEVELOPMENT API KEY를 통해 요청(REQUEST)를 보내게되면 결과가 나온다.

나는 갓 페이커성님에 대한 정보를 요청해보았다. 요청을 하면 REQUEST URL부터 시작해서 RESPONSE BODY까지 정보들이 쭉나온다. 이때 눈여겨 봐야할부분은 세가지다.

1. REQUEST URL
   : GET방식으로 데이터를 얻을 수 있는 URL로 나중에 직접 파싱할 때 어떤 데이터를 우리가 넣어줘야하는지 확인할 수있다. 여기서는 소환사명과 API_KEY가 필요했다. 참고로 API_KEY는 항상 필요하다.

2. RESPONSE CODE
   : 상태코드는 당연히 기본중에 기본이다. 라이엇 DOCS에서도 상태코드를 자세히 설명해주고있다. 실제로 파싱하다가 여러번 오류가 났었는데, 여기를 참고해서 금방 빠져나올 수 있었다.

3. RESPONSE BODY
   : 마지막으로, 데이터가 담긴 응답 결과다. 이런 데이터들로 여러 API를 파싱해서 서로간의 관계를 파악해서 데이터를 활용하는것이 중요하다.

여기까지는 테스트였고, Apache에서 제공하고 있는 HttpClient 라이브러리를 이용해서 받아왔다. 먼저 정보가 들어갈 객체를위해 DTO(Data Transfer Object)를 만들어 줬다. 앞서 테스트를 진행해본사람이라면 알있겠지만, 라이엇에서 DTO정보도 친절하게 알려주고있다.

클래스명까지 제안해주는 갓..

나는 MVC구조를 활용할것이기 때문에, 적절한 패키지에 생성해두었다. 그리고 Key담고있는 Static 변수를 하나 만들고, API_KEY를 담아놨다. 그런데 이때 깃에올린다면 gitignore를 해줘야한다는점을 잊지말자.

// 공백 처리
String SummonerName = name.replaceAll(" ", "%20");		
String requestURL = "https://kr.api.riotgames.com/lol/summoner/v4/summoners/by-name/"+ SummonerName + "?api_key=" + Key.API_KEY;
		
try {
	HttpClient client = HttpClientBuilder.create().build(); // HttpClient 생성
	HttpGet getRequest = new HttpGet(requestURL); //GET 메소드 URL 생성
	HttpResponse response = client.execute(getRequest);
	
	//Response 출력
	if (response.getStatusLine().getStatusCode() == 200) {
		ResponseHandler<String> handler = new BasicResponseHandler();
		String body = handler.handleResponse(response);
        
        }
        ...

이런식으로 json 데이터를 response body에 담았다. 처음 postman으로 테스트를 하는데 자꾸 데이터가 안넘어와서 고생했다. 문득 라이엇 API에서 테스트할때 공백처리가 %20으로 되어있었다는것을 봤던지라 해결할 수 있었다.

name은 controller로부터 @Pathvariable 파라미터로 넘어오는 소환사명이다. 이후는 HttpClient를 통해서 response를 받아내고있다. 다만 상태코드가 200일때와 그 이외일때는 구분해서 예외처리를 해주었다.

Jackson을 이용해서 json response를 java로 바꾸기

위에서 구한 Response body를 출력해보면 굉장히 긴 json형식의 문자열이 출력된다. Jackson을 이용하면 아주 간편하게 java 객체로 바꿀 수 있다.

ObjectMapper objectMapper = new ObjectMapper();
Summoner summoner = null;	// DTO

// 공백 처리
String SummonerName = name.replaceAll(" ", "%20");
String requestURL = "https://kr.api.riotgames.com/lol/summoner/v4/summoners/by-name/"+ SummonerName + "?api_key=" + Key.API_KEY;
		
try {
	HttpClient client = HttpClientBuilder.create().build(); // HttpClient 생성
	HttpGet getRequest = new HttpGet(requestURL); //GET 메소드 URL 생성
	HttpResponse response = client.execute(getRequest);
	
	//Response 출력
	if (response.getStatusLine().getStatusCode() == 200) {
		ResponseHandler<String> handler = new BasicResponseHandler();
		String body = handler.handleResponse(response);
        	summoner = objectMapper.readValue(body, Summoner.class);   // String to Object로 변환
        
        }
        ...

위에서 나온 코드와 비교해서 3줄만 바뀌였는데, json형태의 String을 DTO 객체로 바꿀 수 있다.

내가 파싱한 데이터

라이엇 API에서 테스트하면서 느끼셨겠지만, 어떤데이터들이 있는지 직접 확인이 가능하다. 나도 삽질(?)을 해가며 나름 선정을 해봤다. '앞으로 프로젝트를 진행하는데 필요할수도 있겠다'라는 생각이 들면 일단 파싱을 해왔던 것같다.

1. Summoner                : 소환사 정보
2. Spectator                  : 소환사 현재 게임 정보
3. MatchList                  : 소환사 전적 리스트
4. Champion                 : 챔피언 로테이션 정보
5. Champion-mastery : 소환사마다 챔피언 숙련도 정보

한번 생각해봐야 했던 것

내가 채택한 파싱 방법은 response body 내용 모든것을 하나의 문자열에 저장하기 때문에 List에 담아야하는 것들은 정규화작업이 필요했다. 처음에는 다른 파싱 방법을 찾아봤었는데, 생각해보니 문자열 처리를 해주면되는 부분이었다. 알고리즘 문제를 문제로만 푸니, 이런 간단한 방법조차 돌아가려했던 내 모습을 보았다. 한번 생각해봐야 했던 것이라고 소제목을 지었지만, 두번세번네번다섯번생각하자ㅡㅡ

REF

• 라이엇 API
• 라이엇 DOCS
• HttpClient