![]() |
Kea 2.7.3
|
Option definition translation between YANG and JSON. More...
#include <translator_option_def.h>
Public Member Functions | |
TranslatorOptionDef (sysrepo::Session session, const std::string &model) | |
Constructor. | |
virtual | ~TranslatorOptionDef ()=default |
Destructor. | |
isc::data::ElementPtr | getOptionDef (libyang::DataNode const &data_node) |
Translate an option definition from YANG to JSON. | |
isc::data::ElementPtr | getOptionDefFromAbsoluteXpath (std::string const &xpath) |
Translate an option definition from YANG to JSON. | |
void | setOptionDef (const std::string &xpath, isc::data::ConstElementPtr elem) |
Translate and set option definition from JSON to YANG. | |
![]() | |
Translator (sysrepo::Session session, const std::string &model) | |
Constructor. | |
virtual | ~Translator ()=default |
Destructor. | |
template<typename T > | |
void | checkAndGet (isc::data::ElementPtr const &storage, libyang::DataNode const &data_node, std::string const &xpath, T translate) const |
Calls {translate} for the element found at {xpath} relative to {data_node} and sets the result in {storage} with the {xpath} key. | |
void | checkAndGetAndJsonifyLeaf (isc::data::ElementPtr &storage, libyang::DataNode const &data_node, const std::string &name) const |
Retrieves a child YANG data node identified by name from the given parent YANG container node, converts it from string to JSON and stores it in the specified storage. | |
template<typename T > | |
void | checkAndGetDiverging (isc::data::ElementPtr const &storage, libyang::DataNode const &data_node, std::string const &key, std::string const &xpath, T translate) const |
Calls {translate} for the element found at {xpath} relative to {data_node} and sets the result in {storage} with the {key} key. | |
void | checkAndGetDivergingLeaf (isc::data::ElementPtr &storage, libyang::DataNode const &data_node, std::string const &name, std::string const &yang_name) const |
Retrieves a child YANG data node identified by name from the given parent YANG container node and stores it in the specified storage. | |
void | checkAndGetLeaf (isc::data::ElementPtr &storage, libyang::DataNode const &data_node, std::string const &name) const |
Retrieves a child YANG data node identified by name from the given parent YANG container node and stores it in the specified storage. | |
void | checkAndSetDivergingLeaf (isc::data::ConstElementPtr const &from, std::string const &xpath, std::string const &name, std::string const &yang_name, libyang::LeafBaseType const type) |
Get an element from given ElementPtr node and set it in sysrepo at given xpath. | |
void | checkAndSetLeaf (isc::data::ConstElementPtr const &from, std::string const &xpath, std::string const &name, libyang::LeafBaseType const type) |
Get an element from given ElementPtr node and set it in sysrepo at given xpath. | |
void | checkAndSetLeafList (isc::data::ConstElementPtr const &from, std::string const &xpath, std::string const &name, libyang::LeafBaseType const type) |
Get an element from given ElementPtr node and set it in sysrepo at given xpath as a leaf-list. | |
void | checkAndSetUserContext (isc::data::ConstElementPtr const &from, std::string const &xpath) |
Get an element from given ElementPtr node and set it in sysrepo at given xpath. | |
void | checkAndStringifyAndSetLeaf (isc::data::ConstElementPtr const &from, std::string const &xpath, std::string const &name) |
Get an element from given ElementPtr node and set it in sysrepo at given xpath. | |
void | deleteItem (const std::string &xpath) |
Delete basic value from YANG. | |
libyang::DataNode | findXPath (std::string const &xpath) const |
Retrieves a YANG data node by xpath. | |
template<typename functor_t > | |
void | forAll (std::string const &xpath, functor_t f) const |
Run a function for a node and all its children. | |
std::optional< libyang::DataNode > | getData (std::string const &xpath) const |
Get a YANG data node found at the given absolute xpath. | |
isc::data::ElementPtr | getItem (libyang::DataNode const &data_node, std::string const &xpath) const |
Translate a basic value from YANG to JSON for a given xpath that is relative to the given source node. | |
isc::data::ElementPtr | getItemFromAbsoluteXpath (std::string const &xpath) const |
Translate a basic value from YANG to JSON for a given absolute xpath. | |
template<typename T > | |
isc::data::ElementPtr | getList (libyang::DataNode const &data_node, std::string const &xpath, T &t, isc::data::ElementPtr(T::*f)(libyang::DataNode const &)) const |
Retrieve a list as ElementPtr from sysrepo from a certain xpath. | |
void | getMandatoryDivergingLeaf (isc::data::ElementPtr &storage, libyang::DataNode const &data_node, std::string const &name, std::string const &yang_name) const |
Retrieves a child YANG data node identified by one name from the given parent YANG container node and stores it in the specified storage under a different name. | |
void | getMandatoryLeaf (isc::data::ElementPtr &storage, libyang::DataNode const &data_node, std::string const &name) const |
Retrieves a child YANG data node identified by name from the given parent YANG container node and stores it in the specified storage. | |
bool | schemaNodeExists (std::string const &xpath) const |
Checks whether a YANG node exists in the schema. | |
void | setItem (const std::string &xpath, isc::data::ConstElementPtr const elem, libyang::LeafBaseType const type) |
Translate and set basic value from JSON to YANG. | |
void | setMandatoryDivergingLeaf (isc::data::ConstElementPtr const &from, std::string const &xpath, std::string const &name, std::string const &yang_name, libyang::LeafBaseType const type) |
Get an element from given ElementPtr node and set it in sysrepo at given xpath. | |
void | setMandatoryLeaf (isc::data::ConstElementPtr const &from, std::string const &xpath, std::string const &name, libyang::LeafBaseType const type) |
Get an element from given ElementPtr node and set it in sysrepo at given xpath. | |
Protected Member Functions | |
isc::data::ElementPtr | getOptionDefKea (libyang::DataNode const &data_node) |
getOptionDef implementation specific to kea-dhcp[46]-server models. | |
void | setOptionDefKea (const std::string &xpath, isc::data::ConstElementPtr elem) |
setOptionDef implementation specific to kea-dhcp[46]-server models. | |
Additional Inherited Members | |
![]() | |
static isc::data::ElementPtr | translateFromYang (std::optional< libyang::DataNode > data_node) |
Translate basic value from the given YANG data node to JSON element. | |
static std::optional< std::string > | translateToYang (isc::data::ConstElementPtr const &elem, libyang::LeafBaseType const type) |
Translate basic value from JSON to YANG. | |
![]() | |
using | Deserializer |
Maps YANG types to functions that transform a YANG type into an ElementPtr. | |
using | Serializer |
Maps YANG types to functions that transform the string representation of an Element into a string that can be passed into Session::setItem(). | |
![]() | |
static std::string | decode64 (std::string const &input) |
Decode a YANG element of binary type to a string that can be stored in an Element::string JSON. | |
static std::string | encode64 (std::string const &input) |
Encode a string such that it can be stored in a YANG element of binary type. | |
static Deserializer | initializeDeserializer () |
Initializes the deserializer which is used to translate a YANG node to an ElementPtr. | |
static Serializer | initializeSerializer () |
Initializes the serializer which is used to translate the string value of an Element to a string that can be passed into Session::setItem(). | |
![]() | |
std::string | model_ |
The model. | |
sysrepo::Session | session_ |
The sysrepo session. | |
Option definition translation between YANG and JSON.
JSON syntax for Kea DHCP servers is:
YANG syntax for kea-dhcp[46] with code and space as keys is:
An example in JSON and YANG formats:
A translator class for converting an option definition between YANG and JSON.
Currently supports kea-dhcp[46]-server models.
Definition at line 78 of file translator_option_def.h.
isc::yang::TranslatorOptionDef::TranslatorOptionDef | ( | sysrepo::Session | session, |
const std::string & | model ) |
Constructor.
session | Sysrepo session. |
model | Model name. |
Definition at line 22 of file translator_option_def.cc.
|
virtualdefault |
Destructor.
ElementPtr isc::yang::TranslatorOptionDef::getOptionDef | ( | libyang::DataNode const & | data_node | ) |
Translate an option definition from YANG to JSON.
data_node | the YANG node representing the option definition |
NetconfError | when sysrepo raises an error. |
Definition at line 28 of file translator_option_def.cc.
References getOptionDefKea(), isc_throw, isc::yang::Translator::model_, and isc::Exception::what().
Referenced by getOptionDefFromAbsoluteXpath(), and isc::yang::TranslatorOptionDefList::getOptionDefListKea().
ElementPtr isc::yang::TranslatorOptionDef::getOptionDefFromAbsoluteXpath | ( | std::string const & | xpath | ) |
Translate an option definition from YANG to JSON.
xpath | The xpath of the option definition. |
NetconfError | when sysrepo raises an error. |
Definition at line 44 of file translator_option_def.cc.
References isc::yang::Translator::findXPath(), and getOptionDef().
|
protected |
getOptionDef implementation specific to kea-dhcp[46]-server models.
data_node | the YANG node representing the option definition |
NetconfError | when sysrepo raises an error. |
BadValue | on option definition without name or type. |
Definition at line 53 of file translator_option_def.cc.
References isc::yang::Translator::checkAndGetAndJsonifyLeaf(), isc::yang::Translator::checkAndGetLeaf(), isc::data::Element::createMap(), and isc::yang::Translator::getMandatoryLeaf().
Referenced by getOptionDef().
void isc::yang::TranslatorOptionDef::setOptionDef | ( | const std::string & | xpath, |
isc::data::ConstElementPtr | elem ) |
Translate and set option definition from JSON to YANG.
xpath | The xpath of the option definition.. |
elem | The JSON element. |
Definition at line 71 of file translator_option_def.cc.
References isc_throw, isc::yang::Translator::model_, setOptionDefKea(), and isc::Exception::what().
Referenced by isc::yang::TranslatorOptionDefList::setOptionDefListKea().
|
protected |
setOptionDef implementation specific to kea-dhcp[46]-server models.
xpath | The xpath of the option definition. |
elem | The JSON element. |
BadValue | on option definition without name or type. |
Definition at line 89 of file translator_option_def.cc.
References isc::yang::Translator::checkAndSetLeaf(), isc::yang::Translator::checkAndSetUserContext(), isc::yang::Translator::setItem(), and isc::yang::Translator::setMandatoryLeaf().
Referenced by setOptionDef().