mirror of
https://github.com/corda/corda.git
synced 2024-12-19 04:57:58 +00:00
b7d04b1c6e
* Temp commit * Print the error message first by default, makes error output more natural. * Polishing * Further modifications after testing * Documentation updates * Couple of fixes after review * Removing unnecessary tests * Fix broken test * Add interface to bootstrapper for testign * Added unit tests * Remove unused class * Fix up bootstrapper unit tests and add a couple more * Refactor the tests slightly * Review comments * Couple of minor tweaks |
||
|---|---|---|
| .. | ||
| src | ||
| build.gradle | ||
| README.md | ||
configuration-parsing
This module provides types and functions to facilitate using Typesafe configuration objects.
Features
- A multi-step, structured validation framework for Typesafe configurations, allowing to merge Typesafe and application-level rules.
- A parsing framework, allowing to extract domain types from raw configuration objects in a versioned, type-safe fashion.
- A configuration description framework, allowing to print the expected schema of a configuration object.
- A configuration serialization framework, allowing to output the structure and values of a configuration object, potentially obfuscating sensitive data.
Concepts
The main idea is to create a Configuration.Specification to model the expected structure of a Typesafe configuration.
The specification is then able to parse, validate, describe and serialize a raw Typesafe configuration.
By using VersionedConfigurationParser, it is possible to map specific versions to Configuration.Specifications and to parse and validate a raw configuration object based on a version header.
Refer to the following tests to gain an understanding of how the library works:
- net.corda.common.configuration.parsing.internal.versioned.VersionedParsingExampleTest
- net.corda.common.configuration.parsing.internal.SpecificationTest
- net.corda.common.configuration.parsing.internal.SchemaTest