A hiányzó mezők és a null mezők két különböző hiba.
A "Mező nem található" és a "Mező null érték" üresen jelenhet meg a felületen, de nem szabad összekeverni a programba való belépés után. Ezután töltse ki az üres helyeket a nulla számmal, és a probléma finomabb lesz: a downstream jogi értéket kap, de azt hiszi, hogy az eredeti szövegből származik.
Ha a mező nem található, vagy a mező nullértékkel rendelkezik, akkor előfordulhat, hogy csak üresen jelenik meg a felületen, de a programba való belépés után teljesen más a jelentés. Ha az üres helyet nulla számmal tölti ki, a downstream jogi értéket kap, de tévesen azt gondolja, hogy az eredeti szövegből származik, és nehezebb lesz megtalálni a problémát.
Ez a cikk azoknak a fejlesztőknek és dokumentumkezelőknek szól, akiknek át kell adniuk a kinyerési eredményeket a programoknak feldolgozásra. Elmagyarázza, hogyan használhatja a JSON-sémát három állapot megkülönböztetésére, és hogyan használhat több bemeneti mintát a regressziós ellenőrzésekhez. Ennek elolvasása után beállíthatja a hiányzó, nulla és nulla értékek határait saját adatprotokolljában.
A cikkben szereplő minták szintetikus adatok, és a kódot példákkal ellenőrizték izolált környezetben, de ez nem jelent garanciát minden valódi fájlra vagy termékhatásra. A fontos dokumentumok feldolgozása előtt kérjük, őrizze meg az eredeti példányokat és nézze át a szövegben szereplő határok és átvételi tételek szerint.
Egy mondatos következtetés
A mező hiányzik, az értéke null, az érték pedig 0. Három különböző állapotnak kell lennie. A szerződésnek fel kell használnia a kulcs meglétét és az értéktípust ezek elkülönítésére. Nem támaszkodhat az interfészre vagy a későbbi találgatásokra.
| a helyzeted | Ajánlott gyakorlatok | ok |
|---|---|---|
| Meg kell erősíteni, hogy a kimeneti struktúra teljes-e | Ellenőrizze, hogy a kulcs létezik-e a required-nél | A hiányzó kulcsok azt jelzik, hogy a kimeneti struktúra nem teljes, és nem egyenlő nullával. |
| Az eredeti cikkben nem áll rendelkezésre összeg | Állítsa be az értéket null-ra | A null azt jelenti, hogy nincs elérhető érték, és nem szabad 0-val kitölteni |
| Az eredeti szöveg kifejezetten nullát ad | 0 értéket használjon | A nulla egy egyértelmű érték, ellentétben a hiányzó és null értékekkel |
| Meg kell magyarázni a kivonás elmaradásának okát | Adjon hozzá egy további status vagy reason mezőt, és határozza meg a megengedett értékeket | Kerülje az ok beírását a mennyiségi karakterláncba, hogy csökkentse a későbbi szétszerelést |
Először válassza szét a három állapotot
Ennek a cikknek az összeállítási szerződésében a amount-nek jelen kell lennie, számértékek vagy null megengedettek. A három állapot jelentése a következő:
- Nincs
amountkulcs: A kimeneti struktúra hiányos, és szerződés kivétel. amountfornull: A kulcs létezik, de jelenleg nem áll rendelkezésre összeg.amountértéke 0: Egyértelmű nulla érték van.
Más protokollok is használhatók valódi üzleti célokra, de azokat világosan meg kell írni, és nem lehet mindegyik hívó kitalálni.
A JSON-séma required-je a kulcs meglétének ellenőrzéséért, a type pedig az érték típusának ellenőrzéséért felelős. Két gyakori tévhit külön figyelmet igényel:
- Csak a
requiredírása nem tiltja le automatikusan anull-t. - Csak a mező meghatározása a
properties-ben nem szükséges, hogy megjelenjen.
Mindkét pont alkalmas arra, hogy közvetlenül regressziós tesztekbe írjunk. Az objektumok és a required teljes meghatározását a JSON-séma objektumok és kötelező részben találja.
Ellenőrizze a szerződést négy bemenettel
from jsonschema import Draft202012Validator
schema = {"type": "object", "required": ["amount"],
"properties": {"amount": {"type": ["number", "null"]}},
"additionalProperties": False}
validator = Draft202012Validator(schema)
valid = lambda value: not list(validator.iter_errors(value))
assert valid({"amount": None})
assert valid({"amount": 0})
assert not valid({})
assert not valid({"amount": "unknown"})
assert not valid({"amount": None, "guessed": True})
A jsonschema programot futtatás előtt telepíteni kell. Ez a kód csak szerkezetellenőrzést végez a memóriában, nem hívja meg a kinyerési modellt, és nem tudja bizonyítani, hogy egy bizonyos mennyiség összhangban van az eredeti szöveggel.
Ha az összeg pontos decimális ábrázolást igényel, akkor helyette a decimális karakterlánc protokoll használható. Ne csak a bináris lebegőpontos számításokra gondoljon pénzügyi megoldásként, csak azért, mert a példa a number-t használja.
A felületnek egyértelműen fel kell tüntetnie az állapotot.
Az interfész kijelzőjének is különbséget kell tennie az állapotok között, különben a felhasználók félreértelmezik a különböző jelentéseket ugyanazon eredményként.
| adat | Az állapot, amelyet ki kell fejezni | nem jeleníthető meg mint |
|---|---|---|
| Nincs összeg kulcs | Kimeneti szerződés kivétel | Az összeg nulla |
| az összeg nulla | Nincs elérhető érték | A kivonás sikeres volt |
| összege 0 | egyértelmű nulla értéke van | Hiányzó |
| az összeg egy ismeretlen karakterlánc | Nem felel meg ennek a szerződésnek | Automatikusan nullává konvertálva és hangtalanul átadva |
Ne írjon be hiányzó okokat a numerikus mezőkbe
Ha különbséget kell tennie a „nem biztosított eredeti szöveg", a „nem olvasható kép", a „jelölt ütközés"stb. között, hozzáadhat egy továbbistatus vagy reason mezőt, és megadhatja az engedélyezett értékeket.
Ne írja be az okot egy összeg karakterláncba, majd a downstream húzza ki belőle a számokat. Az ismeretlen nem ugyanaz, mint a hiba: egyes dokumentumok nem rendelkeznek ezzel a mezővel, és a helyes eredmény az, hogy ismeretlenül hagyjuk.
📊 Alapvető összehasonlítás
| állami | Létezik a kulcs? | érték | jelentése |
|---|---|---|---|
| Hiányzó | nem | egyik sem | A kimeneti struktúra hiányos |
| null érték | igen | null | Jelenleg nincsenek elérhető értékek |
| nulla érték | igen | 0 | explicit érték nulla |
🎯 Melyik módszer illik hozzád?
Ha ellenőriznie kell, hogy az interfész kimenet kész-e
A required segítségével ellenőrizze, hogy létezik-e a kulcs. A hiányzó kulcs közvetlenül szerződési kivételnek minősül.
Ha a dokumentum gyakran nem tartalmaz egy bizonyos mezőt
Hagyja, hogy ez a mező értéke null legyen, és adja meg az okot status vagy reason formában.
Ha az összeget pontosan kell kiszámítani
Vegye figyelembe a decimális karakterlánc protokollt, és ne hagyatkozzon közvetlenül a bináris lebegésekre.
Ha fordítást vagy ellenőrzést szeretne végezni a kivonás után
Ellenőrizze együtt a pénznemet, a származást és a megfelelő címkéket, hogy megbizonyosodjon arról, hogy a kulcsszámokat nem változtatták meg véletlenül.
❓ Gyakran Ismételt Kérdések (GYIK)
1. Ha csak kötelezőt írsz, az letiltja a nullt?
nem. A required csak azt ellenőrzi, hogy a kulcs létezik-e, a null letiltását külön meg kell határozni a type-ben.
2. Mi a különbség aközött, hogy egy mező nulla és egy mező 0?
A null azt jelenti, hogy jelenleg nincs elérhető érték, a 0 pedig egyértelmű érték. Mindkettőnek szerepelnie kell a szerződésben és a felületen.
3. A legális JSON azt jelenti, hogy a kivonatolás eredménye pontos?
Nem azt jelenti. A szerkezeti ellenőrzés csak azt tudja megerősíteni, hogy a formátum összhangban van a szerződéssel, de nem tudja igazolni, hogy az összeg megegyezik az eredeti szöveggel.
4. Megjeleníthető a mező közvetlenül 0-ként, ha hiányzik?
Nem ajánlott. A hiányzó azt jelenti, hogy a kimeneti struktúra nem teljes. A 0 kitöltése azt eredményezi, hogy a downstream a valós mennyiségként kezeli.
📝 Összefoglaló
A hiányzó, nulla és nulla értékeknek megvan a maguk jelentése, és ezeket külön kell kifejezni szerződéseken és interfészeken keresztül. A szerkezet jóváhagyása után még ellenőrizni kell az összeg pénznemét, forrását és megfelelő címkéjét.


