HttpRequest 클래스

HTTP 요청을 나타냅니다.

나중에 "format_parameters"을 사용하여 추가할 쿼리 매개 변수 없이 URL을 지정할 수 있습니다.

상속

builtins.object

HttpRequest

생성자

HttpRequest(method: str, url: str, headers: Mapping[str, str] | None = None, files: Any | None = None, data: bytes | str | Dict[str, str | int] | None = None)

매개 변수

method

str

필수

HTTP 메서드(GET, HEAD 등)

url

str

필수

적어도 완전한 체계/호스트/경로

headers

dict[str,str]

기본값: None

HTTP 헤더

files

dict[str, tuple[str, IO, str, dict]] 또는 dict[str, IO]

기본값: None

'name': file-like-objects 다중 파트 인코딩 업로드의 사전(또는 {'name': file-tuple})입니다. file-tuple는 2 튜플, 3 튜플 ('filename', fileobj)('filename', fileobj, 'content_type') 또는 4 튜플('filename', fileobj, 'content_type', custom_headers)일 수 있습니다. 여기서 'content_type' 는 지정된 파일의 콘텐츠 형식을 정의하는 문자열이고 custom_headers 파일에 추가할 추가 헤더를 포함하는 dict와 같은 개체입니다.

data

bytes 또는 dict (<xref:for form>)

기본값: None

보낼 본문입니다.

메서드

format_parameters	매개 변수를 유효한 쿼리 문자열로 서식 지정합니다. 모든 매개 변수가 이미 유효한 URL 문자열로 인용된 것으로 가정합니다.
prepare_multipart_body	다중 파트 정보에 따라 이 요청의 본문을 준비합니다. 이 호출은 on_request 정책이 올바른 컨텍스트(동기화/비동기)에 이미 적용된 것으로 가정합니다. "set_multipart_mixed"이 호출되지 않은 경우 아무 것도 수행하지 않습니다.
serialize	application/http 사양을 사용하여 이 요청을 직렬화합니다.
set_bytes_body	제네릭 바이트를 요청 본문으로 설정합니다. 콘텐츠 길이를 설정합니다.
set_formdata_body	양식으로 인코딩된 데이터를 요청 본문으로 설정합니다.
set_json_body	JSON 친화적 개체를 요청 본문으로 설정합니다.
set_multipart_mixed	다중 파트/혼합 부분을 설정합니다. 지금은 지원되는 인수만 HttpRequest 개체입니다. 경계는 선택 사항이며, 하나를 제공하지 않으면 하나가 생성됩니다. 경계에서 확인이 수행되지 않으므로 RFC1341 7.2.1을 준수하고 올바른 경계를 제공하는 방법을 알 수 있을 만큼 고급으로 간주됩니다. 요청당 정책 구성을 위해 추가 kwargs가 파이프라인 컨텍스트로 전달됩니다.
set_streamed_data_body	스트리밍 가능한 데이터 본문을 설정합니다.
set_text_body	텍스트를 요청의 본문으로 설정합니다.
set_xml_body	XML 요소 트리를 요청의 본문으로 설정합니다.

format_parameters

매개 변수를 유효한 쿼리 문자열로 서식 지정합니다. 모든 매개 변수가 이미 유효한 URL 문자열로 인용된 것으로 가정합니다.

format_parameters(params: Dict[str, str]) -> None

매개 변수

params

dict

필수

매개 변수 사전입니다.

prepare_multipart_body

다중 파트 정보에 따라 이 요청의 본문을 준비합니다.

이 호출은 on_request 정책이 올바른 컨텍스트(동기화/비동기)에 이미 적용된 것으로 가정합니다.

"set_multipart_mixed"이 호출되지 않은 경우 아무 것도 수행하지 않습니다.

prepare_multipart_body(content_index: int = 0) -> int

매개 변수

content_index

int

기본값: 0

일괄 처리 메시지 내 파트의 현재 인덱스입니다.

반환

이 요청의 모든 부분이 추가된 후 업데이트된 인덱스입니다.

반환 형식

int

serialize

application/http 사양을 사용하여 이 요청을 직렬화합니다.

serialize() -> bytes

반환

HTTP 하위 수준 메시지로 직렬화된 요청(바이트)입니다.

반환 형식

bytes

set_bytes_body

제네릭 바이트를 요청 본문으로 설정합니다.

콘텐츠 길이를 설정합니다.

set_bytes_body(data: bytes) -> None

매개 변수

data

bytes

필수

요청 필드 데이터입니다.

set_formdata_body

양식으로 인코딩된 데이터를 요청 본문으로 설정합니다.

set_formdata_body(data: Dict[str, str] | None = None) -> None

매개 변수

data

dict

기본값: None

요청 필드 데이터입니다.

set_json_body

JSON 친화적 개체를 요청 본문으로 설정합니다.

set_json_body(data: Any) -> None

매개 변수

data

dict

필수

JSON 직렬화 가능 개체

set_multipart_mixed

다중 파트/혼합 부분을 설정합니다.

지금은 지원되는 인수만 HttpRequest 개체입니다.

경계는 선택 사항이며, 하나를 제공하지 않으면 하나가 생성됩니다. 경계에서 확인이 수행되지 않으므로 RFC1341 7.2.1을 준수하고 올바른 경계를 제공하는 방법을 알 수 있을 만큼 고급으로 간주됩니다.

요청당 정책 구성을 위해 추가 kwargs가 파이프라인 컨텍스트로 전달됩니다.

set_multipart_mixed(*requests: HttpRequest, policies: List[SansIOHTTPPolicy[HTTPRequestType, HTTPResponseType]] | None = None, boundary: str | None = None, **kwargs: Any) -> None

매개 변수

requests

HttpRequest

필수

다중 파트/혼합에 추가할 요청

policies

list[SansIOHTTPPolicy]

준비 시간에 적용할 SansIOPolicy

boundary

str

선택적 경계

set_streamed_data_body

스트리밍 가능한 데이터 본문을 설정합니다.

set_streamed_data_body(data: Any) -> None

매개 변수

data

<xref:stream> 또는 <xref:generator> 또는 <xref:asyncgenerator>

필수

요청 필드 데이터입니다.

set_text_body

텍스트를 요청의 본문으로 설정합니다.

set_text_body(data: str) -> None

매개 변수

data

str

필수

본문으로 보낼 텍스트입니다.

set_xml_body

XML 요소 트리를 요청의 본문으로 설정합니다.

set_xml_body(data: Any) -> None

매개 변수

data

<xref:<xref:XML node>>

필수

요청 필드 데이터입니다.

특성

body

데이터에 대한 별칭입니다.

반환

요청의 본문입니다.

반환 형식

bytes,

str,

dict,

None

query

요청의 쿼리 매개 변수(dict)입니다.

반환

요청의 쿼리 매개 변수(dict)입니다.

반환 형식

dict[str, str]