[Java] RestTemplate vs. Apache HttpClient

들어가기 전

스프링기반 웹 어플리케이션을 이용하여 개발 할 때, 외부의 Http 기반의 API를 호출하게 될 경우, Spring RestTemplate 를 사용한다. 최근, Http 요청과 관련된 모듈을 개발하면서 둘의 차이점에 대해서 정리하고자 한다.

 

두 클래스의 경우, 외부 통신을 위해 사용되는 공통점을 가지나, RestTemplate 는 상위 레벨에서 추상화 되어 있는 반면, HttpClient 는 저수준의 형태로 사용자가 여러가지 설정을 해줘야 한다.

Http 통신을 위한 방법

URLConnection

URLConnection 은 URL이 가리키는 리소스에 대한 연결을 나타내는 추상 클래스이다. java.net 패키지에 있으며, URL 주소에, Get, Post로 데이터를 전달 할 수 있다. 하지만, 응답 코드가 4xx, 5xx 면 IOException이 발생, 타임아웃 설정 불가, 쿠키 제어가 불가 하다.

import java.net.*;
import java.io.*;

public class URLConnectionReader {
    public static void main(String[] args) throws Exception {
        URL oracle = new URL("http://www.oracle.com/");
        URLConnection yc = oracle.openConnection();
        BufferedReader in = new BufferedReader(new InputStreamReader(
                                    yc.getInputStream()));
        String inputLine;
        while ((inputLine = in.readLine()) != null) 
            System.out.println(inputLine);
        in.close();
    }
}

출처 : https://docs.oracle.com/javase/tutorial/networking/urls/readingWriting.html

HttpClient

3.x의경우 apache commons 의 프로젝트, 4.x 부터 Apache HttpComponents로 불린다. 4.x는3.x 버전에서 개선되었으며 둘간의직접적인호환성은 제공하지 않으며, 4.x 부터는쓰레드 안정성기능을 많이제공 한다. URLConnection과 비교하면, 모든 응답 코드를 읽을 수 있고 ,타임아웃 설정, 쿠키 제어가 가능하다. 하지만, 반복적인 코드가 길며, json 또는 xml 과 같은 컨텐츠 타입에 따라 별도 메시지 컨버팅이 필요 하다.

/** HttpClient 3.x **/
HttpClient httpclient = new HttpClient();
  GetMethod httpget = new GetMethod("http://www.myhost.com/");
  try {
    httpclient.executeMethod(httpget);
    Reader reader = new InputStreamReader(
            httpget.getResponseBodyAsStream(), httpget.getResponseCharSet()); 
    // consume the response entity
  } finally {
    httpget.releaseConnection();
  }
출처 : http://hc.apache.org/httpclient-3.x/performance.html

/** HttpComponent 4.x **/
 CloseableHttpClient httpclient = HttpClients.createDefault();
        try {
            HttpGet httpget = new HttpGet("http://localhost/");

            System.out.println("Executing request " + httpget.getRequestLine());

            // Create a custom response handler
            ResponseHandler<String> responseHandler = new ResponseHandler<String>() {

                public String handleResponse(
                        final HttpResponse response) throws ClientProtocolException, IOException {
                    int status = response.getStatusLine().getStatusCode();
                    if (status >= 200 && status < 300) {
                        HttpEntity entity = response.getEntity();
                        return entity != null ? EntityUtils.toString(entity) : null;
                    } else {
                        throw new ClientProtocolException("Unexpected response status: " + status);
                    }
                }

            };
            String responseBody = httpclient.execute(httpget, responseHandler);
            System.out.println("----------------------------------------");
            System.out.println(responseBody);
        } finally {
            httpclient.close();
        }
출처 : https://hc.apache.org/httpcomponents-client-ga/httpclient/examples/org/apache/http/examples/client/ClientWithResponseHandler.java

 

RestTemplate

HttpClient는 Http를 사용하여 통신하는 범용 라이브러리이지만, 사용을 위한 중복 코드 또는 설정 코드들이 많아진다. 스프링에서는여느 template과마찬가지로 보일러플레이트 코드를최대한줄여주며, 이에 반해, RestTemplate는 HttpClient를 추상화하였으며, 자동으로 json, xml을 컨버팅 하는 기능도 제공한다.

String result = restTemplate.getForObject("http://example.com/hotels/{hotel}/bookings/{booking}", String.class, "42", "21");

Map<String, String> vars = new HashMap<String, String>();
vars.put("hotel", "42");
vars.put("booking", "21");
String result = restTemplate.getForObject("http://example.com/hotels/{hotel}/bookings/{booking}", String.class, vars);

 

So..??

httpclient와restemplate 의 속도차이는 크게 나지 않으며, reste template 의경우 사용자입장에서 불필요한 코드의양을 줄일수있다. 그리고 Spring 에서 DI를이용하여 쉽게사용할수있는장점이 있다. 물론, Rest Template도 내부적으로 httpclient 를사용하지만, 결국에는 불필요한 코드를 줄이고 쉽게 사용할 수 있는차이점인것 같다.

References

• https://sjh836.tistory.com/141

RestTemplate (정의, 특징, URLConnection, HttpClient, 동작원리, 사용법, connection pool 적용)

• https://vnthf.github.io/blog/Java-RestTemplate%EC%97%90-%EA%B4%80%ED%95%98%EC%97%AC/

[java] Spring RestTemplate