C++ Micro Services模块以自身属性的形式提供meta-data(元数据)。属性是键 - 值对,其中键的类型为std :: string,值的类型为Any(任意类型)。以下属性只能由C ++ Micro Services库设置,不能由模块作者更改:
- module.id - 模块的唯一ID(类型为 long)
- module.name - 模块的名称(类型为 std :: string)
- module.location - 文件系统上模块共享库的完整路径(类型为 std :: string)
模块作者可以通过提供manifest.json文件来添加自定义属性,这个文件被作为顶层资源嵌入到模块中(详情参阅The Resource System)。Json文件的根值必须是Json对象。以下为一个manifest.json文件的例子:
{
"module.version" : "1.0.2",
"module.description" : "This module provides an awesome service",
"authors" : [ "John Doe", "Douglas Reynolds", "Daniel Cannady" ],
"rating" : 5
}
根对象的所有Json成员名称将作为包含manifest.json文件的模块中的属性的“键”提供。C ++ Micro Services库指定在manifest.json文件中重复使用以下标准的“键”:
- module.version - 模块的版本(类型为 std :: string)。版本字符串必须是有效的版本标识符,如ModuleVersion类中所指定的
- module.vendor - 模块的供应商名称(类型为 std :: string)
- module.description - 模块的描述(类型为 std :: string)
- module.autoload_dir - 模块的自定义自动加载目录(类型为 std :: string)。如果未设置,则此属性默认为模块的库名称
**注意:**上面提到的一些特性也可以通过Module类中的专用方法访问,例如, Module :: GetName()或Module :: GetVersion()。
解析manifest.json文件时,Json类型被映射为C++类型并存储在Any类的实例中。 映射如下: