Table of contents
Directory
Updated at 2020-03-20 16:00:22

Tars-Config

Used to get config files in Tars framework

Installation

npm install @tars/config

Instantiation

Instantiate the object before using it:
var config = new TarsConfig (data)

data: The path to the config file or the configured @tars/config-parser instance.

If the server runs by node-agent (or on Tars platform,then you don't need to pass data

Enum

FORMAT

Defines the format of the config file:

  • C: C++ Config file formart
  • JSON: JSON format
  • TEXT: Normal text(Custom format)

LOCATION

Defines the position where the config files are stored:

  • APP: Config files are stored in the application
  • SERVER: Config files are stored in the servers

Methods

loadConfig([files ,]options)

Get config file content。

files(String|Array) It can be a single file name or an array, and if it is left empty, all the file contents will be obtained by default.

options(Object) Optional, accept the following parameters:

  • format: File format, default to e FORMAT.C
  • location: Stored position, default to be LOCATION.SERVER

Return array of following objects after call success:

  • filename: Filename
  • content: Content after file parsing

If only get one single file, it will return the parsed content of the file.

Example

Get the content of a.conf

config.loadConfig("a.conf").then(function(data) {
    console.log("content:", data);
}, function (err) {
    console.error("loadConfig err", err);
});

Get the content of a.conf and parse by json:

config.loadConfig("a.conf", {format : config.FORMAT.JSON}).then(function(data) {
    console.log("content:", data);
}, function (err) {
    console.error("loadConfig err", err);
});

Get content of a.conf which is stored in application:

config.loadConfig("a.conf", {location : config.LOCATION.APP}).then(function(data) {
    console.log("content:", data);
}, function (err) {
    console.error("loadConfig err", err);
});

Get content of a.conf and b.conf

config.loadConfig(["a.conf", "b.conf"]).then(function(data) {
    data.forEach(function(item) {
        console.log("filename:", item.filename);
        console.log("content:", item.content);
    });
}, function (err) {
    console.error("loadConfig err", err);
});

Get all config files of server:

config.loadConfig().then(function(data) {
    data.forEach(function(item) {
        console.log("filename:", item.filename);
        console.log("content:", item.content);
    });
}, function (err) {
    console.error("loadConfig err", err);
});

loadList(options)

Get list of config files(name of all config files)。

options(Object) Optional, accept the following parameters:

  • location: Stored position, default to be LOCATION.SERVER

Return array of file names after call success.

Example

Get all config file names of server:

config.loadList().then(function(filelist) {
    console.log("files:", filelist);
}, function(err) {
    console.log("loadList error", err);
});

loadServerConfig(options)

Get default config file(name is like App.Server.conf)。

options(Object) Optional, accept the following parameters:

  • format: File format, default to be FORMAT.C

Return parsed Content of config file after call success.

Example

Get default config file:

config.loadServerConfig().then(function(data) {
    console.log("content:", data);
}, function(err) {
    console.log("loadServerConfig error", err);
});

Events

configPushed

Emited when push config file to Tars platform.

The callback function while provide pushed filename.

Example

Listen to push event, and get pushed file content :

config.on("configPushed", function(filename) {
    console.log("config pushed", filename);
    config.loadConfig(filename).then(function(data) {
        console.log("content:", data);
    }, function(err) {
        console.error("loadConfig err", err);
    });
});
Chapter