...
When files are processed the effective model is referenced by name, namespace and revision of a base file module, which are not changed and remain same.
At the same time the augment module became extra, because it contains no model so it won't be ever referenced (directly) for data validation.
...
The imports are mainly used to re-use definitions from existing modules.
Code Block |
---|
| module base {
yang-version 1.1;
namespace "org:onap:cps:test:importer";
revision "2020-02-01";
prefix "importer";
import exporter {
prefix "exporter";
}
container importer-container {
leaf name {
type string;
}
leaf description {
type string;
}
uses "exporter:export-group";
}
} |
|
Code Block |
---|
| module exporter {
yang-version 1.1;
namespace "org:onap:cps:test:exporter";
revision "2020-02-02";
prefix "exporter";
grouping export-group {
leaf exporter-leaf {
type string;
}
}
container exporter-container {
uses export-group;
}
} |
|
Code Block |
---|
title | importer.json (valid) |
---|
| {
"importer-container": {
"name": "test name",
"description": "test description",
"exporter-leaf": "test imported"
}
} |
Code Block |
---|
title | exporter.json (also valid) |
---|
| {
"exporter-container": {
"exporter-leaf": "test data"
}
} |
|
Multiple valid models issue
When the data is being decomposed using a schema context built from these two yang files, there will be no any error
if the incoming JSON matches any of models within . The appropriate module (for validation/parsing) could be chosen
dynamically. It also possible there could be collision if root container elements of both modules are having same name.
Assembly using submodules
Assembly case is mainly used to for organizational purposes when large module file is split to logical peaces (submodules)
for better maintainability
Code Block |
---|
| module assembly {
yang-version 1.1;
namespace "org:onap:cps:test:assembly";
prefix "assembly";
revision "2020-03-01";
include "component";
container module-container {
leaf name {
type string;
}
leaf description {
type string;
}
}
} |
|
Code Block |
---|
| submodule component {
yang-version 1.1;
revision "2020-03-02";
belongs-to "assembly" {
prefix "assembly";
}
container submodule-container {
leaf name {
type string;
}
leaf description {
type string;
}
}
} |
| |
...
| {
"module-container": {
"name": "module name",
"description": "module description"
},
"submodule-container": {
"name": "submodule name",
"description": "submodule description"
}
} |
|
Module vs Yang File