응답 처리
BodyHandlers와 상태 코드를 알아봅니다
응답 처리은(는) CoddyKit의 무료 Java Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Java Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Java Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
응답 처리하기
HTTP 클라이언트를 호출할 때마다 HttpResponse<T>가 반환됩니다. 제네릭 형식 T는 전달하는 BodyHandler가 결정합니다. 이 레슨에서는 사용할 수 있는 처리기와 상태 코드를 해석하는 방법을 살펴봅니다.
HttpResponse 프로그래밍 인터페이스
HttpResponse의 주요 메서드는 다음과 같습니다.
statusCode()— 정수 상태 코드입니다.body()—T형식으로 디코딩된 본문입니다.headers()— 응답 헤더입니다.uri()— 최종 URI입니다. 리디렉션 이후의 URI가 반환됩니다.version()— HTTP/1.1 또는 HTTP/2입니다.
BodyHandlers.ofString
가장 일반적인 처리기는 응답의 문자 집합을 사용해 본문을 String으로 디코딩하며, 문자 집합이 없으면 UTF-8을 기본값으로 사용합니다. 응답 형식은 HttpResponse<String>입니다.
import java.net.URI;
import java.net.http.*;
public class Main {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest req = HttpRequest.newBuilder()
.uri(URI.create("https://example.com")).build();
HttpResponse<String> res =
client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body().length());
}
}BodyHandlers.ofByteArray
이미지와 같은 이진 콘텐츠에는 ofByteArray()를 사용합니다. 본문 형식은 byte[]이 되며, 이를 디스크에 쓰거나 직접 디코딩할 수 있습니다.
public class Main {
public static void main(String[] args) {
// ofByteArray() yields HttpResponse<byte[]>
byte[] simulated = { 1, 2, 3, 4 };
System.out.println("Bytes received: " + simulated.length);
}
}BodyHandlers.ofFile
ofFile(path)은 응답을 디스크로 직접 스트리밍하고 HttpResponse<Path>를 제공합니다. 따라서 대용량 다운로드를 메모리에 버퍼링하지 않아도 됩니다.
import java.net.URI;
import java.net.http.*;
import java.nio.file.Path;
public class Main {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest req = HttpRequest.newBuilder()
.uri(URI.create("https://example.com/file.zip")).build();
HttpResponse<Path> res = client.send(req,
HttpResponse.BodyHandlers.ofFile(Path.of("out.zip")));
System.out.println("Saved to: " + res.body());
}
}BodyHandlers.discarding
상태와 헤더만 관심이 있을 때는 discarding()이 본문을 버리고 HttpResponse<Void>를 생성합니다. 버퍼링 비용을 줄일 수 있습니다.
성공 여부 확인하기
일반적으로 본문을 신뢰하기 전에 상태가 2xx 범위인지 확인하는 도우미를 사용합니다.
public class Main {
static boolean isSuccess(int code) {
return code >= 200 && code < 300;
}
public static void main(String[] args) {
System.out.println(isSuccess(204));
System.out.println(isSuccess(404));
}
}상태 범주에 따라 처리하기
첫 번째 숫자를 기준으로 성공, 리디렉션, 오류에 대한 로직을 분기합니다.
public class Main {
static String classify(int code) {
return switch (code / 100) {
case 2 -> "Success";
case 3 -> "Redirect";
case 4 -> "Client error";
case 5 -> "Server error";
default -> "Unknown";
};
}
public static void main(String[] args) {
System.out.println(classify(503));
System.out.println(classify(200));
}
}mapping으로 본문 매핑하기
BodyHandlers.mapping(upstream, fn)은 다른 처리기를 감싸고 그 결과를 변환합니다. 예를 들어 처리기 내부에서 문자열 본문을 정수 길이로 구문 분석할 수 있습니다.
특정 헤더 읽기
응답 헤더 값을 읽으려면 headers().firstValue(name)을 사용합니다. 이 메서드는 Optional<String>을 반환합니다. 반복되는 헤더의 모든 값은 allValues(name)을 사용해 읽습니다.
import java.util.Optional;
public class Main {
public static void main(String[] args) {
Optional<String> len = Optional.of("1024");
int contentLength = len.map(Integer::parseInt).orElse(0);
System.out.println("Content-Length: " + contentLength);
}
}처리기 선택하기
- ofString — 텍스트 및 JSON API입니다.
- ofByteArray — 메모리에 보관하는 작은 이진 데이터입니다.
- ofFile — 디스크로 스트리밍하는 대용량 다운로드입니다.
- ofInputStream — 본문을 스트림으로 처리합니다.
- discarding — 상태만 확인하는 요청입니다.
빠른 확인
응답 처리를 얼마나 이해했는지 확인해 보세요.
복습
HTTP 응답을 해석하는 방법을 배웠습니다:
- HttpResponse는
statusCode(),body(),headers()를 제공합니다. - BodyHandler는 본문 유형을 결정합니다. 유형에는 String, 바이트 배열, 경로, 무효 값 또는 스트림이 있습니다.
- 대용량 다운로드에는
ofFile을 사용하여 메모리 부담을 피하세요. - 상태 코드는 첫 번째 숫자로 분류하고, 성공 여부는 2xx 범위에서 확인하세요.
firstValue/allValues를 사용하여 헤더를 읽으세요.
자주 묻는 질문
“응답 처리” 강의는 무료인가요?
네 — “응답 처리” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Java Academy 강의 전체를 잠금 해제할 수 있습니다. Java Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“응답 처리”에서 뭘 배우나요?
BodyHandlers와 상태 코드를 알아봅니다 브라우저에서 직접 실행하는 실습 코드로 Java Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Java Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Java Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“응답 처리” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Java Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Java Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.