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 helyzetedAjánlott gyakorlatokok
Meg kell erősíteni, hogy a kimeneti struktúra teljes-eEllenőrizze, hogy a kulcs létezik-e a required-nélA 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-raA null azt jelenti, hogy nincs elérhető érték, és nem szabad 0-val kitölteni
Az eredeti szöveg kifejezetten nullát ad0 értéket használjonA 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átAdjon hozzá egy további status vagy reason mezőt, és határozza meg a megengedett értékeketKerü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 amount kulcs: A kimeneti struktúra hiányos, és szerződés kivétel.
  • amount for null: 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 a null-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.

adatAz állapot, amelyet ki kell fejezninem jeleníthető meg mint
Nincs összeg kulcsKimeneti szerződés kivételAz összeg nulla
az összeg nullaNincs elérhető értékA kivonás sikeres volt
összege 0egyértelmű nulla értéke vanHiányzó
az összeg egy ismeretlen karakterláncNem felel meg ennek a szerződésnekAutomatikusan 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

államiLétezik a kulcs?értékjelentése
Hiányzónemegyik semA kimeneti struktúra hiányos
null értékigennullJelenleg nincsenek elérhető értékek
nulla értékigen0explicit é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.

Próbálja ki most: Töltse fel a dokumentumot a fordítás megkezdéséhez, megtartva az eredeti elrendezést

Frissítve: 2026-11-16