mirror/fastapi
1
0
Fork 0
mirror of https://github.com/fastapi/fastapi.git synced 2026-04-16 04:53:11 -04:00
Code Issues Packages Projects Releases Wiki Activity

✨ Use request.state for SQLAlchemy session in tutorial (#45)

Browse Source
This commit is contained in:
Sebastián Ramírez
2019-02-19 21:18:28 +04:00
committed by GitHub
parent ba10838c30
commit 12e087f0b5
3 changed files with 11 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
docs/tutorial/sql-databases.md
View File

@@ -102,15 +102,12 @@ The middleware we will create (just a function) will create a new SQLAlchemy `Se
{!./src/sql_databases/tutorial001.py!}
```
### About `request._scope`
### About `request.state`
`request._scope` is a "private property" of each request. We normally shouldn't need to use a "private property" from a Python object.
<a href="https://www.starlette.io/requests/#other-state" target="_blank">`request.state` is a property of each Starlette `Request` object</a>, it is there to store arbitrary objects attached to the request itself, like the database session in this case.
But we need to attach the session to the request to be able to ensure a single session/database-connection is used through all the request, and then closed afterwards.
For us in this case, it helps us ensuring a single session/database-connection is used through all the request, and then closed afterwards (in the middleware).
In the near future, Starlette <a href="https://github.com/encode/starlette/issues/379" target="_blank">will have a way to attach custom objects to each request</a>.
When that happens, this tutorial will be updated to use the new official way of doing it.
## Create a `CustomBase` model