CyberGocybergodev/httpc

한국어

简体中文
English
日本語
Русский

한국어

简体中文
English
日本語
Русский

테마

한국어

简体中文
English
日本語
Русский

Result ​

Result 는 HTTP 응답과 요청 메타데이터를 래핑하여 편리한 접근 메서드를 제공합니다. Client.Request() 또는 패키지 함수로 얻을 수 있습니다.

go
type Result struct {
    Request  *RequestInfo
    Response *ResponseInfo
    Meta     *RequestMeta
}
go
result, err := httpc.Get("https://api.example.com/users/1")
if err != nil {
    log.Fatal(err)
}

fmt.Println(result.StatusCode()) // 200
fmt.Println(result.Body())       // {"id":1,"name":"test"}

TIP

Result 는 매 요청마다 새로 생성되며, GC 가 자동으로 회수하므로 수동 해제가 필요 없습니다.

기본 메서드 ​

StatusCode ​

go
func (r *Result) StatusCode() int

HTTP 상태 코드를 반환합니다. nil 안전, 0 을 반환합니다.

Body ​

go
func (r *Result) Body() string

응답 본문 문자열을 반환합니다. nil 안전, 빈 문자열을 반환합니다.

RawBody ​

go
func (r *Result) RawBody() []byte

응답 본문 원본 바이트를 반환합니다. nil 안전, nil 을 반환합니다.

Proto ​

go
func (r *Result) Proto() string

HTTP 프로토콜 버전을 반환합니다. 예: "HTTP/1.1", "HTTP/2.0".

상태 판단 ​

IsSuccess ​

go
func (r *Result) IsSuccess() bool

상태 코드가 2xx 이면 true 를 반환합니다.

IsRedirect ​

go
func (r *Result) IsRedirect() bool

상태 코드가 3xx 이면 true 를 반환합니다.

IsClientError ​

go
func (r *Result) IsClientError() bool

상태 코드가 4xx 이면 true 를 반환합니다.

IsServerError ​

go
func (r *Result) IsServerError() bool

상태 코드가 5xx 이면 true 를 반환합니다.

go
result, _ := client.Get(url)
switch {
case result.IsSuccess():
    handleSuccess(result)
case result.IsClientError():
    handleClientError(result)
case result.IsServerError():
    handleServerError(result)
}

ResponseCookies ​

go
func (r *Result) ResponseCookies() []*http.Cookie

응답의 모든 Cookie 를 반환합니다.

GetCookie ​

go
func (r *Result) GetCookie(name string) *http.Cookie

이름으로 응답 Cookie 를 가져옵니다. 찾지 못하면 nil 을 반환합니다.

go
cookie := result.GetCookie("session")
if cookie != nil {
    fmt.Println(cookie.Value)
}

HasCookie ​

go
func (r *Result) HasCookie(name string) bool

응답에 지정된 이름의 Cookie 가 있는지 확인합니다.

RequestCookies ​

go
func (r *Result) RequestCookies() []*http.Cookie

요청에서 전송한 모든 Cookie 를 반환합니다.

GetRequestCookie ​

go
func (r *Result) GetRequestCookie(name string) *http.Cookie

이름으로 요청 Cookie 를 가져옵니다.

HasRequestCookie ​

go
func (r *Result) HasRequestCookie(name string) bool

요청에 지정된 이름의 Cookie 가 있는지 확인합니다.

JSON 파싱 ​

Unmarshal ​

go
func (r *Result) Unmarshal(v any) error

JSON 응답 본문을 대상 변수에 파싱합니다. json.Unmarshal 규칙을 따릅니다.

오류트리거 조건
ErrResponseBodyEmpty응답 본문이 비어 있음
ErrResponseBodyTooLarge응답 본문이 50MB JSON 파싱 크기 제한 초과
go
var user User
if err := result.Unmarshal(&user); err != nil {
    log.Fatal(err)
}
fmt.Println(user.Name)

파일 저장 ​

SaveToFile ​

go
func (r *Result) SaveToFile(filePath string) error

응답 본문을 파일로 저장합니다. 파일 경로는 보안 검증을 거칩니다 (경로 순회 방지, 심볼릭 링크 검사, 시스템 경로 보호).

오류트리거 조건
ErrResponseBodyEmpty응답 본문이 비어 있음
go
result, _ := client.Get("https://example.com/data.csv")

if err := result.SaveToFile("/tmp/data.csv"); err != nil {
    log.Fatal(err)
}

문자열 표현 ​

String ​

go
func (r *Result) String() string

사람이 읽을 수 있는 문자열 표현을 반환합니다. 민감한 헤더는 자동 마스킹되며, 응답 본문은 200 자로 잘립니다.

go
result, _ := client.Get(url)
fmt.Println(result.String())
// Result{Status: 200 200 OK, ContentLength: 1024, Duration: 125ms, Attempts: 1, ...}

하위 타입 ​

RequestInfo ​

go
type RequestInfo struct {
    URL     string
    Method  string
    Headers http.Header
    Cookies []*http.Cookie
}

요청 상세 정보. result.Request로 접근합니다.

ResponseInfo ​

go
type ResponseInfo struct {
    StatusCode    int
    Status        string
    Proto         string
    Headers       http.Header
    Body          string
    RawBody       []byte
    ContentLength int64
    Cookies       []*http.Cookie
}

응답 데이터. result.Response로 접근합니다.

RequestMeta ​

go
type RequestMeta struct {
    Duration      time.Duration
    Attempts      int
    RedirectChain []string
    RedirectCount int
}

요청 실행 메타데이터. result.Meta로 접근합니다.

go
result, _ := client.Get(url)

fmt.Println(result.Meta.Duration)      // 125ms
fmt.Println(result.Meta.Attempts)       // 2 (1 회 재시도)
fmt.Println(result.Meta.RedirectCount)  // 1 (1 회 리다이렉트 따라감)

관련 항목 ​