mirror of https://github.com/tiangolo/fastapi.git
update translation of features.md
This commit is contained in:
parent
f80554f8d2
commit
0d0b105178
|
|
@ -6,12 +6,12 @@ A **FastAPI** a következőket nyújtja:
|
|||
|
||||
### Nyílt szabványokon alapul
|
||||
|
||||
* <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank"><strong>OpenAPI</strong></a> API létrehozásához, beleértve <abbr title="más néven: endpoints, routes">útvonal</abbr> <abbr title="más néven HTTP metódusok, mint POST, GET, PUT, DELETE">műveletek</abbr>, paraméterek, test kérések, biztonság stb.
|
||||
* Automatikus adatmodell-dokumentáció a <a href="https://json-schema.org/" class="external-link" target="_blank"><strong>JSON-sémával</strong></a> (mint Maga az OpenAPI a JSON-sémán alapul).
|
||||
* Ezen szabványok köré tervezve, alapos tanulmányozás után. Utólagos réteg helyett a tetején.
|
||||
* <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank"><strong>OpenAPI</strong></a> API létrehozásához, beleértve <abbr title="más néven: endpoints, routes">útvonal</abbr> <abbr title="más néven HTTP metódusok, mint POST, GET, PUT, DELETE">műveletek</abbr>, paraméterek, törzs kérések, biztonság stb.
|
||||
* Automatikus adatmodell-dokumentáció a <a href="https://json-schema.org/" class="external-link" target="_blank"><strong>JSON-sémával</strong></a> (mivel maga az OpenAPI is a JSON-sémán alapul).
|
||||
* Ezen szabványok köré tervezve, alapos tanulmányozás után. Nem csak egy utólagos rétegként a tetején.
|
||||
* Ez számos nyelven lehetővé teszi az automatikus **klienskód-generálás** használatát is.
|
||||
|
||||
### Automatikus dokumentumok
|
||||
### Automatikus dokumentációk
|
||||
|
||||
Interaktív API dokumentációs és felfedező webes felhasználói felületek. Mivel a keretrendszer OpenAPI-n alapul, több lehetőség is létezik, amelyek közül 2 alapértelmezés szerint benne van.
|
||||
|
||||
|
|
@ -27,7 +27,7 @@ Interaktív API dokumentációs és felfedező webes felhasználói felületek.
|
|||
|
||||
Mindez szabványos **Python 3.6 típusú** deklarációkon alapul (hála a Pydantic-nek). Nincs új megtanulandó szintaxis. Csak szabványos modern Python.
|
||||
|
||||
Ha 2 perces felfrissítésre van szüksége a Python-típusok használatáról (még ha nem is használja a FastAPI-t), tekintse meg a rövid oktatóanyagot: [Python Types](python-types.md){.internal-link target=_blank}.
|
||||
Ha 2 perces felfrissítésre van szüksége a Python-típusok használatáról (még ha nem is használja a FastAPI-t), tekintse meg a rövid oktatóanyagot: [Python Típusok](python-types.md){.internal-link target=_blank}.
|
||||
|
||||
A szabványos Python típusokat írod:
|
||||
|
||||
|
|
@ -64,19 +64,19 @@ my_second_user: User = User(**second_user_data)
|
|||
```
|
||||
|
||||
!!! info
|
||||
A "**második_felhasználói adatok" jelentése:
|
||||
A "**my_second_user" jelentése:
|
||||
|
||||
Közvetlenül adja át a `second_user_data` szótár kulcsait és értékeit kulcs-érték argumentumként, ami egyenértékű a következővel: `User(id=4, name="Mary", joined="2018-11-30")`
|
||||
|
||||
### Szerkesztő támogatás
|
||||
|
||||
Az összes keretrendszert úgy tervezték meg, hogy könnyen és intuitívan használható legyen, minden döntést több szerkesztőn is teszteltek még a fejlesztés megkezdése előtt, hogy a legjobb fejlesztési élményt biztosítsák.
|
||||
Az összes keretrendszert úgy tervezték meg, hogy könnyen és intuitívan lehessen használni, minden döntést több szerkesztőn is teszteltek még a fejlesztés megkezdése előtt, hogy a legjobb fejlesztési élményt biztosítsák.
|
||||
|
||||
A legutóbbi Python fejlesztői felmérésben egyértelmű volt, <a href="https://www.jetbrains.com/research/python-developers-survey-2017/#tools-and-features" class="external-link" target= "_blank">hogy a leggyakrabban használt funkció az "automatikus kiegészítés"</a>.
|
||||
|
||||
A teljes **FastAPI** keretrendszer ennek kielégítésére épül. Az automatikus kiegészítés mindenhol működik.
|
||||
|
||||
Ritkán kell visszamennie a dokihoz.
|
||||
Alig kell visszamennie a dokumentációhoz.
|
||||
|
||||
A szerkesztője a következőképpen segíthet Önnek:
|
||||
|
||||
|
|
@ -88,15 +88,15 @@ A szerkesztője a következőképpen segíthet Önnek:
|
|||
|
||||

|
||||
|
||||
Olyan kódot kapsz, amelyet korábban lehetetlennek tartottál. Például a „price” kulcs egy JSON-törzsben (amely lehet beágyazott), amely egy kérelemből származik.
|
||||
Olyan kódkiegészítést kap, amelyet korábban lehetetlennek tartott. Például a „price” kulcs egy JSON-törzsben (amely lehet beágyazott), amely egy kérelemből származik.
|
||||
|
||||
Nem kell többé rossz kulcsneveket begépelnie, oda-vissza lépkedni a dokumentumok között, vagy fel-le görgetni, hogy megtudja, hogy végre használta-e a "felhasználónév" vagy a "felhasználónév" értéket.
|
||||
Nem kell többé rossz kulcsneveket begépelni, oda-vissza lépkedni a dokumentumok között, vagy fel-le görgetni, hogy megtudja, hogy végre használta-e a `username` vagy a `user_name` értéket.
|
||||
|
||||
### Rövid
|
||||
|
||||
Mindenhez ésszerű **alapbeállításai** vannak, mindenhol választható konfigurációkkal. Az összes paraméter finomhangolható, hogy azt tegye, amire szüksége van, és amire az API-nak szüksége van.
|
||||
Mindenhez ésszerű **alapbeállítások** vannak, mindenhol választható konfigurációkkal. Az összes paraméter finomhangolható, hogy azt tegye, amire szüksége van, és amire az API-nak szüksége van.
|
||||
|
||||
De alapértelmezés szerint mindez **"csak működik"**.
|
||||
De alapértelmezés szerint minden **"csak működik"**.
|
||||
|
||||
### Érvényesítés
|
||||
|
||||
|
|
@ -104,7 +104,7 @@ De alapértelmezés szerint mindez **"csak működik"**.
|
|||
* JSON objektumok (`dict`).
|
||||
* JSON-tömb (`lista`), amely elemtípusokat határoz meg.
|
||||
* String (`str`) mezők, amelyek meghatározzák a minimális és maximális hosszúságot.
|
||||
* Számok ('int', 'float') min és max értékekkel stb.
|
||||
* Számok (`int`, `float`) min és max értékekkel stb.
|
||||
|
||||
* Érvényesítés az egzotikusabb típusokhoz, mint például:
|
||||
* URL.
|
||||
|
|
@ -121,7 +121,7 @@ Biztonság és azonosítás integrálva. Kompromisszumok nélkül az adatbáziso
|
|||
Az OpenAPI-ban meghatározott összes biztonsági séma, beleértve:
|
||||
|
||||
* HTTP Basic.
|
||||
* **OAuth2** (**JWT tokenekkel** is). Tekintse meg az [OAuth2 with JWT] (tutorial/security/oauth2-jwt.md){.internal-link target=_blank} oktatóanyagát.
|
||||
* **OAuth2** (**JWT tokenekkel** is). Tekintse meg az [OAuth2 with JWT](tutorial/security/oauth2-jwt.md){.internal-link target=_blank} oktatóanyagát.
|
||||
* API kulcsok:
|
||||
* Fejlécek.
|
||||
* Paraméterek lekérdezése.
|
||||
|
|
@ -154,15 +154,15 @@ Minden integrációt úgy terveztek meg, hogy olyan egyszerűen használható le
|
|||
* 100%-ban <abbr title="Python típusú megjegyzések, ezzel a szerkesztője és a külső eszközei jobb támogatást nyújtanak a">jegyzett</abbr> kódbázishoz.
|
||||
* Gyártási alkalmazásokban használják.
|
||||
|
||||
## A Starlette jellemzői
|
||||
## Starlette funkciók
|
||||
|
||||
A **FastAPI** teljes mértékben kompatibilis a <a href="https://www.starlette.io/" class="external-link" target="_blank"><strong>Starlette</strong>-tel (és azon alapul) </a>. Tehát minden további Starlette kód is működni fog.
|
||||
A **FastAPI** teljes mértékben kompatibilis a <a href="https://www.starlette.io/" class="external-link" target="_blank"><strong>Starlette</strong>-tel </a>, mivelhogy azon alapul. Tehát minden további Starlette kód is működni fog.
|
||||
|
||||
A „FastAPI” valójában a „Starlette” alosztálya. Tehát, ha már ismeri vagy használja a Starlette-et, a legtöbb funkció ugyanúgy fog működni.
|
||||
A `FastAPI` valójában a `Starlette` alosztálya. Tehát, ha már ismeri vagy használja a Starlette-et, a legtöbb funkció ugyanúgy fog működni.
|
||||
|
||||
A **FastAPI** segítségével megkapja a **Starlette** összes funkcióját (mivel a FastAPI csak Starlette szteroidokon):
|
||||
|
||||
* Komolyan lenyűgöző teljesítmény. Ez <a href="https://github.com/encode/starlette#performance" class="external-link" target="_blank">az egyik leggyorsabb Python-keretrendszer, amely egyenrangú a **NodeJS-szel** és **Go-val**</a>.
|
||||
* Komolyan lenyűgöző teljesítmény. Ez <a href="https://github.com/encode/starlette#performance" class="external-link" target="_blank">az egyik leggyorsabb Python-keretrendszer, amely egyenrangú a **NodeJS-sel** és **Go-val**</a>.
|
||||
* **WebSocket** támogatás.
|
||||
* Folyamat közbeni háttérfeladatok.
|
||||
* Indítási és leállítási események.
|
||||
|
|
@ -184,15 +184,15 @@ Ugyanez fordítva is érvényes, sok esetben az adatbázisból kapott objektumot
|
|||
|
||||
A **FastAPI** segítségével megkapja a **Pydantic** összes funkcióját (mivel a FastAPI a Pydanticon alapul az összes adatkezeléshez):
|
||||
|
||||
**Nincs agyafúrás**:
|
||||
* **Nincs agyafúrás**:
|
||||
* Nincs új megtanulni való sémadefiníciós mikronyelv.
|
||||
* Ha ismeri a Python típusokat, tudja, hogyan kell használni a Pydantic-ot.
|
||||
* Szépen kapcsolódik az **<abbr title="Integrated Development Environment, hasonló a kódszerkesztőhöz">IDE</abbr>/<abbr title="A program, amely ellenőrzi a kódhibákat">linter</abbr>/brain **-hez:
|
||||
* Szépen kapcsolódik az **<abbr title="Integrated Development Environment, hasonló a kódszerkesztőhöz">IDE</abbr>/<abbr title="A program, amely ellenőrzi a kódhibákat">linter</abbr>/agy**-hez:
|
||||
* Mivel a pydantikus adatstruktúrák csak az Ön által meghatározott osztályok példányai; Az automatikus kiegészítésnek, a lintingnek, a mypy-nek és az intuíciónak mind megfelelően működnie kell az ellenőrzött adatokkal.
|
||||
* Érvényesítsen **összetett struktúrákat**:
|
||||
* Hierarchikus Pydantic modellek, Python "gépelés" listák és szótárak stb. használata.
|
||||
* Hierarchikus Pydantic modellek, Python típusú listák és szótárak stb. használata.
|
||||
* Az érvényesítők pedig lehetővé teszik az összetett adatsémák egyértelműen és egyszerűen definiálását, ellenőrzését és JSON-sémaként dokumentálását.
|
||||
* Mélyen **beágyazott JSON** objektumokkal rendelkezhet, és mindegyiket ellenőrizheti és megjegyzésekkel látja el.
|
||||
**Bővíthető**:
|
||||
* **Bővíthető**:
|
||||
* A Pydantic lehetővé teszi egyéni adattípusok meghatározását, vagy kiterjesztheti az érvényesítést módszerekkel a validátor dekorátorral díszített modelleken.
|
||||
* 100%-os tesztlefedettség.
|
||||
|
|
|
|||
Loading…
Reference in New Issue