언리얼 엔진에 기본 제공되지 않는 multipart/form-data 빌더의 경량 구현입니다. 더 자세히 ...

#include <FHttpMultipartFormData.h>

FHttpMultipartFormData에 대한 협력 다이어그램:

클래스
struct	FFilePart

struct	FTextPart

Public 멤버 함수
	FHttpMultipartFormData (EFormDataType Type=EFormDataType::Multipart)
	FormData 객체를 생성합니다.

bool	AddFile (const FString &FieldName, const FString &FilePath, const FString &MimeType=TEXT(""))
	파일 데이터를 multipart 본문에 추가합니다.

FORCEINLINE void	AddStringField (const FString &FieldName, const FString &Value)
	문자열 필드를 추가하는 편의 래퍼입니다.

void	AddText (const FString &FieldName, const FString &Value)
	간단한 텍스트 필드를 추가합니다.

const FString &	GetBoundary () const
	현재 사용 중인 경계 문자열입니다.

const TArray< uint8 > &	GetBuiltBody () const
	직렬화된 multipart 본문 데이터입니다.

void	Reset ()
	모든 파트를 제거하고 경계를 재생성합니다.

void	SetupHttpRequest (const TSharedRef< IHttpRequest, ESPMode::ThreadSafe > &Request)
	HTTP 요청에 Content-Type 헤더와 본문을 설정합니다.

Private 멤버 함수
void	BuildBody ()
	등록된 파트를 기반으로 HTTP 본문을 구성합니다.

정적 Private 멤버 함수
static void	AppendUtf8 (TArray< uint8 > &Dest, const FString &Str)
	문자열을 UTF-8로 변환해 버퍼에 추가합니다.

static FString	DetectMimeFromExtension (const FString &FileName)
	파일 확장자를 기반으로 MIME 타입을 추론합니다.

Private 속성
FString	Boundary

TArray< uint8 >	BuiltBody

TArray< FFilePart >	FileParts

EFormDataType	FormDataType

TArray< FTextPart >	TextParts

상세한 설명

언리얼 엔진에 기본 제공되지 않는 multipart/form-data 빌더의 경량 구현입니다.

경계(boundary)를 자동으로 생성합니다.
텍스트 및 파일 필드를 추가할 수 있습니다.
RFC 7578 규격에 맞는 HTTP 본문을 생성합니다.

FHttpMultipartFormData.h 파일의 27 번째 라인에서 정의되었습니다.

생성자 & 소멸자 문서화

◆ FHttpMultipartFormData()

FHttpMultipartFormData::FHttpMultipartFormData ( EFormDataType Type = EFormDataType::Multipart )

FormData 객체를 생성합니다.

매개변수

Type	[in] 전송 방식 (기본값: Multipart)

FHttpMultipartFormData.cpp 파일의 14 번째 라인에서 정의되었습니다.

    : FormDataType(Type)
{
    Reset();
}

다음을 참조함 : Reset().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

멤버 함수 문서화

◆ AddFile()

bool FHttpMultipartFormData::AddFile	(	const FString &	FieldName,
		const FString &	FilePath,
		const FString &	MimeType = `TEXT("")`
	)

파일 데이터를 multipart 본문에 추가합니다.

매개변수

FieldName	[in] 폼 필드 이름입니다.
FilePath	[in] 읽어올 파일 경로입니다.
MimeType	[in] 명시적 MIME 타입(비어있으면 자동 추론)입니다.

반환값: 파일 로드 및 추가에 성공하면 true입니다.

FHttpMultipartFormData.cpp 파일의 39 번째 라인에서 정의되었습니다.

{
    TArray<uint8> FileBytes;
    if (!FFileHelper::LoadFileToArray(FileBytes, *FilePath))
    {
        UE_LOG(LogTemp, Warning, TEXT("[HttpMultipartFormData] Failed to load file: %s"), *FilePath);
        return false;
    }
 
    FString FileNameOnly = FPaths::GetCleanFilename(FilePath);
    FString Mime = InMimeType.IsEmpty() ? DetectMimeFromExtension(FileNameOnly) : InMimeType;
 
    FileParts.Add({ FieldName, FileNameOnly, Mime, MoveTemp(FileBytes) });
    return true;
}

다음을 참조함 : DetectMimeFromExtension(), FileParts.

다음에 의해서 참조됨 : UKLingoNetworkSystem::RequestChatAudio(), UKLingoNetworkSystem::RequestDailyAudio(), UKLingoNetworkSystem::RequestSpeakingJudges(), UKLingoNetworkSystem::RequestWriteSubmit().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ AddStringField()

FORCEINLINE void FHttpMultipartFormData::AddStringField	(	const FString &	FieldName,
		const FString &	Value
	)

inline

문자열 필드를 추가하는 편의 래퍼입니다.

FHttpMultipartFormData.h 파일의 40 번째 라인에서 정의되었습니다.

    {
        AddText(FieldName, Value);
    }

다음을 참조함 : AddText().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ AddText()

void FHttpMultipartFormData::AddText	(	const FString &	FieldName,
		const FString &	Value
	)

간단한 텍스트 필드를 추가합니다.

매개변수

