Java/Java
Java Papago 번역 API 사용
ysk(0soo)
2023. 1. 26. 20:48
Java를 이용한 Papago API 호출 예제이다.
Papago 번역 API는 일 허용량이 10,000 글자이다.
- 일일 호출양이 끝난 상태.
애플리케이션 등록
- 애플리케이션 등록
- 네이버 개발자 센터 상단 Application -> 애플리케이션 등록 -> 애플리케이션 등록 (API 이용신청) 페이지
- 애플리케이션 이름, 사용 API, 비로그인 오픈 API 서비스 환경 입력
2. 애플리케이션 등록 확인
- 네이버 개발자 센터 상단 Application -> 내 애플리케이션 -> 애플리케이션에 등록된 Papago 번역 애플리케이션 정보
- Client ID / Client Secret 확인
- API 요청 시 HTTP 요청 헤더에 필요.
Code
clientId, clientSecret 가 노출되지 않도록 properties 에 설정 하는 등 코드에 노출되지 않도록 한 후 사용해야 한다.
- ObjectMapper를 통해서 String 이 아닌 Object 상태로 리턴받을 수도 있다.
PapagoApiClient.java
public class PapagoApiClient {
private final PapagoProperties properties;
private final ObjectMapper mapper;
public String translate(String text) {
Map<String, String> requestHeaders = new HashMap<>();
requestHeaders.put("X-Naver-Client-Id", properties.getClientId());
requestHeaders.put("X-Naver-Client-Secret", properties.getClientSecret());
String response = post(properties.getUrl(), requestHeaders, encodeText(text, "UTF-8"));
ApiResponse apiResponse = mapper.readValue(response, ApiResponse.class);
return apiResponse.getTransaltedText();
}
private String encodeText(String text, String charset) {
try {
return URLEncoder.encode(text, charset);
} catch (UnsupportedEncodingException e) {
throw new RuntimeException("인코딩 실패", e);
}
}
private static String post(String apiUrl, Map<String, String> requestHeaders, String text) {
HttpURLConnection con = connect(apiUrl);
String postParams = "source=ko&target=en&text=" + text; //원본언어: 한국어 (ko) -> 목적언어: 영어 (en)
try {
con.setRequestMethod("POST");
for (Map.Entry<String, String> header : requestHeaders.entrySet()) {
con.setRequestProperty(header.getKey(), header.getValue());
}
con.setDoOutput(true);
try (DataOutputStream wr = new DataOutputStream(con.getOutputStream())) {
wr.write(postParams.getBytes());
wr.flush();
}
int responseCode = con.getResponseCode();
if (responseCode == HttpURLConnection.HTTP_OK) { // 정상 응답
return readBody(con.getInputStream());
} else { // 에러 응답
return readBody(con.getErrorStream());
}
} catch (IOException e) {
throw new RuntimeException("API 요청과 응답 실패", e);
} finally {
con.disconnect();
}
}
private static HttpURLConnection connect(String apiUrl) {
try {
URL url = new URL(apiUrl);
return (HttpURLConnection)url.openConnection();
} catch (MalformedURLException e) {
throw new RuntimeException("API URL이 잘못되었습니다. : " + apiUrl, e);
} catch (IOException e) {
throw new RuntimeException("연결이 실패했습니다. : " + apiUrl, e);
}
}
private static String readBody(InputStream body) {
InputStreamReader streamReader = new InputStreamReader(body);
try (BufferedReader lineReader = new BufferedReader(streamReader)) {
StringBuilder responseBody = new StringBuilder();
String line;
while ((line = lineReader.readLine()) != null) {
responseBody.append(line);
}
return responseBody.toString();
} catch (IOException e) {
throw new RuntimeException("API 응답을 읽는데 실패했습니다.", e);
}
}
}PapagoProperties
@Getter
@ConstructorBinding
@ConfigurationProperties(prefix = "translator.papago")
public class PapagoProperties {
private String url;
private String clientId;
private String clientSecret;
}ApiResponse
@Getter
@JsonIgnoreProperties(ignoreUnknown = true)
public class ApiResponse {
private Message message;
public String getTranslatedText() {
return getMessage().getResult().getTranslatedText();
}
@Getter
@JsonIgnoreProperties(ignoreUnknown = true)
private static class Message {
private Result result;
}
@Getter
@JsonIgnoreProperties(ignoreUnknown = true)
private static class Result {
private String srcLangType;
private String tarLangType;
private String translatedText;
private String engineType;
private String pivot;
private String dict;
private String tarDict;
}
}@JsonIgnoreProperties
- 무시할 속성이나 속성 목록을 표시하는 데 사용
구글 번역 API 는 월 500,000자 까지 사용이 가능하지만, 이후에는 백만 자당 $20가 부과된다.