Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Atbalstītie tipi un JSON shēmas

Nodarbība 2 no 12 Atjaunota 2026. gada 30. jūlijs Programmētājs
Šajā lapā
  1. Tavu shēmu pamatelementi
  2. Septiņi atbalstītie tipi
  3. Tipu kombinēšana
  4. Neobligātie lauki
  5. Galvenās atziņas

Tavu shēmu pamatelementi

Lai definētu savu atbilžu struktūru, tev ir pieejami septiņi JSON tipi. Katrs no tiem kalpo konkrētam mērķim datu modelēšanā. Šo tipu izpratne ir būtiska, lai izveidotu efektīvas shēmas.

Septiņi atbalstītie tipi

string (virkne)

Visizplatītākais tips. To izmanto nosaukumiem, aprakstiem, identifikatoriem un jebkuram teksta saturam.

{
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "description": { "type": "string" }
  }
}

number (skaitlis)

Aptver gan veselos skaitļus, gan decimāldaļskaitļus. Nav atšķirības starp integer un float — viens vienīgs number tips apstrādā abus.

{
  "properties": {
    "price": { "type": "number" },
    "quantity": { "type": "number" }
  }
}

boolean (loģiskais)

Patiesi vai nepatiesi. Ideāli piemērots karodziņiem, validācijām un bināriem lēmumiem.

{
  "properties": {
    "in_stock": { "type": "boolean" },
    "express_delivery": { "type": "boolean" }
  }
}

object (objekts)

Ļauj ligzdot struktūras. Objekts var saturēt citus objektus, masīvus vai skalāras vērtības bez dziļuma ierobežojuma.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "object",
      "properties": {
        "street": { "type": "string" },
        "city": { "type": "string" },
        "postal_code": { "type": "string" }
      }
    }
  }
}

array (masīvs)

Viena tipa elementu saraksti. Tev var būt virkņu, skaitļu, objektu vai pat masīvu masīvi.

{
  "properties": {
    "skills": {
      "type": "array",
      "items": { "type": "string" }
    }
  }
}

enum (enumerācija)

Gala skaits atļauto vērtību. Būtisks kategorizācijai un klasifikācijai.

{
  "properties": {
    "priority": {
      "type": "string",
      "enum": ["low", "medium", "high", "critical"]
    }
  }
}

anyOf

Ļauj definēt tipu apvienojumus. Lauks var pieņemt vairākas dažādas struktūras. Noderīgi, ja vienam laukam var būt dažādas formas.

{
  "properties": {
    "contact": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "email": { "type": "string" }
          }
        },
        {
          "type": "object",
          "properties": {
            "phone": { "type": "string" }
          }
        }
      ]
    }
  }
}

Tipu kombinēšana

Shēmu spēks slēpjas šo tipu kombinēšanā. Lūk, reālistiska shēma produkta analīzei:

{
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "price": { "type": "number" },
    "in_stock": { "type": "boolean" },
    "category": {
      "type": "string",
      "enum": ["electronics", "clothing", "grocery", "other"]
    },
    "tags": {
      "type": "array",
      "items": { "type": "string" }
    },
    "manufacturer": {
      "type": "object",
      "properties": {
        "name": { "type": "string" },
        "country": { "type": "string" }
      }
    }
  }
}

Šī shēma apvieno skalārus, enumerāciju, masīvu un ligzdotu objektu. Modelis ievēros katru ierobežojumu katrā izsaukumā.

Neobligātie lauki

Lai padarītu lauku neobligātu, izmanto anyOf kopā ar null:

{
  "properties": {
    "phone": {
      "anyOf": [
        { "type": "string" },
        { "type": "null" }
      ]
    }
  }
}

Pydantic vidē tas atbilst phone: str | None.

Galvenās atziņas

  • Pieejami septiņi tipi: string, number, object, array, boolean, enum, anyOf
  • Tipus var brīvi kombinēt, lai modelētu sarežģītas struktūras
  • Neobligātiem laukiem izmanto anyOf kopā ar null
  • Nav atšķirības starp veseliem un decimāldaļskaitļiem — viens vienīgs number tips
  • enum piespiež izmantot iepriekš definētas vērtības klasifikācijai