FieldName	[in] 폼 필드 이름입니다.
Value	[in] 필드에 저장할 문자열 값입니다.

FHttpMultipartFormData.cpp 파일의 34 번째 라인에서 정의되었습니다.

{
    TextParts.Add({ FieldName, Value });
}

다음을 참조함 : TextParts.

다음에 의해서 참조됨 : AddStringField(), UKLingoNetworkSystem::RequestChatAudio(), UKLingoNetworkSystem::RequestDailyAudio(), UKLingoNetworkSystem::RequestUserToken(), UKLingoNetworkSystem::RequestWriteSubmit().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ AppendUtf8()

void FHttpMultipartFormData::AppendUtf8	(	TArray< uint8 > &	Dest,
		const FString &	Str
	)

staticprivate

문자열을 UTF-8로 변환해 버퍼에 추가합니다.

FHttpMultipartFormData.cpp 파일의 141 번째 라인에서 정의되었습니다.

{
    FTCHARToUTF8 Conv(*Str);
    Dest.Append(reinterpret_cast<const uint8*>(Conv.Get()), Conv.Length());
}

다음에 의해서 참조됨 : BuildBody().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ BuildBody()

void FHttpMultipartFormData::BuildBody ( )

private

등록된 파트를 기반으로 HTTP 본문을 구성합니다.

FHttpMultipartFormData.cpp 파일의 78 번째 라인에서 정의되었습니다.

{
    BuiltBody.Reset();
 
    if (FormDataType == EFormDataType::FormUrlEncoded)
    {
        // application/x-www-form-urlencoded: key1=value1&key2=value2
        TArray<FString> Pairs;
        for (const FTextPart& P : TextParts)
        {
            FString EncodedKey = FGenericPlatformHttp::UrlEncode(P.Name);
            FString EncodedValue = FGenericPlatformHttp::UrlEncode(P.Value);
            Pairs.Add(FString::Printf(TEXT("%s=%s"), *EncodedKey, *EncodedValue));
        }
 
        FString Body = FString::Join(Pairs, TEXT("&"));
        AppendUtf8(BuiltBody, Body);
    }
    else // Multipart
    {
        auto Add = [](TArray<uint8>& Dest, const FString& S)
        {
            AppendUtf8(Dest, S);
        };
 
        const FString LineEnd = TEXT("\r\n");
        const FString BoundaryLine = TEXT("--") + Boundary;
 
        // 텍스트 파트
        for (const FTextPart& P : TextParts)
        {
            Add(BuiltBody, BoundaryLine + LineEnd);
            Add(BuiltBody, FString::Printf(
                TEXT("Content-Disposition: form-data; name=\"%s\"%s"),
                *P.Name, *LineEnd));
            Add(BuiltBody, LineEnd);          // 헤더와 값 사이의 빈 줄
            Add(BuiltBody, P.Value + LineEnd);
        }
 
        // 파일 파트
        for (const FFilePart& P : FileParts)
        {
            Add(BuiltBody, BoundaryLine + LineEnd);
            Add(BuiltBody, FString::Printf(
                TEXT("Content-Disposition: form-data; name=\"%s\"; filename=\"%s\"%s"),
                *P.Name, *P.FileName, *LineEnd));
            Add(BuiltBody, FString::Printf(
                TEXT("Content-Type: %s%s"),
                *P.MimeType, *LineEnd));
            Add(BuiltBody, LineEnd);          // 바이너리 데이터 앞의 빈 줄
 
            // 바이너리 데이터
            BuiltBody.Append(P.Data);
 
            // 파일 내용 뒤의 CRLF
            AppendUtf8(BuiltBody, LineEnd);
        }
 
        // 닫는 경계
        Add(BuiltBody, BoundaryLine + TEXT("--") + LineEnd);
    }
}

다음을 참조함 : AppendUtf8(), Boundary, BuiltBody, FileParts, FormDataType, FormUrlEncoded, TextParts.

다음에 의해서 참조됨 : SetupHttpRequest().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ DetectMimeFromExtension()

FString FHttpMultipartFormData::DetectMimeFromExtension ( const FString & FileName )

staticprivate

파일 확장자를 기반으로 MIME 타입을 추론합니다.

FHttpMultipartFormData.cpp 파일의 147 번째 라인에서 정의되었습니다.

{
    const FString Ext = FPaths::GetExtension(FileName, /*bIncludeDot*/ false).ToLower();
 
    // 일반적인 오디오 타입
    if (Ext == TEXT("mp3"))  return TEXT("audio/mpeg");
    if (Ext == TEXT("wav"))  return TEXT("audio/wav");
    if (Ext == TEXT("ogg"))  return TEXT("audio/ogg");
    if (Ext == TEXT("flac")) return TEXT("audio/flac");
    if (Ext == TEXT("m4a"))  return TEXT("audio/mp4");
    // 대체 타입
    if (Ext == TEXT("txt"))  return TEXT("text/plain");
    if (Ext == TEXT("json")) return TEXT("application/json");
 
    // 기본 타입
    return TEXT("application/octet-stream");
}

다음에 의해서 참조됨 : AddFile().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ GetBoundary()

