🚀 OkHttp: 현대적이고 효율적인 HTTP 클라이언트 탐험하기 🌐

안녕하세요, 코딩 모험가 여러분! 오늘은 Java 개발자들의 필수 도구인 OkHttp에 대해 깊이 있게 알아보려고 해요. OkHttp는 Square사에서 개발한 강력한 HTTP 클라이언트 라이브러리로, 현대적인 웹 애플리케이션 개발에 없어서는 안 될 중요한 도구입니다. 🛠️

여러분, 혹시 재능넷(https://www.jaenung.net)이라는 재능 공유 플랫폼을 들어보셨나요? 이런 플랫폼들도 백엔드에서 다양한 API와 통신할 때 OkHttp 같은 라이브러리를 사용할 수 있답니다. 오늘 우리가 배울 내용이 바로 이런 실제 서비스에서 어떻게 활용될 수 있는지 상상해보면서 함께 공부해봐요! 😊

💡 알고 계셨나요? OkHttp는 안드로이드의 기본 HTTP 클라이언트로 채택될 만큼 신뢰성과 성능이 뛰어난 라이브러리입니다.

자, 이제 OkHttp의 세계로 깊이 들어가볼까요? 준비되셨나요? 그럼 출발~! 🚀

🌟 OkHttp란 무엇인가요?

OkHttp는 HTTP 프로토콜을 이용해 데이터를 주고받는 작업을 쉽고 효율적으로 할 수 있게 해주는 오픈소스 라이브러리예요. 여러분이 웹 브라우저에서 웹 페이지를 열 때마다 HTTP 요청이 일어나는 것처럼, 앱이나 서버에서도 다른 서버와 통신할 때 HTTP를 사용하죠.

OkHttp는 이런 HTTP 통신을 Java와 Kotlin 언어에서 아주 편리하게 할 수 있도록 도와줍니다.

🎨 비유로 이해하기: OkHttp를 우체부라고 생각해보세요. 여러분이 편지(HTTP 요청)를 쓰면, OkHttp 우체부가 그 편지를 목적지(서버)에 전달하고, 답장(HTTP 응답)을 가져다 줍니다. 그것도 아주 빠르고 안전하게요!

🌈 OkHttp의 주요 특징

연결 풀링: 같은 서버로 여러 요청을 보낼 때 연결을 재사용해서 효율성을 높여요.
GZIP 압축: 응답 데이터를 자동으로 압축해서 데이터 사용량을 줄여줍니다.
응답 캐싱: 반복되는 요청의 응답을 캐시해서 네트워크 사용을 최소화해요.
HTTP/2 지원: 최신 HTTP 프로토콜을 지원해서 더 빠른 통신이 가능해요.
실패한 요청 자동 재시도: 일시적인 문제로 실패한 요청을 알아서 다시 시도해줍니다.

이런 특징들 덕분에 OkHttp는 네트워크 통신을 더 빠르고, 안정적이고, 효율적으로 만들어줍니다. 마치 슈퍼 우체부가 여러분의 편지를 배달하는 것처럼요! 📮✨

이 그림을 보면 OkHttp가 마치 중심에 있는 강력한 엔진처럼 여러 가지 특징들을 가지고 있다는 것을 한눈에 알 수 있죠? 각각의 특징들이 OkHttp를 중심으로 뻗어나가는 모습이 마치 우리가 인터넷으로 전 세계와 연결되는 모습 같지 않나요? 😊

🤔 왜 OkHttp를 사용해야 할까요?

여러분이 재능넷 같은 플랫폼을 만든다고 상상해보세요. 사용자들의 프로필 정보를 가져오고, 메시지를 주고받고, 결제 정보를 처리하는 등 수많은 네트워크 요청이 필요할 거예요. 이때 OkHttp를 사용하면:

성능 향상: 연결 재사용과 응답 캐싱으로 앱이 더 빠르게 동작해요.
안정성 증가: 네트워크 문제에 대한 자동 재시도로 사용자 경험이 향상됩니다.
개발 시간 단축: 복잡한 네트워크 로직을 간단하게 처리할 수 있어요.
배터리 효율: 효율적인 네트워크 사용으로 모바일 기기의 배터리 소모를 줄일 수 있습니다.

💡 실제 사례: 재능넷에서 프리랜서와 클라이언트가 메시지를 주고받을 때, OkHttp를 사용하면 메시지 전송과 수신이 매우 빠르고 안정적으로 이루어질 수 있어요. 네트워크 상태가 좋지 않아도 OkHttp가 알아서 재시도를 해주니 사용자들은 끊김 없는 대화를 나눌 수 있겠죠?

OkHttp는 단순히 HTTP 클라이언트가 아니라, 현대적인 웹과 앱 개발의 필수 도구입니다. 이제 우리가 왜 OkHttp를 사용해야 하는지 조금은 이해가 되시나요? 😃

다음 섹션에서는 OkHttp를 실제로 어떻게 사용하는지 자세히 알아보도록 할게요. 코드 예제와 함께 step-by-step으로 설명해드릴 테니 걱정 마세요! 여러분도 곧 OkHttp 마스터가 될 수 있을 거예요. 준비되셨나요? 그럼 다음 모험으로 출발~! 🚀

🛠️ OkHttp 시작하기: 설치부터 첫 요청까지

자, 이제 OkHttp를 실제로 사용해볼 시간이에요! 마치 새로운 장난감을 받았을 때처럼 설레지 않나요? 😄 차근차근 따라와 주세요. 우리는 지금부터 OkHttp의 세계로 첫 발을 내딛을 거예요!

1. OkHttp 설치하기 📦

OkHttp를 사용하려면 먼저 프로젝트에 라이브러리를 추가해야 해요. Maven이나 Gradle 같은 빌드 도구를 사용한다면 아주 쉽게 할 수 있답니다.

Maven을 사용할 경우:


<dependency>
  <groupId>com.squareup.okhttp3</groupId>
  <artifactId>okhttp</artifactId>
  <version>4.10.0</version>
</dependency>

Gradle을 사용할 경우:


implementation("com.squareup.okhttp3:okhttp:4.10.0")

이렇게 하면 OkHttp가 여러분의 프로젝트에 추가됩니다. 마치 요리를 시작하기 전에 필요한 재료를 준비하는 것과 같죠!

2. OkHttpClient 인스턴스 생성하기 🏗️

OkHttp를 사용하기 위해서는 먼저 OkHttpClient의 인스턴스를 생성해야 해요. 이 클라이언트는 모든 HTTP 요청의 중심이 되는 객체입니다.


import okhttp3.OkHttpClient;

OkHttpClient client = new OkHttpClient();

이렇게 생성한 client 객체는 여러 요청에서 재사용할 수 있어요. 마치 우리가 택배를 보낼 때 항상 같은 우체국을 이용하는 것과 비슷하답니다! 🏤

3. 첫 번째 GET 요청 보내기 🚀

이제 우리의 첫 HTTP GET 요청을 보내볼 거예요. 예를 들어, 재능넷의 API에서 사용자 정보를 가져온다고 상상해봅시다.


import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import java.io.IOException;

OkHttpClient client = new OkHttpClient();

String url = "https://api.jaenung.net/users/123";  // 가상의 API 주소입니다

Request request = new Request.Builder()
    .url(url)
    .build();

try (Response response = client.newCall(request).execute()) {
    if (!response.isSuccessful()) throw new IOException("Unexpected code " + response);

    System.out.println(response.body().string());
} catch (IOException e) {
    e.printStackTrace();
}

이 코드가 하는 일을 단계별로 살펴볼까요?

Request 객체 생성: URL을 지정하고 GET 요청(기본값)을 만듭니다.
요청 실행: client.newCall(request).execute()로 요청을 보냅니다.
응답 처리: 응답이 성공적인지 확인하고, 성공하면 응답 본문을 출력합니다.

🎓 학습 포인트: try-with-resources 문을 사용해 Response 객체를 자동으로 닫아주고 있어요. 이는 자원 관리의 좋은 방법입니다!

4. POST 요청 보내기 📮

GET 요청을 마스터했으니, 이제 POST 요청을 보내볼까요? POST 요청은 서버에 데이터를 보낼 때 사용해요. 예를 들어, 재능넷에 새로운 프로젝트를 등록한다고 생각해봅시다.


import okhttp3.*;
import java.io.IOException;

OkHttpClient client = new OkHttpClient();

String url = "https://api.jaenung.net/projects";  // 가상의 API 주소입니다

String json = "{\"title\":\"웹 개발 프로젝트\",\"description\":\"OkHttp를 이용한 멋진 웹 앱 만들기\"}";

RequestBody body = RequestBody.create(json, MediaType.parse("application/json; charset=utf-8"));

Request request = new Request.Builder()
    .url(url)
    .post(body)
    .build();

try (Response response = client.newCall(request).execute()) {
    if (!response.isSuccessful()) throw new IOException("Unexpected code " + response);

    System.out.println(response.body().string());
} catch (IOException e) {
    e.printStackTrace();
}

이 코드에서 새로운 점은:

RequestBody 생성: JSON 형식의 데이터를 만들고, 이를 RequestBody 객체로 변환합니다.
POST 메소드 지정: .post(body)로 HTTP 메소드를 POST로 지정하고 요청 본문을 추가합니다.

POST 요청을 보낼 때는 항상 서버가 기대하는 형식(이 경우 JSON)으로 데이터를 보내야 해요. 그렇지 않으면 서버가 우리의 요청을 이해하지 못할 수 있답니다!

5. 헤더 추가하기 🎩

때로는 요청에 추가 정보를 포함해야 할 때가 있어요. 이럴 때 헤더를 사용합니다. 예를 들어, API 키를 포함하거나 인증 토큰을 전송할 때 사용할 수 있죠.


Request request = new Request.Builder()
    .url("https://api.jaenung.net/secure-endpoint")
    .header("Authorization", "Bearer YOUR_ACCESS_TOKEN")
    .build();

이렇게 하면 요청에 인증 정보를 포함할 수 있어요. 마치 VIP 패스를 가지고 있는 것처럼, 서버에 특별한 권한을 가지고 접근할 수 있게 되는 거죠!

6. 비동기 요청 🔄

지금까지는 동기 요청만 살펴봤어요. 하지만 실제 앱에서는 UI를 멈추지 않고 백그라운드에서 네트워크 요청을 처리하는 것이 중요합니다. OkHttp는 이를 위한 비동기 API를 제공해요.


Request request = new Request.Builder()
    .url("https://api.jaenung.net/long-running-job")
    .build();

client.newCall(request).enqueue(new Callback() {
    @Override
    public void onFailure(Call call, IOException e) {
        e.printStackTrace();
    }

    @Override
    public void onResponse(Call call, Response response) throws IOException {
        if (!response.isSuccessful()) throw new IOException("Unexpected code " + response);

        System.out.println(response.body().string());
    }
});

이 방식을 사용하면:

요청이 백그라운드 스레드에서 실행됩니다.
onFailure는 네트워크 오류 등으로 요청이 실패했을 때 호출됩니다.
onResponse는 서버로부터 응답을 받았을 때 호출됩니다.

⚠️ 주의: onResponse와 onFailure 콜백은 백그라운드 스레드에서 실행됩니다. UI를 업데이트하려면 메인 스레드로 전환해야 해요!

🎉 축하합니다! 여러분은 이제 OkHttp의 기본을 마스터했어요!

우리는 방금:

OkHttp를 프로젝트에 추가하는 방법
GET과 POST 요청을 보내는 방법
헤더를 추가하는 방법
비동기 요청을 하는 방법

을 배웠어요. 이것들은 OkHttp의 기본이지만, 실제 앱 개발에서 가장 많이 사용되는 기능들이랍니다. 마치 요리의 기본 테크닉을 배운 것과 같아요. 이제 여러분은 이 지식을 바탕으로 더 복잡하고 맛있는 '네트워크 요리'를 만들 수 있을 거예요! 🍳👨‍🍳

다음 섹션에서는 OkHttp의 더 고급 기능들을 살펴볼 거예요. 인터셉터, 쿠키 관리, 타임아웃 설정 등 실제 프로젝트에서 유용하게 사용할 수 있는 기능들이 기다리고 있답니다. 준비되셨나요? 그럼 고급 과정으로 넘어가볼까요? 🚀

🔬 OkHttp 고급 기능 탐험하기

여러분, 지금까지 OkHttp의 기본을 마스터하셨어요. 정말 대단해요! 🎉 이제 우리는 더 깊은 바다로 나아갈 준비가 되었습니다. OkHttp의 고급 기능들을 살펴보면서, 여러분의 네트워크 프로그래밍 스킬을 한 단계 더 업그레이드해볼까요?

1. 인터셉터 (Interceptors) 사용하기 🕵️‍♀️

인터셉터는 OkHttp의 강력한 기능 중 하나예요. 요청과 응답을 가로채서 수정하거나 로깅할 수 있게 해줍니다. 마치 우리가 보내는 모든 편지를 검사하고 필요하다면 수정할 수 있는 특별한 우체부를 고용하는 것과 같죠!


import okhttp3.Interceptor;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;

Interceptor loggingInterceptor = new Interceptor() {
    @Override
    public Response intercept(Chain chain) throws IOException {
        Request request = chain.request();
        
        long t1 = System.nanoTime();
        System.out.println(String.format("Sending request %s on %s%n%s",
                request.url(), chain.connection(), request.headers()));
        
        Response response = chain.proceed(request);
        
        long t2 = System.nanoTime();
        System.out.println(String.format("Received response for %s in %.1fms%n%s",
                response.request().url(), (t2 - t1) / 1e6d, response.headers()));
        
        return response;
    }
};

OkHttpClient client = new OkHttpClient.Builder()
    .addInterceptor(loggingInterceptor)
    .build();

이 인터셉터는 모든 요청과 응답의 세부 정보를 로그로 남깁니다. 디버깅할 때 정말 유용하죠!

💡 Pro Tip: 인터셉터를 사용해 모든 요청에 자동으로 인증 헤더를 추가하거나, 응답을 캐시하거나, 에러를 처리하는 등 다양한 작업을 할 수 있어요.

2. 쿠키 관리하기 🍪

웹 애플리케이션을 개발할 때 쿠키 관리는 중요한 부분이에요. OkHttp는 CookieJar 인터페이스를 통해 쿠키 관리를 쉽게 할 수 있게 해줍니다.


import okhttp3.Cookie;
import okhttp3.CookieJar;
import okhttp3.HttpUrl;
import okhttp3.OkHttpClient;

CookieJar cookieJar = new CookieJar() {
    private final HashMap<String, List<Cookie>> cookieStore = new HashMap<>();

    @Override
    public void saveFromResponse(HttpUrl url, List<Cookie> cookies) {
        cookieStore.put(url.host(), cookies);
    }

    @Override
    public List<Cookie> loadForRequest(HttpUrl url) {
        List<Cookie> cookies = cookieStore.get(url.host());
        return cookies != null ? cookies : new ArrayList<>();
    }
};

OkHttpClient client = new OkHttpClient.Builder()
    .cookieJar(cookieJar)
    .build();

이 코드는 간단한 인메모리 쿠키 저장소를 구현합니다. 실제 앱에서는 더 복잡한 구현이 필요할 수 있어요. 예를 들어, 쿠키를 디스크에 저장하거나 암호화할 수 있죠.

3. 타임아웃 설정하기 ⏱️

네트워크 요청은 때때로 예상보다 오래 걸릴 수 있어요. 이런 상황에 대비해 타임아웃을 설정하는 것이 중요합니다. OkHttp는 여러 종류의 타임아웃을 제공해요.


OkHttpClient client = new OkHttpClient.Builder()
    .connectTimeout(10, TimeUnit.SECONDS)
    .writeTimeout(10, TimeUnit.SECONDS)
    .readTimeout(30, TimeUnit.SECONDS)
    .build();

connectTimeout: 서버와의 연결을 설정하는 데 허용되는 최대 시간
writeTimeout: 데이터를 서버로 보내는 데 허용되는 최대 시간
readTimeout: 서버로부터 응답을 받는 데 허용되는 최대 시간

적절한 타임아웃 설정은 네트워크 문제로 인한 앱의 멈춤을 방지하고, 사용자 경험을 향상시킬 수 있어요.

4. 인증 처리하기 🔐

많은 API들이 인증을 요구합니다. OkHttp는 Authenticator 인터페이스를 통해 인증 로직을 쉽게 구현할 수 있게 해줘요.


import okhttp3.Authenticator;
import okhttp3.Request;
import okhttp3.Response;
import okhttp3.Route;

Authenticator authenticator = new Authenticator() {
    @Override
    public Request authenticate(Route route, Response response) throws IOException {
        if (responseCount(response) >= 3) {
            return null; // 최대 2번까지만 재시도
        }
        String credential = Credentials.basic("username", "password");
        return response.request().newBuilder()
                .header("Authorization", credential)
                .build();
    }

    private int responseCount(Response response) {
        int result = 1;
        while ((response = response.priorResponse()) != null) {
            result++;
        }
        return result;
    }
};

OkHttpClient client = new OkHttpClient.Builder()
    .authenticator(authenticator)
    .build();

이 예제는 Basic 인증을 구현하고 있어요. 실제 앱에서는 OAuth나 JWT 같은 더 복잡한 인증 방식을 사용할 수 있겠죠.

🔒 보안 주의사항: 실제 앱에서는 절대로 하드코딩된 인증 정보를 사용하지 마세요. 안전한 저장소나 키체인을 사용하세요!

5. 캐싱 구현하기 💾

캐싱은 앱의 성능을 크게 향상시킬 수 있어요. OkHttp는 내장 캐시 기능을 제공합니다.


import okhttp3.Cache;
import okhttp3.OkHttpClient;

int cacheSize = 10 * 1024 * 1024; // 10 MB
Cache cache = new Cache(new File(getApplicationContext().getCacheDir(), "http-cache"), cacheSize);

OkHttpClient client = new OkHttpClient.Builder()
    .cache(cache)
    .build();

이렇게 설정하면 OkHttp가 자동으로 응답을 캐시하고, 가능한 경우 캐시된 응답을 사용합니다. 서버의 캐시 제어 헤더를 존중하면서요.

6. 이벤트 리스너 사용하기 👂

때로는 HTTP 요청의 생명주기를 더 자세히 모니터링하고 싶을 수 있어요. EventListener를 사용하면 이것이 가능합니다.


import okhttp3.EventListener;
import okhttp3.OkHttpClient;

EventListener eventListener = new EventListener() {
    @Override
    public void callStart(Call call) {
        System.out.println("Call started: " + call.request().url());
    }

    @Override
    public void callEnd(Call call) {
        System.out.println("Call ended: " + call.request().url());
    }

    // 다른 이벤트 메소드들...
};

OkHttpClient client = new OkHttpClient.Builder()
    .eventListener(eventListener)
    .build();

이벤트 리스너를 사용하면 네트워크 요청의 각 단계를 추적할 수 있어요. 성능 분석이나 디버깅에 매우 유용하죠!

7. 멀티파트 요청 보내기 📁

파일 업로드와 같은 작업을 할 때는 멀티파트 요청을 사용해야 해요. OkHttp는 이를 쉽게 만들 수 있게 해줍니다.


import okhttp3.MediaType;
import okhttp3.MultipartBody;
import okhttp3.RequestBody;

RequestBody requestBody = new MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("title", "Square Logo")
    .addFormDataPart("image", "logo-square.png",
        RequestBody.create(new File("docs/images/logo-square.png"), MediaType.parse("image/png")))
    .build();

Request request = new Request.Builder()
    .url("https://api.example.com/upload")
    .post(requestBody)
    .build();

이 코드는 텍스트 필드와 파일을 함께 업로드하는 멀티파트 요청을 만듭니다.

🎓 마무리: OkHttp 마스터가 되는 길

우와! 우리는 방금 OkHttp의 고급 기능들을 탐험했어요. 이제 여러분은:

인터셉터를 사용해 요청과 응답을 수정하고 로깅하는 방법
쿠키를 관리하는 방법
다양한 타임아웃을 설정하는 방법
인증을 처리하는 방법
응답을 캐싱하는 방법
이벤트 리스너를 사용해 요청 생명주기를 모니터링하는 방법
멀티파트 요청을 보내는 방법

을 알게 되었습니다. 이 지식들을 활용하면, 여러분은 더 효율적이고, 안정적이며, 강력한 네트워크 기능을 가진 앱을 만들 수 있을 거예요.

💡 실전 팁: 이런 고급 기능들을 사용할 때는 항상 성능과 메모리 사용량을 고려해야 해요. 예를 들어, 로깅 인터셉터는 디버그 빌드에서만 사용하고, 프로덕션 빌드에서는 비활성화하는 것이 좋습니다.

OkHttp는 정말 강력한 도구지만, 그만큼 올바르게 사용하는 것이 중요해요. 여러분이 배운 이 기술들을 실제 프로젝트에 적용해보면서, 더 깊이 있는 이해를 얻길 바랍니다.

다음 단계로는 어떤 것들이 있을까요? Retrofit과 같은 OkHttp 기반의 라이브러리를 살펴보는 것도 좋고, 비동기 프로그래밍이나 리액티브 프로그래밍과 OkHttp를 결합하는 방법을 배우는 것도 좋을 거예요.

여러분의 OkHttp 마스터 여정을 응원합니다! 🚀 질문이 있다면 언제든 물어보세요. 함께 배우고 성장하는 것이 프로그래밍의 묘미니까요! 😊

🚀 OkHttp 실전 활용: 재능넷 API 연동하기

자, 이제 우리가 배운 OkHttp의 기본 및 고급 기능들을 실제 프로젝트에 적용해볼 시간이에요! 가상의 재능넷 API를 사용해 실제 앱에서 어떻게 OkHttp를 활용할 수 있는지 살펴보겠습니다. 😃

1. 재능넷 API 클라이언트 만들기 🏗️

먼저, 재능넷 API와 통신할 수 있는 클라이언트 클래스를 만들어볼게요.


import okhttp3.*;
import java.io.IOException;

public class JaenungNetClient {
    private final OkHttpClient client;
    private static final String BASE_URL = "https://api.jaenung.net/v1/";
    private static final String API_KEY = "YOUR_API_KEY";

    public JaenungNetClient() {
        client = new OkHttpClient.Builder()
            .addInterceptor(new ApiKeyInterceptor())
            .build();
    }

    private class ApiKeyInterceptor implements Interceptor {
        @Override
        public Response intercept(Chain chain) throws IOException {
            Request original = chain.request();
            Request request = original.newBuilder()
                .header("Authorization", "Bearer " + API_KEY)
                .method(original.method(), original.body())
                .build();
            return chain.proceed(request);
        }
    }

    // API 메소드들이 여기에 추가될 예정입니다.
}

이 클라이언트는 모든 요청에 자동으로 API 키를 추가하는 인터셉터를 사용합니다. 실제 앱에서는 API 키를 안전하게 저장하고 관리해야 해요!

2. 프로젝트 목록 가져오기 📋

재능넷의 프로젝트 목록을 가져오는 메소드를 구현해볼까요?


public class JaenungNetClient {
    // ... 이전 코드 ...

    public String getProjects() throws IOException {
        Request request = new Request.Builder()
            .url(BASE_URL + "projects")
            .build();

        try (Response response = client.newCall(request).execute()) {
            if (!response.isSuccessful()) throw new IOException("Unexpected code " + response);
            return response.body().string();
        }
    }
}

이 메소드는 프로젝트 목록을 JSON 문자열로 반환합니다. 실제 앱에서는 이를 파싱해서 객체로 변환할 거예요.

3. 새 프로젝트 등록하기 ✨

이번엔 새로운 프로젝트를 등록하는 메소드를 만들어볼게요.


import com.google.gson.Gson;

public class JaenungNetClient {
    // ... 이전 코드 ...

    private final Gson gson = new Gson();

    public String createProject(Project project) throws IOException {
        String json = gson.toJson(project);
        RequestBody body = RequestBody.create(json, MediaType.parse("application/json; charset=utf-8"));

        Request request = new Request.Builder()
            .url(BASE_URL + "projects")
            .post(body)
            .build();

        try (Response response = client.newCall(request).execute()) {
            if (!response.isSuccessful()) throw new IOException("Unexpected code " + response);
            return response.body().string();
        }
    }
}

class Project {
    String title;
    String description;
    // 생성자, getter, setter 등은 생략
}

여기서는 Gson 라이브러리를 사용해 Project 객체를 JSON으로 변환했어요. 실제 프로젝트에서는 선호하는 JSON 라이브러리를 사용하면 됩니다.

4. 비동기 요청 구현하기 🔄

지금까지는 동기 요청을 사용했지만, 실제 앱에서는 비동기 요청이 더 적합할 수 있어요. 프로젝트 목록을 비동기로 가져오는 메소드를 만들어볼까요?


public class JaenungNetClient {
    // ... 이전 코드 ...

    public void getProjectsAsync(Callback callback) {
        Request request = new Request.Builder()
            .url(BASE_URL + "projects")
            .build();

        client.newCall(request).enqueue(new Callback() {
            @Override
            public void onFailure(Call call, IOException e) {
                callback.onFailure(e);
            }

            @Override
            public void onResponse(Call call, Response response) throws IOException {
                if (!response.isSuccessful()) {
                    callback.onFailure(new IOException("Unexpected code " + response));
                } else {
                    callback.onSuccess(response.body().string());
                }
            }
        });
    }

    public interface Callback {
        void onSuccess(String result);
        void onFailure(Exception e);
    }
}

이 메소드는 콜백을 사용해 비동기적으로 결과를 반환합니다. 안드로이드 앱에서 사용한다면 UI 스레드에서 결과를 처리하도록 주의해야 해요!

5. 파일 업로드 구현하기 📤

재능넷에 포트폴리오 이미지를 업로드하는 기능을 추가해볼까요?


import java.io.File;

public class JaenungNetClient {
    // ... 이전 코드 ...

    public String uploadPortfolio(String projectId, File image) throws IOException {
        RequestBody requestBody = new MultipartBody.Builder()
            .setType(MultipartBody.FORM)
            .addFormDataPart("project_id", projectId)
            .addFormDataPart("image", image.getName(),
                RequestBody.create(image, MediaType.parse("image/*")))
            .build();

        Request request = new Request.Builder()
            .url(BASE_URL + "portfolio/upload")
            .post(requestBody)
            .build();

        try (Response response = client.newCall(request).execute()) {
            if (!response.isSuccessful()) throw new IOException("Unexpected code " + response);
            return response.body().string();
        }
    }
}

이 메소드는 멀티파트 요청을 사용해 이미지 파일을 업로드합니다. 실제 앱에서는 대용량 파일 업로드 시 진행 상황을 모니터링하는 기능을 추가하면 좋겠죠?

6. 에러 처리 개선하기 🛠️

지금까지는 간단한 에러 처리만 했지만, 실제 앱에서는 더 세밀한 에러 처리가 필요해요. API 응답에 따른 커스텀 예외를 만들어볼까요?


public class JaenungNetClient {
    // ... 이전 코드 ...

    private void handleApiError(Response response) throws IOException, ApiException {
        if (!response.isSuccessful()) {
            if (response.code() == 401) {
                throw new ApiException.AuthenticationException();
            } else if (response.code() == 403) {
                throw new ApiException.ForbiddenException();
            } else if (response.code() == 404) {
                throw new ApiException.NotFoundException();
            } else {
                throw new ApiException("API call failed with code " + response.code());
            }
        }
    }

    // 이 메소드를 모든 API 호출 후에 사용
    public String getProjects() throws IOException, ApiException {
        Request request = new Request.Builder()
            .url(BASE_URL + "projects")
            .build();

        try (Response response = client.newCall(request).execute()) {
            handleApiError(response);
            return response.body().string();
        }
    }
}

class ApiException extends Exception {
    public ApiException(String message) {
        super(message);
    }

    public static class AuthenticationException extends ApiException {
        public AuthenticationException() {
            super("Authentication failed");
        }
    }

    public static class ForbiddenException extends ApiException {
        public ForbiddenException() {
            super("Access forbidden");
        }
    }

    public static class NotFoundException extends ApiException {
        public NotFoundException() {
            super("Resource not found");
        }
    }
}

이렇게 하면 API 오류에 대해 더 세밀하게 대응할 수 있어요. 각 예외 유형에 따라 다른 처리를 할 수 있겠죠?