🌐 Add Russian translation for docs/ru/docs/tutorial/middleware.md
#10538
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
📝 Docs preview for commit a3d640c at: https://14559915.fastapitiangolo.pages.dev |
tiangolo
added
lang-all
s111d
reviewed
Jan 7, 2024
|
|
||
| * Он принимает каждый **запрос**, поступающий в ваше приложение. | ||
| * Затем он может что-то сделать с этим **запросом** или выполнить любой необходимый код. | ||
| * Затем он передает **запрос** на обработку в *операцию пути*. |
There was a problem hiding this comment.
...в оставшуюся часть приложения (через операцию пути)
s111d
reviewed
Jan 7, 2024
|
|
||
| В приложения **FastAPI** можно добавлять мидлвары. | ||
|
|
||
| Мидлвар - это функция, которая работает с каждым **запросом** до того, как он будет обработан какой-либо *операцией пути*. А также с каждым **ответом** перед его возвратом клиенту. |
There was a problem hiding this comment.
...перед отправкой его клиенту.
s111d
reviewed
Jan 7, 2024
| @@ -0,0 +1,61 @@ | |||
| # Мидлвар | |||
There was a problem hiding this comment.
Так себе транслитерация. Есть русские "промежуточное ПО" либо "промежуточный слой кода". Как вариант – переводить по-русски, а в скобках писать (middleware).
s111d
reviewed
Jan 7, 2024
| * Он принимает каждый **запрос**, поступающий в ваше приложение. | ||
| * Затем он может что-то сделать с этим **запросом** или выполнить любой необходимый код. | ||
| * Затем он передает **запрос** на обработку в *операцию пути*. | ||
| * Затем принимается **ответ**, сгенерированный *операцией пути*. |
There was a problem hiding this comment.
Затем он принимает ответ созданный приложением (какой-либо операцией пути)
s111d
reviewed
Jan 7, 2024
| * Он может что-то сделать с этим **ответом** или выполнить любой необходимый код. | ||
| * Затем он возвращает **ответ**. | ||
|
|
||
| !!! note "Технические детали" |
s111d
reviewed
Jan 7, 2024
| * Затем он возвращает **ответ**. | ||
|
|
||
| !!! note "Технические детали" | ||
| Если у вас есть зависимости с `yield`, то код выхода (finally) будет выполняться *после* мидлвар. |
s111d
reviewed
Jan 7, 2024
| !!! note "Технические детали" | ||
| Если у вас есть зависимости с `yield`, то код выхода (finally) будет выполняться *после* мидлвар. | ||
|
|
||
| Если были фоновые задачи (описанные позже), то они будут выполняться *после* всех промежуточных программ. |
There was a problem hiding this comment.
(описанные НИЖЕ)
всех промежуточных программ –> всего промежуточного ПО
s111d
reviewed
Jan 7, 2024
|
|
||
| ## Создание мидлвар | ||
|
|
||
| Для создания мидлвар используется декоратор `@app.middleware("http")` поверх функции. |
There was a problem hiding this comment.
можно просто "перед функцией" или "к функции применяется декоратор..."
s111d
reviewed
Jan 7, 2024
|
|
||
| Но если у вас есть пользовательские заголовки, чтобы их мог видеть клиент в браузере, вам необходимо добавить их в CORS-конфигурации ([CORS (Cross-Origin Resource Sharing)](cors.md){.internal-link target=_blank}) с помощью параметра `expose_headers`, описанного в <a href="https://www.starlette.io/middleware/#corsmiddleware" class="external-link" target="_blank">документации по CORS в библиотеке Starlette</a>. | ||
|
|
||
| !!! note "Технические детали" |
s111d
reviewed
Jan 7, 2024
|
|
||
| **FastAPI** предоставляет его в качестве удобства для вас, разработчика. Но он поставляется непосредственно из Starlette. | ||
|
|
||
| ### До и после `ответа` |
There was a problem hiding this comment.
вряд ли здесь стоит переводить Response, т.к. имеется в виду объект.
s111d
reviewed
Jan 7, 2024
|
|
||
| Более подробно о других мидлварах вы можете прочитать в разделе [Расширенное руководство пользователя: Продвинутый мидлвар](../advanced/middleware.md){.internal-link target=_blank}. | ||
|
|
||
| О том, как управлять <abbr title="Cross-Origin Resource Sharing">CORS</abbr> с помощью мидлвар, вы узнаете в следующем разделе. |
There was a problem hiding this comment.
возможно, лучше "перехватывать"
|
As this PR had requested changes to be applied but has been inactive for a while, it's now going to be closed. But if there's anyone interested, feel free to create a new PR. |
|
sorry for the late response, and thank you
…________________________________
From: Sebastián Ramírez ***@***.***>
Sent: Wednesday, February 7, 2024 9:14 PM
To: tiangolo/fastapi ***@***.***>
Cc: Subscribed ***@***.***>
Subject: Re: [tiangolo/fastapi] 🌐 Add Russian translation for `docs/ru/docs/tutorial/middleware.md` (PR #10538)
Closed #10538<#10538>.
—
Reply to this email directly, view it on GitHub<#10538 (comment)>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/BE7DINCA2ZJRXCJFUSDXFE3YSQ7LDAVCNFSM6AAAAAA6T7UBAOVHI2DSMVQWIX3LMV45UABCJFZXG5LFIV3GK3TUJZXXI2LGNFRWC5DJN5XDWMJRG42DAMRZGUZTQMQ>.
You are receiving this because you are subscribed to this thread.Message ID: ***@***.***>
|
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
No description provided.