const FString & FHttpMultipartFormData::GetBoundary ( ) const

inline

현재 사용 중인 경계 문자열입니다.

FHttpMultipartFormData.h 파일의 60 번째 라인에서 정의되었습니다.

60{ return Boundary; }

다음을 참조함 : Boundary.

◆ GetBuiltBody()

const TArray< uint8 > & FHttpMultipartFormData::GetBuiltBody ( ) const

inline

직렬화된 multipart 본문 데이터입니다.

FHttpMultipartFormData.h 파일의 63 번째 라인에서 정의되었습니다.

63{ return BuiltBody; }

다음을 참조함 : BuiltBody.

◆ Reset()

void FHttpMultipartFormData::Reset ( )

모든 파트를 제거하고 경계를 재생성합니다.

FHttpMultipartFormData.cpp 파일의 20 번째 라인에서 정의되었습니다.

{
    TextParts.Reset();
    FileParts.Reset();
    BuiltBody.Reset();
 
    // Multipart일 때만 Boundary 생성
    if (FormDataType == EFormDataType::Multipart)
    {
        // 어떤 고유한 토큰이든 괜찮습니다. 디버깅을 위해 읽기 쉽게 유지합니다.
        Boundary = TEXT("----UE_Multipart_") + FGuid::NewGuid().ToString(EGuidFormats::Digits);
    }
}

다음을 참조함 : Boundary, BuiltBody, FileParts, FormDataType, Multipart, TextParts.

다음에 의해서 참조됨 : FHttpMultipartFormData().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ SetupHttpRequest()

void FHttpMultipartFormData::SetupHttpRequest ( const TSharedRef< IHttpRequest, ESPMode::ThreadSafe > & Request )

HTTP 요청에 Content-Type 헤더와 본문을 설정합니다.

매개변수

Request [in] 전송할 HTTP 요청 객체입니다.

FHttpMultipartFormData.cpp 파일의 55 번째 라인에서 정의되었습니다.

{
    BuildBody();
 
    // FormDataType에 따라 다른 Content-Type 설정
    if (FormDataType == EFormDataType::FormUrlEncoded)
    {
        Request->SetHeader(TEXT("Content-Type"),
            TEXT("application/x-www-form-urlencoded"));
    }
    else // Multipart
    {
        // 경계를 포함한 Content-Type
        Request->SetHeader(TEXT("Content-Type"),
            FString::Printf(TEXT("multipart/form-data; boundary=%s"), *Boundary));
    }
 
    // 참고: Accept 헤더는 호출자가 설정해야 합니다. 많은 STT 엔드포인트는 JSON을 기대합니다.
    // Request->SetHeader(TEXT("Accept"), TEXT("application/json"));
 
    Request->SetContent(BuiltBody);
}

다음을 참조함 : Boundary, BuildBody(), BuiltBody, FormDataType, FormUrlEncoded.

다음에 의해서 참조됨 : UKLingoNetworkSystem::RequestChatAudio(), UKLingoNetworkSystem::RequestDailyAudio(), UKLingoNetworkSystem::RequestSpeakingJudges(), UKLingoNetworkSystem::RequestUserToken(), UKLingoNetworkSystem::RequestWriteSubmit().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

멤버 데이터 문서화

◆ Boundary

FString FHttpMultipartFormData::Boundary

private

FHttpMultipartFormData.h 파일의 92 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : BuildBody(), GetBoundary(), Reset(), SetupHttpRequest().

◆ BuiltBody

TArray<uint8> FHttpMultipartFormData::BuiltBody

private

FHttpMultipartFormData.h 파일의 95 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : BuildBody(), GetBuiltBody(), Reset(), SetupHttpRequest().

◆ FileParts

TArray<FFilePart> FHttpMultipartFormData::FileParts

private

FHttpMultipartFormData.h 파일의 94 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : AddFile(), BuildBody(), Reset().

◆ FormDataType

EFormDataType FHttpMultipartFormData::FormDataType

private

FHttpMultipartFormData.h 파일의 91 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : BuildBody(), Reset(), SetupHttpRequest().

◆ TextParts

TArray<FTextPart> FHttpMultipartFormData::TextParts

private

FHttpMultipartFormData.h 파일의 93 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : AddText(), BuildBody(), Reset().

이 클래스에 대한 문서화 페이지는 다음의 파일들로부터 생성되었습니다.:

Source/Onepiece/Network/Public/FHttpMultipartFormData.h
Source/Onepiece/Network/Private/FHttpMultipartFormData.cpp

클래스

Public 멤버 함수

Private 멤버 함수

정적 Private 멤버 함수

Private 속성

상세한 설명

생성자 & 소멸자 문서화

◆ FHttpMultipartFormData()

멤버 함수 문서화

◆ AddFile()

◆ AddStringField()

◆ AddText()

◆ AppendUtf8()

◆ BuildBody()

◆ DetectMimeFromExtension()

◆ GetBoundary()

◆ GetBuiltBody()

◆ Reset()

◆ SetupHttpRequest()

멤버 데이터 문서화

◆ Boundary

◆ BuiltBody

◆ FileParts

◆ FormDataType

◆ TextParts