Apache HttpComponents 파일전송 예제

최근에 Http 를 이용해서 간단히 파일전송이랑 이것저것 구현해야 되는 프로젝트를 했다. 

요런것들을 구현할때 딱 좋은 것들 중 하나는 Apache HttpComponents 이다.

라이브러리 같은거는 최신버전을 쓰고 싶다는 이상 야릇한 고집같은게 있어서 최신버전이 뭔가~ 하고 간만에 Apache HttpComponents 프로젝트 사이트에 가 보았다.

가보니 최신버전이 4.3.2 였다.

4.3.2 버전을 maven dependency 에 추가하고 예전에 썼던 글(Apache HttpComponents를 이용한 GET, POST 요청하기)을 참고해서 클래스를 하나 맹글었다.

그런데 라이브러리가 이것저것 변경이 많이 됐는지 deprecate 된 메소드가 무지 많은것 같이 느껴졌다.

그래서 사이트에서 제공하는 예제를 바탕으로 아예 4.3.2 에 맞게 클래스를 새로 하나 맹글었다.

먼저 maven 사용하는 사람들은 요런 디펜던시를 추가해 주고

<dependency>
	<groupId>org.apache.httpcomponents</groupId>
	<artifactId>httpclient</artifactId>
	<version>4.3.2</version>
</dependency>

<dependency>
	<groupId>org.apache.httpcomponents</groupId>
	<artifactId>httpmime</artifactId>
	<version>4.3.2</version>
</dependency>

기냥 쌩으로 하는 사람들은 httpclient-4.3.2.jar, httpcore-4.3.1.jar, httpmime-4.3.2.jar 를 클래스패스에 추가해 주면 된다.

Apache HttpComponents 4.3.2 를 이용한 HTTP 파일전송하기 샘플

package com.tistory.stove99;

import java.io.BufferedReader;
import java.io.File;
import java.io.InputStreamReader;
import java.net.URLEncoder;
import java.nio.charset.Charset;
import java.util.Map;

import org.apache.http.HttpEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.mime.MultipartEntityBuilder;
import org.apache.http.entity.mime.content.FileBody;
import org.apache.http.entity.mime.content.StringBody;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;

public class Http {
	private static final String DEFAULT_ENCODING = "UTF-8";
	
	private String url;
	private MultipartEntityBuilder params;
	
	/**
	 * @param url 접속할 url
	 */
	public Http(String url){
		this.url = url;
		
		params = MultipartEntityBuilder.create();
	}
	
	/**
	 * Map 으로 한꺼번에 파라메터 훅 추가하는 메소드
	 * @param param 파라메터들이 담긴 맵, 파라메터들은 UTF-8로 인코딩 됨
	 * @return
	 */
	public Http addParam(Map<String, Object> param){
		return addParam(param, DEFAULT_ENCODING);
	}
	
	/**
	 * Map 으로 한꺼번에 파라메터 훅 추가하는 메소드
	 * @param param 파라메터들이 담긴 맵
	 * @param encoding 파라메터 encoding charset
	 * @return
	 */
	public Http addParam(Map<String, Object> param, String encoding){
		for( Map.Entry<String, Object> e : param.entrySet() ){
			if (e.getValue() instanceof File) {
				addParam(e.getKey(), (File)e.getValue(), encoding);
			}else{
				addParam(e.getKey(), (String)e.getValue(), encoding);
			}
		}
		return this;
	}
	
	/**
	 * 문자열 파라메터를 추가한다.
	 * @param name 추가할 파라메터 이름
	 * @param value 파라메터 값
	 * @return
	 */
	public Http addParam(String name, String value){
		return addParam(name, value, DEFAULT_ENCODING);
	}
	
	public Http addParam(String name, String value, String encoding){
		params.addPart(name, new StringBody(value, ContentType.create("text/plain", encoding)));
		
		return this;
	}
	
	/**
	 * 업로드할 파일 파라메터를 추가한다.
	 * @param name
	 * @param file
	 * @return
	 */
	public Http addParam(String name, File file){
		return addParam(name, file, DEFAULT_ENCODING);
	}
	
	public Http addParam(String name, File file, String encoding){
		if( file.exists() ){
			try{
				params.addPart(
						name, 
						new FileBody(file, ContentType.create("application/octet-stream"),
						URLEncoder.encode(file.getName(), encoding)));
			}catch( Exception ex ){ ex.printStackTrace(); }
			
		}
		
		return this;
	}

	/**
	 * 타겟 URL 로 POST 요청을 보낸다.
	 * @return 요청결과
	 * @throws Exception
	 */
	public String submit() throws Exception{
		CloseableHttpClient http = HttpClients.createDefault();
		StringBuffer result = new StringBuffer();
		
		try{
			HttpPost post = new HttpPost(url);
			post.setEntity(params.build());
			
			CloseableHttpResponse response = http.execute(post);
			
			try{
				HttpEntity res = response.getEntity();
				BufferedReader br = new BufferedReader(
									new InputStreamReader(res.getContent(), Charset.forName("UTF-8")));
				
				String buffer = null;
				while( (buffer=br.readLine())!=null ){
					result.append(buffer).append("\r\n");
				}
			}finally{
				response.close();
			}
		}finally{
			http.close();
		}

		return result.toString();
	}
	
	
	/**
	 * 테스트
	 * @param args
	 * @throws Exception
	 */
	public static void main(String[] args) throws Exception {
		Http http = new Http("http://127.0.0.1:8888/receiver.jsp");
		
		http.addParam("test", "문자열 파라메터 테스트다!")
			.addParam("upload_file1", new File("d:\\첨부파일1.hwp"))
			.addParam("upload_file2", new File("d:\\첨부파일2.jpg"))
			.submit();
	}
}

Spring @MVC 로 receiver 쪽을 대충 요렇게 구현하면 될것 같다.

	@RequestMapping
	public void receiver(
			@RequestParam("upload_file1") MultipartFile file1, 
			@RequestParam("upload_file2") MultipartFile file2){
		System.out.println("upload_file1 : " + file1.getOriginalFilename());
		System.out.println("upload_file2 : " + file1.getOriginalFilename());
		
		File upDir = new File("c:\\upfile\\");
		try {
			file1.transferTo(new File(upDir, file1.getOriginalFilename()));
		} catch (IllegalStateException e) {
			e.printStackTrace();
		} catch (IOException e) {
			e.printStackTrace();
		}
	}