CodeGym /Cursos /C# SELF /Fundamentos del formato JSON y su popularidad

Fundamentos del formato JSON y su popularidad

C# SELF
Nivel 43, Lección 4
Disponible

1. Introducción

Si alguna vez abriste APIs modernas, trabajaste con web-services, aplicaciones móviles o incluso intentaste guardar algo en un "formato universal" — ya te has topado o te toparás con JSON. Es ese formato que literalmente "conecta" distintos lenguajes de programación y hasta plataformas: C#, JavaScript, Python — todos hablan mediante JSON.

¿Por qué JSON se convirtió en la estrella de la serialización? La respuesta es sencilla: es un formato de texto compacto, legible por humanos y ligero para el intercambio de datos estructurados. Su popularidad viene de la combinación de simplicidad, versatilidad y excelente soporte en los lenguajes de programación.

¿Qué es JSON?

JSON viene de JavaScript Object Notation. El formato nació en el mundo de JavaScript, pero rápidamente salió del navegador al resto del ecosistema. Importante: pese al origen del nombre, JSON no está ligado a JavaScript y es igual de útil en todos los lenguajes.

El formato fue inventado a principios de los 2000 por Douglas Crockford como una alternativa más simple al verboso XML. La idea es simple: «JSON es más corto, más simple y más fácil de leer para las personas».

2. Reglas básicas del formato JSON

Lo principal: JSON es un formato estrictamente definido de tipo texto para datos estructurados. Nada de magia, solo texto normal que puedes abrir en cualquier editor.

Construcciones básicas:

  • Arrays (arrays): listas ordenadas de valores.
  • Objetos (objects): conjuntos de pares clave-valor.
  • Tipos simples: strings, numbers, booleanos (true, false) y el valor especial null.

Ejemplo de documento JSON mínimo:

{
    "name": "Ivan",
    "age": 25,
    "isStudent": true,
    "scores": [5, 4, 5, 3],
    "contacts": {
        "email": "ivan@example.com",
        "phone": null
    }
}

Estructura esquemática

Aquí tienes una tabla de correspondencias entre tipos en C# y su representación en JSON:

Tipo C# Ejemplo JSON
string
"name": "Ivan"
int, double
"score": 5
bool
"isStudent": true
array (int[], ...)
"scores": [5,4,5,3]
objeto (class, ...)
"contacts": { ... }
null
"phone": null

Reglas para escribir JSON

  1. Strings siempre entre comillas dobles: 'text' — error, correcto "text".
  2. Las claves de objetos son strings entre comillas dobles: por ejemplo, "name": ...
  3. Comas solo entre elementos, sin coma final después del último elemento.
  4. La indentación no es obligatoria, pero mejora la legibilidad.
  5. Números sin comillas: "age": 25, no "age": "25".
  6. Booleanos — true/false (sin comillas), no True, FALSE o "true".
  7. null se escribe como null (sin comillas).

3. JSON visto por un programador

Analogías con tipos en C#:

  • JSON-object ≈ Dictionary<string, object>
  • JSON-array ≈ T[] o List<T>
  • JSON-string ≈ cadena normal
  • JSON-number ≈ int o double (depende del valor)

Ejemplo de serialización de un objeto a JSON

Clase:

public class Student
{
    public string Name { get; set; } = "";
    public int Age { get; set; }
    public bool IsStudent { get; set; }
    public int[] Scores { get; set; } = Array.Empty<int>();
}

JSON resultante (simplificamos, los detalles de la serialización más adelante):

{
    "Name": "Ivan",
    "Age": 25,
    "IsStudent": true,
    "Scores": [5, 4, 5, 3]
}

4. Ejemplos de estructuras JSON válidas

Objeto con array y objetos anidados

{
  "product": "Cafe",
  "price": 125.50,
  "inStock": true,
  "attributes": {
    "weight": 500,
    "unit": "gr"
  },
  "tags": ["drink", "energia", "arabica"],
  "promotions": null
}

Array de objetos

[
  {"id": 1, "name": "Petya"},
  {"id": 2, "name": "Masha"},
  {"id": 3, "name": "Vasya"}
]

5. Ejemplos de JSON inválido (y por qué)

Comillas simples:

{ 'name': 'Ivan' } // ¡Error!

JSON requiere comillas dobles.

Coma después del último elemento:

{ "x": 1, "y": 2, } // ¡Error!

Una coma extra al final no está permitida.

Comentarios:

{
  // Esto bonito, por desgracia, no funciona en JSON
  "name": "Ivan"
}

JSON no tiene comentarios.

6. ¿Para qué sirve JSON en proyectos reales?

Intercambio de datos entre sistemas

JSON es el "lenguaje común" universal entre distintas aplicaciones, habitualmente sobre HTTP. Por ejemplo, un servidor en C# se comunica con un frontend en JavaScript — su formato común es JSON.

Almacenamiento de configuraciones y datos

Muchas aplicaciones guardan configuraciones en archivos .json. Por ejemplo, appsettings.json es el estándar para aplicaciones .NET. Ventajas: fácil de leer, modificar y versionar.

APIs server y móviles

La mayoría de REST API usan JSON como formato de request y response: por ejemplo, la lista de usuarios llega como un array de objetos.

Configuración de herramientas y librerías

Muchas herramientas en .NET (Serilog, Swagger y otras) usan JSON para configuraciones. XML aparece cada vez menos — JSON es más compacto y claro.

7. Popularidad de JSON: ¿por qué todo el mundo lo quiere?

  • Legibilidad. Incluso alguien no técnico entiende qué va con qué.
  • Facilidad para transmitir por la red. Texto plano, poco "peso".
  • Soporte en todos los lenguajes. Serialización/deserialización disponible "out of the box".
  • Útil para configuraciones. Cualquier editor lo maneja bien.
  • Fácil de generar. Crear JSON es muy sencillo.
  • Arrays, anidamiento, null. Todo es intuitivo, sin la "fiebre de paréntesis" del XML.

¿Cuándo elegir JSON?

  • Estás creando una app móvil o web;
  • Trabajas con APIs de servicios externos;
  • Quieres que tu app sea amigable para futuras integraciones.

8. Cómo C# trabaja con JSON

Brevemente sobre librerías populares en .NET:

Ejemplo mínimo de serialización/deserialización:

using System.Text.Json;

// Convertimos un objeto a string JSON
var student = new Student { Name = "Ivan", Age = 25, IsStudent = true, Scores = new[] {5, 4, 5, 3} };
string json = JsonSerializer.Serialize(student);

// Y al revés: leemos un objeto desde una string JSON
Student? parsed = JsonSerializer.Deserialize<Student>(json);

Console.WriteLine(json);

9. Errores típicos de principiantes al trabajar con JSON

Un error frecuente — confundir comillas o olvidar una coma. A veces intentan añadir comentarios (como en C# — ¡es cómodo!), pero JSON no lo permite.

Otra situación común — serializar objetos con colecciones no inicializadas: como resultado obtenemos "scores": null en vez del array esperado. Inicializa las colecciones antes.

Recuerda que JSON es texto: grandes volúmenes ocupan mucha memoria. Si serializas, digamos, 500 MB en JSON, la app puede notarlo seriamente en rendimiento.

2
Tarea
C# SELF, nivel 43, lección 4
Bloqueada
Lectura de datos desde un archivo binario
Lectura de datos desde un archivo binario
1
Cuestionario/control
Introducción a la serialización, nivel 43, lección 4
No disponible
Introducción a la serialización
Concepto de serialización de datos
Comentarios
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION