everit-org/json-schema
Json Schema
Este proyecto es una biblioteca Java diseñada para validar documentos JSON contra especificaciones de esquema definidas. Funciona como un motor compatible con estándares que garantiza la integridad de los datos verificando el cumplimiento estructural y aplicando reglas de negocio dentro de las aplicaciones Java.
La biblioteca se distingue por sus estrategias de validación flexibles, permitiendo a los desarrolladores inyectar lógica personalizada y motores de coincidencia de patrones para manejar formatos de datos especializados. Admite modos de ejecución configurables, permitiendo a los usuarios detener la validación inmediatamente tras el primer error o recopilar todas las violaciones para un informe integral. Además, el motor incluye capacidades integradas para la coerción de tipos y la inyección de valores predeterminados, lo que ayuda a normalizar los datos entrantes durante el proceso de validación.
Más allá de las comprobaciones estructurales estándar, el sistema proporciona características avanzadas para gestionar dependencias de datos complejas y restricciones de seguridad. Incluye un registro local para resolver referencias de esquema sin acceso a la red y admite la aplicación de patrones de acceso de solo lectura o solo escritura. La biblioteca también ofrece herramientas de observabilidad, como hooks basados en eventos que permiten a los sistemas externos monitorear el proceso de validación interno.
Features
- Structural Data Validators - Validates JSON documents against defined schema specifications to ensure structural integrity.
- JSON Schema Validation - Provides a standards-compliant engine for validating JSON documents against defined schema specifications.
- Request Data Integrity - Validates incoming JSON payloads against schema specifications to ensure data integrity before backend processing.
- Java Validation Libraries - Offers a Java-native library for enforcing structural constraints and data integrity through configurable validation rules.
- Pluggable Body Validators - Allows developers to inject custom validation logic and pattern-matching engines to extend standard schema enforcement.
- Data Normalization Utilities - Normalizes incoming data by coercing types and injecting default values to ensure consistent internal data models.
- Data Type Coercion - Automatically transforms string-encoded inputs into primitive types during validation to ensure schema compatibility.
- First Matching Item Retrievers with Error Handling - Halts the validation process immediately upon encountering the first schema violation to save processing time.
- Violation Reporters - Collects all schema errors found during validation into a single report for comprehensive data analysis.
- Fail-Fast Execution Controls - Supports configurable execution modes to either halt immediately upon the first violation or collect all errors.
- JSON Schema Reference Resolvers - Resolves schema references locally to simplify dependency tracking and avoid unnecessary network calls.
- Schema Tree Traversers - Processes nested data structures by recursively walking the schema tree and applying validation rules at each node.
- Schema Reference Resolution - Manages relative identifiers and external dependencies through a local registry to resolve complex data structures without network access.
- Custom Format Validators - Allows registration of custom validation logic and pattern matching to handle specialized data formats.
- Input Type Parsing - Transforms string-based inputs into numeric or boolean formats automatically during validation.
- Strict Object Validation - Enforces strict object validation to ensure data conforms to defined schema requirements.
- Schema Default Values - Fills missing properties in an input document with predefined default values from a schema during validation.
- Validation Error Reporters - Generates detailed reports that pinpoint specific schema violations and provide exact locations of errors.
- JSON Schema Implementations - Implements the official JSON Schema specification, including support for complex reference resolution.
- Write-Only Access Modes - Validates objects against read-only or write-only constraints to ensure data access patterns align with schema permissions.
- Primitive Type Schemas - Accepts string-encoded numbers or booleans to accommodate loosely typed input data.
