yang学习

Posted 2020-11-30 tongyishu

Ø  Yang 是对NETCONF数据模型、操作进行建模，覆盖NETCONF协议的操作层和内容层

Ø  模块和子模块

• 模块是yang中定义的基本单位。
• 模块定义单个数据模型，它可以定义完整的聚合模型，或者使用其他节点扩充现有的数据类型。
• 子模块是为模块提供定义的部分模块。模块可以包含任意数量的子模块。但每个子模块归属于一个模块。
• 所有标准模块和子模块的名字必须是唯一的。
• 模块使用"include"语句包含其子模块，使用"import"语句导入其他模块。
• 当引用外部模块中的定义时，必须使用本地定义的前缀，后跟":"加部标识符。
• YANG模块和子模块通常存储在文件中，每个文件存储一个模块或子模块。文件名形式为 module-or-submodule-name [‘@‘ revision-date] ( ‘.yang‘ / ‘.yin‘ )

Ø  模块的标准布局：

       module <module-name> {

                   // header information

                   <yang-version statement>

                   <namespace statement>

                   <prefix statement>

 

                   // linkage statements

                   <import statements>

                   <include statements>

 

                   // meta information

                   <organization statement>

                   <contact statement>

                   <description statement>

                   <reference statement>

 

                   // revision history

                   <revision statements>

 

                   // module definitions

                   <other statements>

               }

Ø  子模块的标准布局：

       submodule <module-name> {

               <yang-version statement>

 

               // module identification

               <belongs-to statement>

 

               // linkage statements

               <import statements>

               <include statements>

 

               // meta information

               <organization statement>

               <contact statement>

               <description statement>

               <reference statement>

 

               // revision history

               <revision statements>

 

               // module definitions

               <other statements>

          }

Ø  布局中字段的解释：

       “yang-version”语句指定在开发模块时使用哪种版本的YANG语言。

       “namespace”语句定义了该模块所有已定义的合法的标识符的XML命名空间，grouping 内定义的数据节点标识符除外。

       “prefix”语句用于定义与模块及其名称空间关联的前缀。

        "organization"语句声明定义了负责该模块的一方。

        "revision"语句指定模块的编辑修订历史，包括初始修订。

        "contact"语句提供模块的联系信息。

Ø  Yang内嵌数据类型

Ø  Yang数据建节点类型

leaf nodes

一个leaf nodes包含了像Integer这样的简单数据，并且没有子节点

leaf-list nodes

一系列的leaf nodes，每个leaf都有特定类型的值

container node

　　将相关的节点归总到一个subtree就是container，只能包含节点，没有值。一个container可能会包含任何类型的任何数量的子节点（包括leafs，lists，leaf-lists         以及       containers）。　　

list nodes　　

　　    定义了一系列的列表项,通过名为key的leaf值唯一确定，可以包含任意类型、任意数目的子节点（包括leafs，lists，containers）

typedef

定义衍生类型

grouping

可重用节点组

refine

重写特定的声明覆盖原有grouping的定义

choice case

申明分离不相容的节点

augment　　　

声明定义了在数据模型树形结构中，新的节点插入的位置。

when           

声明了新节点生效的时间。　　

RPC                   

定义声明RPC的输入输出参数

notification 　　

用于为netconf的notification做内容建模

 

通过以上四种类型节点的组合，即可定义module。

节点带有"config false"标签时，他的子结构就打上了state data的标签，不可配置，能通过netconf操作获取。