공공API의 text json응답형식을 application json으로 변환하고 싶습니다.

Question

저는 현재 국립중앙도서관의 공공API를 신청하여 데이터를 받을 것입니다.

검색어에 대한 json응답을 받아서 보여주고 싶은 것입니다.

그런데 이러한 메세지가 나옵니다.

ERROR 4456 --- [nio-8080-exec-8] o.a.c.c.C.[.[.[/].[dispatcherServlet]    : Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed; nested exception is org.springframework.web.client.UnknownContentTypeException: Could not extract response: no suitable HttpMessageConverter found for response type [class com.gyull.board.domain.api.publicLib.SeojiResDto] and content type [text/json;charset=UTF-8]] with root cause

org.springframework.web.client.UnknownContentTypeException: Could not extract response: no suitable HttpMessageConverter found for 
response type [class com.gyull.board.domain.api.publicLib.SeojiResDto] and content type [text/json;charset=UTF-8]

보시면 응답을 text json으로 내려주고 있습니다.

application json으로 와야 하는데, header에 contentType을 application_json으로 넣어서 줘도 오류가 똑같습니다.

그렇다면 내가 객체 필드명을 다르게 준 것일까 생각해서 살펴봤습니다.

API에 대한 설명 페이지에서는 응답 파라미터가 스네이크 케이스로 되어 있지만

정작 응답을 받아보면 카멜 케이스로 나옵니다.

자바단에서는 오류가 나는지라, 해당 응답은 uriComponentBuilder로 만들어진 url을 브라우저에 붙여넣기하여 얻었습니다.

아무튼 DTO를 이에 맞춰서 만들었겠지요. pageNum과 pageSize는 필수 파라미터입니다.

클라이언트 단에서 객체에 1과 10을 기본 세팅해줍니다.

package com.gyull.board.domain.api.publicLib;

import java.util.List;
import com.fasterxml.jackson.annotation.JsonProperty;

import lombok.Getter;
import lombok.Setter;
import lombok.ToString;

@ToString
@Getter
@Setter
public class SeojiResDto {

  @JsonProperty("category")
  private String category;

  @JsonProperty("kwd")
  private String kwd;

  @JsonProperty("pageNum")
  private Integer pageNum;

  @JsonProperty("pageSize")
  private Integer pageSize;

  @JsonProperty("result")
  private List bookInfo;

  @JsonProperty("sort")
  private String sort;

  @JsonProperty("total")
  private Integer total;

}

package com.gyull.board.domain.api.publicLib;

import lombok.ToString;

import com.fasterxml.jackson.annotation.JsonProperty;

import lombok.Getter;
import lombok.Setter;

@Getter
@Setter
@ToString
public class BookInfo {

    @JsonProperty("titleInfo")
    private String titleInfo;

    @JsonProperty("typeName")
    private String typeName;

    @JsonProperty("placeInfo")
    private String placeInfo;

    @JsonProperty("authorInfo")
    private String authorInfo;

    @JsonProperty("pubInfo")
    private String pubInfo;

    @JsonProperty("menuName")
    private String menuName;

    @JsonProperty("mediaName")
    private String mediaName;

    @JsonProperty("manageName")
    private String manageName;

    @JsonProperty("pubYearInfo")
    private String pubYearInfo;

    @JsonProperty("controlNo")
    private String controlNo;

    @JsonProperty("docYn")
    private String docYn;

    @JsonProperty("orgLink")
    private String orgLink;

    @JsonProperty("id")
    private String id;

    @JsonProperty("placeCode")
    private String placeCode;

    @JsonProperty("typeCode")
    private String typeCode;

    @JsonProperty("licYn")
    private String licYn;

    @JsonProperty("licText")
    private String licText;

    @JsonProperty("regDate")
    private String regDate;

    @JsonProperty("imageUrl")
    private String imageUrl;

    @JsonProperty("detailLink")
    private String detailLink;

    @JsonProperty("isbn")
    private String isbn;

    @JsonProperty("callNo")
    private String callNo;

    @JsonProperty("kdcCode1s")
    private String kdcCode1s;

    @JsonProperty("kdcName1s")
    private String kdcName1s;

    @JsonProperty("classNo")
    private String classNo;

    @JsonProperty("typeOfRes")
    private String typeOfRes;
}

package com.gyull.board.controller.api.v1.external;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import com.gyull.board.domain.api.publicLib.SeojiDetailReqDto;
import com.gyull.board.service.api.publicLib.PublicBookService;

import lombok.RequiredArgsConstructor;

@RestController
@RequestMapping(value = "/api/publicLib")
@RequiredArgsConstructor
public class ApiPublicBookController {

  @Autowired
  PublicBookService publicBookService;

  @PostMapping("/search")
  public ResponseEntity search(SeojiDetailReqDto seojiDetailReqDto){
	  
	  return new ResponseEntity<>(publicBookService.search(seojiDetailReqDto), HttpStatus.OK);
	}
}

package com.gyull.board.service.api.publicLib;

import java.net.URI;
import java.nio.charset.StandardCharsets;
import java.util.Collections;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.http.HttpEntity;
import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpMethod;
import org.springframework.http.MediaType;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;
import org.springframework.web.util.UriComponentsBuilder;

import com.gyull.board.domain.api.publicLib.SeojiDetailReqDto;
import com.gyull.board.domain.api.publicLib.SeojiResDto;

@Service
public class PublicBookService {
    Logger logger = LoggerFactory.getLogger(PublicBookService.class);
    String key="키값";
    String searchUrl = "https://www.nl.go.kr/NL/search/openApi/search.do";
    String detailUrl = "https://www.nl.go.kr/NL/search/openApi/search.do?key="+key+"&detailSearch=true&isbnOp=isbn&isbnCode=8984993727";
    String searchIsbnUrl = "https://www.nl.go.kr/seoji/SearchApi.do";

    public SeojiResDto search(SeojiDetailReqDto seojiDetailReqDto){
      RestTemplate restTemplate = new RestTemplate();

      URI targetUrl = UriComponentsBuilder.fromUriString(searchUrl)
              .queryParam("key", key)
              .queryParam("apiType", "json")
              .queryParam("detailSearch", seojiDetailReqDto.getDetailSearch())
              .queryParam("page_num", seojiDetailReqDto.getPageNum())
              .queryParam("pageSize", seojiDetailReqDto.getPageSize())
              .queryParam("srchTarget", seojiDetailReqDto.getSrchTarget())
              .queryParam("kwd", seojiDetailReqDto.getKwd())
              .queryParam("f1", seojiDetailReqDto.getF1())
              .queryParam("f2", seojiDetailReqDto.getF2())
              .queryParam("f3", seojiDetailReqDto.getF3())
              .queryParam("f4", seojiDetailReqDto.getF4())
              .queryParam("v1", seojiDetailReqDto.getF1())
              .queryParam("v2", seojiDetailReqDto.getF2())
              .queryParam("v3", seojiDetailReqDto.getF3())
              .queryParam("v4", seojiDetailReqDto.getV4())
              .queryParam("isbnOp", seojiDetailReqDto.getIsbnOp())
              .queryParam("isbnCode", seojiDetailReqDto.getIsbnCode())
              .queryParam("category", seojiDetailReqDto.getCategory())
              .queryParam("order", seojiDetailReqDto.getOrder())
              .queryParam("sort", seojiDetailReqDto.getSort())
              .build()
              .encode(StandardCharsets.UTF_8)
              .toUri();

    return restTemplate.exchange(targetUrl, HttpMethod.GET, null, SeojiResDto.class).getBody();
  }
}

일단 제 눈에는 필드명이 다른 것 같지는 않습니다.

그러나 헤더에 콘텐츠타입을 지정해도 restTemplate의 MessageConverter는 변환할 수 없다는 오류를 뱉습니다.

어떻게 해야 application json으로 받을 수 있을까요?

カワウソ · Answer

https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/http/MediaType.html

스프링에서 기본적으로 제공하는 메시지 컨버터에서 처리하지 못하는 컨텐트 타입이므로 String 클래스 또는 스트림으로 응답 받으신 후 ObjectMapper 또는 Gson으로 DTO로 변환하거나 JSONObject로 변환하시면 됩니다. 또 한가지 방법은 text/json이라는 컨텐트 타입을 처리하는 메시지 컨버터를 구현하여 등록하시는 방법이겠죠. 해당 API와 같은 스펙이 많다면 후자가 적합할 지 모르는데 일부 케이스에 해당한다면 그냥 간단하게 처리하는 게 좋을때도 있습니다.

공공API의 text json응답형식을 application json으로 변환하고 싶습니다.

1개의 답변

Q&A 목록