—
type: docs
title: “YamlConfigReader”
linkTitle: “YamlConfigReader”
gitUrl: “https://github.com/pip-services4/pip-services4-java/tree/main/pip-services4-config-java"
description: >
Config reader that reads configuration from YAML file.
Extends: FileConfigReader
Description
The YamlConfigReader allows you to create a config reader that reads a configuration from a YAML file.
Configuration parameters
- path: path to the configuration file
- parameters: this entire section is used as template parameters
- …
Constructors
Creates a new instance of the config reader.
publicYamlConfigReader(String path)
- path: String - (optional) path to the configuration file.
Instance methods
readConfig
Reads a configuration and parameterizes it with given values.
publicConfigParams readConfig(IContext context, ConfigParams parameters) throws ApplicationException
- context: IContext - (optional) a context to trace execution through a call chain.
- parameters: ConfigParams - values of the configuration parameters or null to skip parameterization.
- returns: ConfigParams - ConfigParams configuration.
readObject
Reads a configuration file, parameterizes its content and converts it into a YAML object.
publicObject readObject(IContext context, String path, ConfigParams parameters) throws ApplicationException
- context: IContext - (optional) a context to trace execution through a call chain.
- parameters: ConfigParams - values of the configuration parameters.
- returns: Object - a YAML object with a configuration.
readConfig
Reads a configuration from a file, parameterizes it with given values and returns a new ConfigParams object.
publicConfigParams readConfig(IContext context, ConfigParams parameters) throws ApplicationException
- context: IContext - (optional) a context to trace execution through a call chain.
- parameters: ConfigParams - values of the configuration parameters.
- returns: ConfigParams - ConfigParams configuration.
Static methods
readObject
Reads a configuration file, parameterizes its content and converts it into a YAML object.
public staticObject readObject(IContext context, String path, ConfigParams parameters)
- context: IContext - (optional) a context to trace execution through a call chain.
- parameters: ConfigParams - values of the configuration parameters.
- returns: Object - a YAML object containing a configuration.
Examples
key1: "{{KEY1_VALUE}}"
key2: "{{KEY2_VALUE}}"
{
YamlConfigReader configReader = new YamlConfigReader("config.yml");
ConfigParams parameters = ConfigParams.fromTuples("KEY1_VALUE", 123, "KEY2_VALUE", "ABC");
configReader.readConfig("123", parameters);
}