Зачем нужна JSON строка?

JSON строка — универсальный формат обмена данными

JSON (JavaScript Object Notation) — это текстовый формат для представления структурированных данных. Он стал стандартом в веб-разработке благодаря простоте и универсальности.

Основная цель

JSON решает проблему передачи сложных структур данных между различными системами:

# ❌ Неправильно — передаём Python объект
user = {"name": "Alice", "age": 30, "roles": ["admin", "user"]}
print(user)  # Python видит это, JS — нет

# ✅ Правильно — преобразуем в JSON строку
import json
user_json = json.dumps(user)
print(user_json)  # {"name": "Alice", "age": 30, "roles": ["admin", "user"]}
# Это может прочитать любой язык программирования

Почему JSON, а не другие форматы?

Преимущества JSON:

• Универсален — поддерживают все языки (Python, JS, Go, Rust, C#)
• Человеко-читаем — легко отлаживать
• Компактный — меньше данных по сети, чем XML
• Стандарт индустрии — везде используется
• Быстрый парсинг — минимум обработки

XML:   <user><name>Alice</name><age>30</age></user>  (47 символов)
JSON:  {"name":"Alice","age":30}                     (27 символов)
CSV:   Alice,30                                       (8 символов)

Типичные применения

1. REST API (самое частое)

# FastAPI автоматически сериализует в JSON
from fastapi import FastAPI
from pydantic import BaseModel

class User(BaseModel):
    name: str
    age: int
    roles: list

app = FastAPI()

@app.get("/users/{user_id}")
async def get_user(user_id: int):
    user = User(name="Alice", age=30, roles=["admin", "user"])
    # FastAPI автоматически преобразует в JSON:
    # {"name":"Alice","age":30,"roles":["admin","user"]}
    return user

2. Сохранение в БД

import json
from sqlalchemy import Column, String

class UserProfile(Base):
    __tablename__ = "user_profiles"
    
    id = Column(Integer, primary_key=True)
    # Сохраняем сложные данные как JSON
    preferences = Column(String)  # JSON строка

# Сохраняем
prefs = {"theme": "dark", "notifications": True}
profile = UserProfile(preferences=json.dumps(prefs))
db.add(profile)
db.commit()

# Читаем обратно
loaded = db.query(UserProfile).first()
prefs = json.loads(loaded.preferences)
print(prefs["theme"])  # "dark"

Или с PostgreSQL JSON типом:

from sqlalchemy import JSON, Column

class UserProfile(Base):
    __tablename__ = "user_profiles"
    preferences = Column(JSON)  # БД сама управляет JSON

# Просто работаем как с dict
profile.preferences["theme"] = "light"
db.commit()

3. Конфигурационные файлы

{
  "database": {
    "host": "localhost",
    "port": 5432,
    "name": "myapp"
  },
  "redis": {
    "host": "localhost",
    "port": 6379
  },
  "logging": {
    "level": "INFO"
  }
}

import json

with open('config.json') as f:
    config = json.load(f)

db_url = f"postgresql://{config['database']['host']}:{config['database']['port']}/{config['database']['name']}"

4. Логирование структурированных данных

import json
import logging

logger = logging.getLogger(__name__)

event_data = {
    "user_id": 123,
    "action": "login",
    "ip": "192.168.1.1",
    "timestamp": "2024-03-22T10:30:00Z"
}

# Логируем как JSON (удобно для парсинга логов)
logger.info(json.dumps(event_data))
# [2024-03-22 10:30:00] {"user_id":123,"action":"login","ip":"192.168.1.1","timestamp":"2024-03-22T10:30:00Z"}

Преобразование между Python и JSON

import json
from datetime import datetime

# Python → JSON (сериализация)
data = {
    "name": "Alice",
    "age": 30,
    "active": True,
    "roles": ["admin", "user"],
    "metadata": {"created": "2024-03-22"}
}

json_string = json.dumps(data)  # Преобразуем в строку
print(json_string)
# {"name": "Alice", "age": 30, "active": true, "roles": ["admin", "user"], "metadata": {"created": "2024-03-22"}}

# JSON → Python (десериализация)
data_back = json.loads(json_string)  # Преобразуем обратно
print(data_back["name"])  # "Alice"
print(type(data_back["active"]))  # <class 'bool'>

Типы данных JSON

JSON Тип    → Python Тип
object      → dict
array       → list
string      → str
number      → int/float
true        → True
false       → False
null        → None

Практический пример: Telegram Bot

import json
from typing import Optional

class UserState:
    def __init__(self, user_id: int, state: str):
        self.user_id = user_id
        self.state = state  # Какой step вопроса
        self.answers = {}  # Ответы на вопросы
    
    def to_json(self) -> str:
        """Сохраняем состояние в JSON для БД"""
        return json.dumps({
            "user_id": self.user_id,
            "state": self.state,
            "answers": self.answers
        })
    
    @classmethod
    def from_json(cls, json_str: str) -> 'UserState':
        """Восстанавливаем состояние из JSON"""
        data = json.loads(json_str)
        obj = cls(data["user_id"], data["state"])
        obj.answers = data["answers"]
        return obj

# Использование
state = UserState(user_id=123, state="waiting_for_name")
state.answers["step1"] = "Alice"

# Сохраняем в БД
json_data = state.to_json()
db.save(user_id=123, state_json=json_data)

# Восстанавливаем из БД
loaded_json = db.load(user_id=123)
loaded_state = UserState.from_json(loaded_json)

Обработка ошибок

import json

# ❌ Может быть ошибка
try:
    data = json.loads('{"invalid": json}')
except json.JSONDecodeError as e:
    print(f"❌ Ошибка парсинга JSON: {e}")

# ✅ Безопасно
def parse_json(json_str: str) -> dict:
    try:
        return json.loads(json_str)
    except json.JSONDecodeError:
        return {"error": "Invalid JSON"}

Итог

JSON строка нужна для:

✅ Обмен данными между различными системами и языками
✅ REST API — стандартный формат запрос-ответ
✅ Хранение сложных структур в БД
✅ Конфигурация приложений
✅ Логирование структурированных данных
✅ Состояние сессий и кэширование

JSON — это lingua franca веб-разработки. Везде используется, везде поддерживается.