How itplr-kosit/validator works
KoSIT Validator is a configurable XML validation engine, exposed as a Java API, CLI, and HTTP daemon with a browser UI. Its principal workflow loads scenario configuration and repository resources, accepts an XML document, identifies its format, applies schema and Schematron validation, generates a report and acceptance status, then returns or displays the result. The README documents these stages and usage modes; source excerpts confirm key API, daemon, input, and UI behavior. Several validation internals are represented from the tree and README, so their unverified links are dashed.
Main entry points: Check.java Check API · CheckHandler.java Check endpoint · Validator.java CLI · SchemaValidationAction.java Schema validation
Components 25
Configuration
- Scenario config
src/main/java/de/kosit/validationtool/config/ScenarioBuilder.java - Configuration API
src/main/java/de/kosit/validationtool/api/Configuration.java - Content repository
src/main/java/de/kosit/validationtool/impl/ContentRepository.java
Validation engine
- Input factory
src/main/java/de/kosit/validationtool/api/InputFactory.java - Input handling
src/main/java/de/kosit/validationtool/impl/input/SourceInput.java - Check API
src/main/java/de/kosit/validationtool/api/Check.java - Format selection
src/main/java/de/kosit/validationtool/impl/tasks/ScenarioSelectionAction.java - Document parsing
src/main/java/de/kosit/validationtool/impl/tasks/DocumentParseAction.java - Schema validation
src/main/java/de/kosit/validationtool/impl/tasks/SchemaValidationAction.java - Schematron validation
src/main/java/de/kosit/validationtool/impl/tasks/SchematronValidationAction.java - Report generation
src/main/java/de/kosit/validationtool/impl/tasks/CreateReportAction.java - Acceptance status
src/main/java/de/kosit/validationtool/impl/tasks/ComputeAcceptanceAction.java - Validation result
src/main/java/de/kosit/validationtool/api/Result.java
User interfaces
- CLI
src/main/java/de/kosit/validationtool/cmd/Validator.java - HTTP daemon
src/main/java/de/kosit/validationtool/daemon/Daemon.java - HTTP routing
src/main/java/de/kosit/validationtool/daemon/RoutingHandler.java - Check endpoint
src/main/java/de/kosit/validationtool/daemon/CheckHandler.java - Health endpoint
src/main/java/de/kosit/validationtool/daemon/HealthHandler.java - XML upload UI
server/ui/src/components/Upload/Upload.tsx - HTTP request hook
server/ui/src/components/util/useRequest.ts - XML result view
server/ui/src/components/XmlView/XmlView.tsx
Runtime support
- Error collection
src/main/java/de/kosit/validationtool/impl/CollectingErrorEventHandler.java - XML conversion
src/main/java/de/kosit/validationtool/impl/ConversionService.java - Engine metadata
src/main/java/de/kosit/validationtool/impl/EngineInformation.java
Other components
- User
Connections 33
- User → CLI: runs validation
- User → XML upload UI: uploads XML
server/ui/src/components/Upload/Upload.tsx - User → Check API: embeds API
- User → HTTP daemon: uses HTTP
- Configuration API → Scenario config: builds scenarios
src/main/java/de/kosit/validationtool/api/Configuration.java - Configuration API → Content repository: loads resources
src/main/java/de/kosit/validationtool/api/Configuration.java - Scenario config → Content repository: configures resources
src/main/java/de/kosit/validationtool/config/ScenarioBuilder.java - CLI → Configuration API: loads config
src/main/java/de/kosit/validationtool/cmd/Validator.java - CLI → Input factory: creates inputs
src/main/java/de/kosit/validationtool/cmd/Validator.java - CLI → Check API: checks inputs
src/main/java/de/kosit/validationtool/cmd/Validator.java - Input factory → Input handling: creates input
src/main/java/de/kosit/validationtool/api/InputFactory.java - Input handling → Check API: supplies document
- Check API → Format selection: identifies format
- Format selection → Document parsing: parses document
- Document parsing → Schema validation: validates schema
- Schema validation → Schematron validation: applies rules
- Check API → Report generation: generates report
- Check API → Acceptance status: computes status
- Report generation → Validation result: produces report
- Acceptance status → Validation result: sets acceptance
- HTTP daemon → HTTP routing: registers routes
- HTTP routing → Check endpoint: routes checks
src/main/java/de/kosit/validationtool/daemon/RoutingHandler.java - HTTP routing → Health endpoint: routes health
- Check endpoint → Input factory: creates input
src/main/java/de/kosit/validationtool/daemon/CheckHandler.java - Check endpoint → Check API: checks document
src/main/java/de/kosit/validationtool/daemon/CheckHandler.java - Check endpoint → Validation result: serializes report
src/main/java/de/kosit/validationtool/daemon/CheckHandler.java - XML upload UI → HTTP request hook: posts XML
server/ui/src/components/Upload/Upload.tsx - HTTP request hook → Check endpoint: sends HTTP
- XML upload UI → XML result view: shows report
- Health endpoint → XML conversion: serializes health
src/main/java/de/kosit/validationtool/daemon/HealthHandler.java - Health endpoint → Engine metadata: reads metadata
src/main/java/de/kosit/validationtool/daemon/HealthHandler.java - Schema validation → Error collection: collects errors
- Content repository → Error collection: collects errors
src/main/java/de/kosit/validationtool/impl/ContentRepository.java