개요

🌐 언리얼 엔진에서 Http 요청으로 통신해보자.

백엔드 서버를 구축하여 API 통신을 할 수 있는 프로젝트를 해보고 싶어졌습니다.

그래서 언리얼 엔진에서 Http 요청을 보내고 값을 받아
JSON을 처리할 수 있는 방법을 시리즈로 정리해보려고 합니다.

참고 영상

본론

의존성 추가

프로젝트명.Build.cs 파일을 열어주세요.

그리고 아래에 Http, Json의 의존성 코드를 추가해주겠습니다.

public class API_Test_Project : ModuleRules
{
	public API_Test_Project(ReadOnlyTargetRules Target) : base(Target)
	{
		PCHUsage = PCHUsageMode.UseExplicitOrSharedPCHs;
	
		PublicDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject", "Engine", "InputCore","UMG" });

		// 추가
		PrivateDependencyModuleNames.AddRange(new string[] { "HTTP", "Json" });

	}
}

---

GameMode 생성

C++ 클래스 생성

C++로 게임 모드를 하나 만들어 주겠습니다.

GameModeBase 선택하시고 이름은 적당히 지어 주세요.

헤더 파일 작성

우선 헤더를 추가해주겠습니다.
일단 Http.h 하나만 추가해주세요.

FHttpMoudle

그리고 변수하나를 추가하겠습니다.

해당 변수는 HTTP 요청을 관리하는 FHttpModule로 HTTP 요청을 생성, 관리가 가능합니다.

public:

	FHttpModule* Http;

};

OnResponseReceived

이번엔 HTTP 요청의 응답을 처리하는 콜백 함수를 선언해주겠습니다.

public:

	void OnResponseReceived(FHttpRequestPtr Request, FHttpResponsePtr Response, bool bWasSuccessful);
	
};

HTTP 요청을 보낸 후 서버로부터 응답을 받을 때 호출됩니다.

각 매개변수에 대해서 설명하자면 아래와 같습니다.

1. FHttpRequestPtr Request / 요청을 나타내는 포인터로 정보를 확인하거나 요청을 추적하는 데 사용됩니다.
2. FHttpResponsePtr Response / 서버로부터 받은 응답 데이터를 이 객체에서 가져올 수 있습니다.
3. bool bWasSuccessful / 요청 성공 여부 반환

HttpCall 함수

HTTP 요청을 생성하고 요청할 내용을 이 함수에 작성하겠습니다.

인자로 HTTP 요청을 보낼 URL과 요청 방식을 가집니다.

public:
	UFUNCTION(BlueprintCallable)
	void HttpCall(const FString& InURL, const FString& InVerb);
};

전체 헤더 파일 코드입니다.

소스 코드 작성

HTTP 초기화

생성자 부분에서 Http 변수에 대해서 초기화를 하겠습니다.

FHttpModule::Get()은 Unreal Engine에서 제공하는 싱글톤 패턴으로 구현된 FHttpModule 객체를 반환하는 함수입니다.
HTTP 요청을 생성하고 관리하는 모듈인 FHttpModule의 인스턴스를 전역적으로 사용할 수 있도록 제공합니다.

HttpCall 함수 작성

우선 Http를 요청할 객체를 만들어야 합니다.

해당 객체는 IHttpRequest 타입을 사용합니다.

IHttpRequest는 Unreal Engine의 HTTP 요청을 나타내는 인터페이스입니다.
HTTP 요청을 생성하고 서버에 전송하며, 응답을 받을 때 사용할 수 있는 메서드들을 제공합니다.

IHttpRequest 자체는 인터페이스이기 때문에 직접 객체를 생성할 수 없으며,
Unreal Engine에서 제공하는 HTTP 모듈(FHttpModule)을 통해 해당 인터페이스를 구현한 객체가 반환됩니다.

Http 요청 객체를 생성해 Request 변수에 저장합니다.

// 지정된 URL로 HTTP 요청을 보낸다.
// InVerb는 Get,Post 등 요청 메서드이다.
void AGM_API_Test::HttpCall(const FString& InURL, const FString& InVerb)
{
	// Http 요청 객체를 생성해 Request변수에 저장한다.
	TSharedRef<IHttpRequest> Request = Http->CreateRequest();

}

IHttpRequest 타입의 주요 메서드는 아래 4가지가 있습니다.

1. SetURL() - 요청할 URL을 설정
2. SetVerb() - HTTP 메서드(GET, POST 등)를 설정
3. SetHeader() - 요청의 헤더를 설정
4. ProcessRequest() - 요청을 전송

이 타입들에 대해서 이제 설정해주어야 합니다.
일단 3번 메서드는 제외하고 진행하겠습니다.

여기서 URL과 Verb는 이미 매개변수로 받아왔죠?
그대로 값을 넣어 줍니다.

// 지정된 URL로 HTTP 요청을 보낸다.
// InVerb는 Get,Post 등 요청 메서드이다.
void AGM_API_Test::HttpCall(const FString& InURL, const FString& InVerb)
{
	// Http 요청 객체를 생성해 Request변수에 저장한다.
	TSharedRef<IHttpRequest> Request = Http->CreateRequest();

	Request->SetURL(InURL); // URL 설정
	Request->SetVerb(InVerb); // 메서드 설정

}

