base

class litestar.response.base.ASGIResponse

基底類別：object

A low-level ASGI response class.

__init__(*, background: BackgroundTask | BackgroundTasks | None = None, body: bytes | str = b'', content_length: int | None = None, cookies: Iterable[Cookie] | None = None, encoding: str = 'utf-8', headers: dict[str, Any] | Iterable[tuple[str, str]] | None = None, is_head_response: bool = False, media_type: MediaType | str | None = None, status_code: int | None = None) → None

A low-level ASGI response class.

參數:

• background -- A background task or a list of background tasks to be executed after the response is sent.

• body -- encoded content to send in the response body.

• content_length -- The response content length.

• cookies -- The response cookies.

• encoding -- The response encoding.

• headers -- The response headers.

• is_head_response -- A boolean indicating if the response is a HEAD response.

• media_type -- The response media type.

• status_code -- The response status code.

encode_headers() → list[tuple[bytes, bytes]]

Return a list of headers for this response.

The list contains both headers and encoded cookies, as tuples, where each tuple represents a single header key-value pair encoded as bytes.

async after_response() → None

Execute after the response is sent.

回傳:

None

async start_response(send: Send) → None

Emit the start event of the response. This event includes the headers and status codes.

參數:

send -- ASGI 發送函式。

回傳:

None

async send_body(send: Send, receive: Receive) → None

Emit the response body.

參數:

• send -- ASGI 發送函式。

• receive -- ASGI 接收函式。

備註

• Response subclasses should customize this method if there is a need to customize sending data.

回傳:

None

async __call__(scope: Scope, receive: Receive, send: Send) → None

ASGI callable of the Response.

參數:

• scope -- The ASGI connection scope.

• receive -- ASGI 接收函式。

• send -- ASGI 發送函式。

回傳:

None

class litestar.response.base.Response

基底類別：Generic[T]

Base Litestar HTTP response class, used as the basis for all other response classes.

__init__(content: T, *, background: BackgroundTask | BackgroundTasks | None = None, cookies: ResponseCookies | None = None, encoding: str = 'utf-8', headers: ResponseHeaders | None = None, media_type: MediaType | OpenAPIMediaType | str | None = None, status_code: int | None = None, type_encoders: TypeEncodersMap | None = None) → None

Initialize the response.

參數:

• content -- A value for the response body that will be rendered into bytes string.

• status_code -- An HTTP status code.

• media_type -- A value for the response Content-Type header.

• background -- A BackgroundTask instance or BackgroundTasks to execute after the response is finished. Defaults to None.

• headers -- A string keyed dictionary of response headers. Header keys are insensitive.

• cookies -- A list of Cookie instances to be set under the response Set-Cookie header.

• encoding -- The encoding to be used for the response headers.

• type_encoders -- A mapping of types to callables that transform them into types supported for serialization.

set_cookie(cookie: Cookie) → None

set_cookie(key: str, value: str | None = None, max_age: int | None = None, expires: int | None = None, path: str = '/', domain: str | None = None, secure: bool = False, httponly: bool = False, samesite: Literal['lax', 'strict', 'none'] = 'lax') → None

Set a cookie on the response. If passed a Cookie instance, keyword arguments will be ignored.

參數:

• key -- Key for the cookie or a Cookie instance.

• value -- Value for the cookie, if none given defaults to empty string.

• max_age -- Maximal age of the cookie before its invalidated.

• expires -- Seconds from now until the cookie expires.

• path -- Path fragment that must exist in the request url for the cookie to be valid. Defaults to /.

• domain -- Domain for which the cookie is valid.

• secure -- Https is required for the cookie.

• httponly -- Forbids javascript to access the cookie via document.cookie.

• samesite -- Controls whether a cookie is sent with cross-site requests. Defaults to lax.

回傳:

None.

set_header(key: str, value: Any) → None

Set a header on the response.

參數:

• key -- Header key.

• value -- Header value.

回傳:

None.

set_etag(etag: str | ETag) → None

Set an etag header.

參數:

etag -- An etag value.

回傳:

None

delete_cookie(key: str, path: str = '/', domain: str | None = None) → None

Delete a cookie.

參數:

• key -- Key of the cookie.

• path -- Path of the cookie.

• domain -- Domain of the cookie.

回傳:

None.

render(content: Any, media_type: str, enc_hook: Serializer = <function default_serializer>) → bytes

Handle the rendering of content into a bytes string.

回傳:

An encoded bytes string

to_asgi_response(request: Request, *, background: BackgroundTask | BackgroundTasks | None = None, cookies: Iterable[Cookie] | None = None, headers: dict[str, str] | None = None, is_head_response: bool = False, media_type: MediaType | str | None = None, status_code: int | None = None, type_encoders: TypeEncodersMap | None = None) → ASGIResponse

Create an ASGIResponse from a Response instance.

參數:

• background -- Background task(s) to be executed after the response is sent.

• cookies -- A list of cookies to be set on the response.

• headers -- Additional headers to be merged with the response headers. Response headers take precedence.

• is_head_response -- Whether the response is a HEAD response.

• media_type -- Media type for the response. If media_type is already set on the response, this is ignored.

• request -- The Request instance.

• status_code -- Status code for the response. If status_code is already set on the response, this is

• type_encoders -- A dictionary of type encoders to use for encoding the response content.

回傳:

An ASGIResponse instance.