接口说明文档

本文档提供面向openflowjava项目的扩展yang模型说明。yang模型文件（sptn-match.yang&sptn-action.yang）根据CMCC提供的ttp文件书写。

1.Match

1.1.扩展Match相关yang元素的命名方式

本节提供扩展match相关yang元素的命名方式说明，其中粗体部分与ttp文件的映射关系见表1。

identity：”sptnxm-sptnx-“ + Match

grouping：”ofj-sptnxm-sptnx-“ +Match+”-grouping”

case：Match+”-case-value”

 表1  TTP match id与Match映射关系

以vlan-dei为例

1.Match field within the class

identity sptnxm-sptnx-vlan-dei {

base ofoxm:match-field;

}

2.value of the match

container vlan-dei -values {

     type uint8;

}

3.在openflow-augments: experimenter-id-case中扩展

augment "/ofoxm:oxm-container/ofoxm:match-entry-value/aug:experimenter-id-case" { 

ext:augment-identifier "ofj-aug-sptnx-match";

choice sptnx-match-entry-value {

case vlan-dei -case-value {

   vlan-dei -grouping;

  }

 }

}

2.Action

2.1.扩展Action相关yang元素的命名方式

本节提供扩展action相关yang元素的命名方式说明，其中粗体部分与ttp文件的映射关系见表2。

1.identity：“sptnx-action” + Action

2.grouping：” ofj-sptnx-action-“ + Action +”-grouping”

3.case：” action-”+ Action

表2 TTP action id与Action映射关系

以push-l2-header 为例

1.action sub type

identity sptnx-action- push-l2-header {

base ofaction:experimenter-action-sub-type;

}

2.action container

container sptnx-action- push-l2-header { 

}

3.在 openflow-action：action-choice中扩展

augment "/ofaction:action-container/ofaction:action-choice" {

  push-l2-header {

  push-l2-header-grouping;

}

2.3.SetField

SetField action是ODL原生支持的动作。

在openflowjava的实现中，针对扩展match的SetField复用了本文档第1章match扩展的内容，所以sptn-action.yang并没有针对该动作进行额外定义。