이렇게 Request 변수에 원하는 요청의 내용이 저장되어 있습니다.

이를 ProcessRequest() 함수를 사용하여 요청을 전송할 수 있습니다.
요청을 전송하고 로그를 출력하도록 하겠습니다.

// 지정된 URL로 HTTP 요청을 보낸다.
// InVerb는 Get,Post 등 요청 메서드이다.
void AGM_API_Test::HttpCall(const FString& InURL, const FString& InVerb)
{
	// Http 요청 객체를 생성해 Request변수에 저장한다.
	TSharedRef<IHttpRequest> Request = Http->CreateRequest();

	Request->SetURL(InURL); // URL 설정
	Request->SetVerb(InVerb); // 메서드 설정
	Request->SetHeader("Content-Type", TEXT("application/json")); // 요청의 헤더 설정

	// HTTP 요청 전송
	Request->ProcessRequest();

	// 전송했음을 알리는 로그 출력
	UE_LOG(LogTemp, Warning, TEXT("HttpCall initiated. URL: %s, Verb: %s"), *InURL, *InVerb);
}

여기서 가장 중요한 것이 있는데, 바로 OnResponseReceived 콜백 함수와 바인딩을 진행해주어야 합니다.
HTTP 요청이 완료되고 서버로부터 응답을 받았을 때, 호출될 함수입니다.

아래가 전체 코드입니다.

// 지정된 URL로 HTTP 요청을 보낸다.
// InVerb는 Get,Post 등 요청 메서드이다.
void AGM_API_Test::HttpCall(const FString& InURL, const FString& InVerb)
{
	// Http 요청 객체를 생성해 Request변수에 저장한다.
	TSharedRef<IHttpRequest> Request = Http->CreateRequest();

	// Http 요청이 완료되면 OnResponseReceived함수가 호출되도록 바인딩한다.
	Request->OnProcessRequestComplete().BindUObject(this, &AGM_API_Test::OnResponseReceived);
    
	Request->SetURL(InURL); // URL 설정
	Request->SetVerb(InVerb); // 메서드 설정
	Request->SetHeader("Content-Type", TEXT("application/json")); // 요청의 헤더 설정

	// HTTP 요청 전송
	Request->ProcessRequest();

	// 전송했음을 알리는 로그 출력
	UE_LOG(LogTemp, Warning, TEXT("HttpCall initiated. URL: %s, Verb: %s"), *InURL, *InVerb);
}

---

콜백 함수 작성

이번 실습에서는 간단하게 응답을 요청하고, 콜백을 받는 부분까지만 하겠습니다.

각 상황에 대한 예외처리는 당연히 해야겠죠?

1. 요청이 성공했는가?
2. 응답이 유효한가?

2가지에 대해서 예외처리를 진행하겠습니다.

void AGM_API_Test::OnResponseReceived(FHttpRequestPtr Request, FHttpResponsePtr Response, bool bWasSuccessful)
{
	// 요청이 성공했는지, 응답이 유요한지 검사한다.
	if (!bWasSuccessful || !Response.IsValid())
	{
		UE_LOG(LogTemp, Error, TEXT("HTTP request failed. URL: %s"), *Request->GetURL());
		return;
	}
}

서버로부터 받은 응답 데이터가 Response 인자라고 설명했었습니다.

Response에서 응답 상태 코드와 응답 본문을 문자열로 가져와 출력해보겠습니다.

void AGM_API_Test::OnResponseReceived(FHttpRequestPtr Request, FHttpResponsePtr Response, bool bWasSuccessful)
{
	// 요청이 성공했는지, 응답이 유요한지 검사한다.
	if (!bWasSuccessful || !Response.IsValid())
	{
		UE_LOG(LogTemp, Error, TEXT("HTTP request failed. URL: %s"), *Request->GetURL());
		return;
	}

	// 응답 상태 코드를 가져온다.
	int32 StatusCode = Response->GetResponseCode();

	// 응답 본문을 문자열로 가져옴
	FString ResponseContent = Response->GetContentAsString();

	// 요청이 완료되었음을 출력
	UE_LOG(LogTemp, Warning, TEXT("HTTP request completed. Status Code: %d, URL: %s"), StatusCode, *Request->GetURL());
	UE_LOG(LogTemp, Warning, TEXT("Response Content: %s"), *ResponseContent);

}

---

HTTP 요청 테스트

만든 게임모드 BP로 만들어 주고 HttpCall() 함수를 Begin Play 시 실행하였습니다.

적당히 테스트 링크를 아무거나 넣어 주시고 실행해주세요.

그리고 출력 로그를 보면?
총 3개의 로그가 잘 나오는 것을 볼 수 있습니다.

1. 요청 로그
2. 응답 상태 코드 200
3. 응답 본문

---

마무리

HTTP 요청과 응답을 성공적으로 완료하였습니다.

하지만 본문을 String으로 받아서야 실제 데이터로 사용하기 어렵죠.

다음 포스팅에선 해당 Json 데이터에서 원하는 내용을 추출해보겠습니다,.