Middleware Avançado¶
No tutorial principal você leu como adicionar Middleware Personalizado à sua aplicação.
E então você também leu como lidar com CORS com o CORSMiddleware.
Nesta seção, veremos como usar outros middlewares.
Adicionando middlewares ASGI¶
Como o ReadyAPI é baseado no Starlette e implementa a especificação ASGI, você pode usar qualquer middleware ASGI.
O middleware não precisa ser feito para o ReadyAPI ou Starlette para funcionar, desde que siga a especificação ASGI.
No geral, os middlewares ASGI são classes que esperam receber um aplicativo ASGI como o primeiro argumento.
Então, na documentação de middlewares ASGI de terceiros, eles provavelmente dirão para você fazer algo como:
from unicorn import UnicornMiddleware
app = SomeASGIApp()
new_app = UnicornMiddleware(app, some_config="rainbow")
Mas, o ReadyAPI (na verdade, o Starlette) fornece uma maneira mais simples de fazer isso que garante que os middlewares internos lidem com erros do servidor e que os manipuladores de exceções personalizados funcionem corretamente.
Para isso, você usa app.add_middleware() (como no exemplo para CORS).
from readyapi import ReadyAPI
from unicorn import UnicornMiddleware
app = ReadyAPI()
app.add_middleware(UnicornMiddleware, some_config="rainbow")
app.add_middleware() recebe uma classe de middleware como o primeiro argumento e quaisquer argumentos adicionais a serem passados para o middleware.
Middlewares Integrados¶
ReadyAPI inclui vários middlewares para casos de uso comuns, veremos a seguir como usá-los.
Detalhes Técnicos
Para o próximo exemplo, você também poderia usar from starlette.middleware.something import SomethingMiddleware.
ReadyAPI fornece vários middlewares em readyapi.middleware apenas como uma conveniência para você, o desenvolvedor. Mas a maioria dos middlewares disponíveis vem diretamente do Starlette.
HTTPSRedirectMiddleware¶
Garante que todas as requisições devem ser https ou wss.
Qualquer requisição para http ou ws será redirecionada para o esquema seguro.
from readyapi import ReadyAPI
from readyapi.middleware.httpsredirect import HTTPSRedirectMiddleware
app = ReadyAPI()
app.add_middleware(HTTPSRedirectMiddleware)
@app.get("/")
async def main():
return {"message": "Hello World"}
TrustedHostMiddleware¶
Garante que todas as requisições recebidas tenham um cabeçalho Host corretamente configurado, a fim de proteger contra ataques de cabeçalho de host HTTP.
from readyapi import ReadyAPI
from readyapi.middleware.trustedhost import TrustedHostMiddleware
app = ReadyAPI()
app.add_middleware(
TrustedHostMiddleware, allowed_hosts=["example.com", "*.example.com"]
)
@app.get("/")
async def main():
return {"message": "Hello World"}
Os seguintes argumentos são suportados:
allowed_hosts- Uma lista de nomes de domínio que são permitidos como nomes de host. Domínios com coringa, como*.example.com, são suportados para corresponder a subdomínios. Para permitir qualquer nome de host, useallowed_hosts=["*"]ou omita o middleware.
Se uma requisição recebida não for validada corretamente, uma resposta 400 será enviada.
GZipMiddleware¶
Gerencia respostas GZip para qualquer requisição que inclua "gzip" no cabeçalho Accept-Encoding.
O middleware lidará com respostas padrão e de streaming.
from readyapi import ReadyAPI
from readyapi.middleware.gzip import GZipMiddleware
app = ReadyAPI()
app.add_middleware(GZipMiddleware, minimum_size=1000, compresslevel=5)
@app.get("/")
async def main():
return "somebigcontent"
Os seguintes argumentos são suportados:
minimum_size- Não comprima respostas menores que este tamanho mínimo em bytes. O padrão é500.compresslevel- Usado durante a compressão GZip. É um inteiro variando de 1 a 9. O padrão é9. Um valor menor resulta em uma compressão mais rápida, mas em arquivos maiores, enquanto um valor maior resulta em uma compressão mais lenta, mas em arquivos menores.
Outros middlewares¶
Há muitos outros middlewares ASGI.
Por exemplo:
Para checar outros middlewares disponíveis, confira Documentação de Middlewares do Starlette e a Lista Incrível do ASGI.