Package org.pipservices3.components.config

Class JsonConfigReader

java.lang.Object
org.pipservices3.components.config.ConfigReader
org.pipservices3.components.config.FileConfigReader
org.pipservices3.components.config.JsonConfigReader
All Implemented Interfaces:
org.pipservices3.commons.config.IConfigurable, IConfigReader
public class JsonConfigReader
extends FileConfigReader
Config reader that reads configuration from JSON file.

The reader supports parameterization using Handlebars template engine.

### Configuration parameters ###

  • path: path to configuration file
  • parameters: this entire section is used as template parameters
  • ...

### Example ### 

 
 ======== config.json ======
 { "key1": "{{KEY1_VALUE}}", "key2": "{{KEY2_VALUE}}" }
 ===========================
 
 JsonConfigReader configReader = new JsonConfigReader("config.json");
 
 ConfigParams parameters = ConfigParams.fromTuples("KEY1_VALUE", 123, "KEY2_VALUE", "ABC");
 configReader.readConfig("123", parameters);
See Also:
IConfigReader, FileConfigReader

  • Field Summary

    Fields inherited from class org.pipservices3.components.config.FileConfigReader

    _path

  • Constructor Summary

    Constructors
    Constructor Description
    JsonConfigReader()
    Creates a new instance of the config reader.
    JsonConfigReader​(String path)
    Creates a new instance of the config reader.

  • Method Summary

    Modifier and Type Method Description
    static org.pipservices3.commons.config.ConfigParams readConfig​(String correlationId, String path, org.pipservices3.commons.config.ConfigParams parameters)
    Reads configuration from a file, parameterize it with given values and returns a new ConfigParams object.
    org.pipservices3.commons.config.ConfigParams readConfig​(String correlationId, org.pipservices3.commons.config.ConfigParams parameters)
    Reads configuration and parameterize it with given values.
    static Object readObject​(String correlationId, String path, org.pipservices3.commons.config.ConfigParams parameters)
    Reads configuration file, parameterizes its content and converts it into JSON object.
    Object readObject​(String correlationId, org.pipservices3.commons.config.ConfigParams parameters)
    Reads configuration file, parameterizes its content and converts it into JSON object.

    Methods inherited from class org.pipservices3.components.config.FileConfigReader

    configure, getPath, setPath

    Methods inherited from class org.pipservices3.components.config.ConfigReader

    parameterize

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Constructor Details

    • JsonConfigReader

      public JsonConfigReader()
      Creates a new instance of the config reader.

    • JsonConfigReader

      public JsonConfigReader​(String path)
      Creates a new instance of the config reader.
      Parameters:
      path - (optional) a path to configuration file.

  • Method Details

    • readObject

      public Object readObject​(String correlationId, org.pipservices3.commons.config.ConfigParams parameters) throws org.pipservices3.commons.errors.ApplicationException
      Reads configuration file, parameterizes its content and converts it into JSON object.
      Parameters:
      correlationId - (optional) transaction id to trace execution through call chain.
      parameters - values to parameters the configuration.
      Returns:
      a JSON object with configuration.
      Throws:
      org.pipservices3.commons.errors.ApplicationException - when error occured.

    • readConfig

      public org.pipservices3.commons.config.ConfigParams readConfig​(String correlationId, org.pipservices3.commons.config.ConfigParams parameters) throws org.pipservices3.commons.errors.ApplicationException
      Reads configuration and parameterize it with given values.
      Specified by:
      readConfig in interface IConfigReader
      Specified by:
      readConfig in class ConfigReader
      Parameters:
      correlationId - (optional) transaction id to trace execution through call chain.
      parameters - values to parameters the configuration
      Returns:
      ConfigParams configuration.
      Throws:
      org.pipservices3.commons.errors.ApplicationException - when error occured.

    • readObject

      public static Object readObject​(String correlationId, String path, org.pipservices3.commons.config.ConfigParams parameters) throws org.pipservices3.commons.errors.ApplicationException
      Reads configuration file, parameterizes its content and converts it into JSON object.
      Parameters:
      correlationId - (optional) transaction id to trace execution through call chain.
      path - a path to configuration file.
      parameters - values to parameters the configuration.
      Returns:
      a JSON object with configuration.
      Throws:
      org.pipservices3.commons.errors.ApplicationException - when error occured.

    • readConfig

      public static org.pipservices3.commons.config.ConfigParams readConfig​(String correlationId, String path, org.pipservices3.commons.config.ConfigParams parameters) throws org.pipservices3.commons.errors.ApplicationException
      Reads configuration from a file, parameterize it with given values and returns a new ConfigParams object.
      Parameters:
      correlationId - (optional) transaction id to trace execution through call chain.
      path - a path to configuration file.
      parameters - values to parameters the configuration.
      Returns:
      ConfigParams configuration.
      Throws:
      org.pipservices3.commons.errors.ApplicationException - when error occured.