首页 > 代码库 > OpenFlowJ-Loxigen简介

OpenFlowJ-Loxigen简介

OpenFlowJ-Loxigen简介
Floodlight v1.0及以上版本的依靠新的OpenFlowJ-Loxigen库。OpenFlowJ-Loxigen支持的OpenFlow版本由1.0到1.4。所有OpenFlow的概念和类型都可以通过OpenFlowJ-Loxigen来获得。OpenFlowJ-Loxigen支持更新,更优化地方式去创建OpenFlow消息,匹配域(Matches),动作集(Actions),流表更改(FlowMods)等等。本文主要分析OpenFlowJ-Loxigen库当中一些常用的类和构造方法。

OFFactory

几乎所有OpenFlow概念(OFObject,例如:Match, OFAction, OFMessage, etc.)可以被构造器构造,所有的构造器都通过OFFactory暴露。由于不同版本的OpenFlow协议存在差异性,所以每个OpenFlow协议版本对应一个特地的工厂类:

OFFactoryVer10
OFFactoryVer11
OFFactoryVer12
OFFactoryVer13
OFFactoryVer14(在floodlight中不被官方支持)
这些都实现了OFFactory接口,所以你可以简单地使用OFFactory接口,忽略存在不同版本的工厂类。
有很多种方法可以得到你想要的OFFactory实例。你可以从OpenFlowJ-Loxigen,通过指定OFVersion的枚举值来请求一个特定版本的OFFactory。

OFFactory my13Factory = OFFactories.getOFFactory(OFVersion.OF_13);    //取得一个OpenFlow 1.3的工厂类

更加实用的是,你可以从IOFSwitch中取得工厂类。

IOFSwitch mySwitch = switchService.getSwitch(DatapathId.of("00:00:00:00:00:00:00:01"));
OFFactory myFactory = mySwitch.getOFFactory();    //取得与请求交换机版本相符的工厂类版本

也可以从由OFFactory生成的已存在对象中取得一个特定的OFFactory,所有从OFFactory构造的对象中得到的OFVersion和用OFFactory构造出来的相同。

OFVersion flowModVersion = myFlowMod.getVersion();    //假设myFlowMod已经被构造好
OFFactory myFactory = OFFactories.getFactory(flowModVersion);

Match

匹配域(Match)通常用在OpenFlow当中用于表示和定义包的头部域的特征。如上所说,大部分OpenFlow的概念都可以使用工厂类去构造。所以创建一个工厂类的引用是构造一个匹配域的准备工作。

Match myMatch = myFactory.buildMatch()
    .setExact(MatchField.IN_PORT, OFPort.of(1))
    .setExact(MatchField.ETH_TYPE, EthType.IPv4)
    .setMasked(MatchField.IPV4_SRC, IPv4AddressWithMask.of("192.168.0.1/24"))
    .setExact(MatchField.IP_PROTO, IpProtocol.TCP)
    .setExact(MatchField.TCP_DST, TransportPort.of(80))
    .build();

可以看到,OFFactory的实例myFactory包含一个构造器(Match.builder),这个构造器可以使用buildMatch方法返回。通过调用构造器的setExact和setMasked方法可以分别指定精确匹配和掩码匹配。

Actions

OFAction’s,像匹配域一样,通过OFFactory构造。注意:有一个类叫做OFAction以及另一个类叫做OFActions。为了表示OFAction的复数形式,此处采用OFAction’s。虽然语法上存在问题,但不会和OFActions混淆。

OFActions allActions = myFactory.actions();

actions的调用可以返回一个已实现的OFActions接口。这个返回的实现完全取决与OFFactoy的版本。(本文仅介绍OpenFlow v1.3的Actions构造)
OpenFlow 1.2引入了OXM(OpenFlow Extensible Match)。通过OXM,所有导致已存在头部域修改的Actions都会被用一个新的set-field动作说明,set-field动作包含了OXM指定了头部域和新的写入该头部域的值。注意此处Oxm’s和Oxms的区别,和OFAction’s和OFActions的区别一样,Oxms是一个接口包含了所有独立的Oxm’s。

ArrayList<OFAction> actionList = new ArrayList<OFAction>();    //actionList用来存储不同的动作
OFActions actions = myOF13Factory.actions();    //actions为实例化的接口,此接口当中包含了所有独立的OFAction
OFOxms oxms = myOF13Factory.oxms();    //oxms为实例化的接口,此接口当中包含了所有独立的Oxm

/* 使用OXM去修改数据链路层的目地地址 */
OFActionSetField setDlDst = actions.buildSetField()
    .setField(
        oxms.buildEthDst()
        .setValue(MacAddress.of("ff:ff:ff:ff:ff:ff"))
        .build()
    )
    .build();
actionList.add(setDlDst);

/* 使用OXM去修改网络层的目地地址 */
OFActionSetField setNwDst = actions.buildSetField()
    .setField(
        oxms.buildIpv4Dst()
        .setValue(IPv4Address.of("255.255.255.255"))
        .build()
    )
    .build();
actionList.add(setNwDst);

/* 去VLAN加标不是OXM而是一个OFAction */
OFActionPopVlan popVlan = actions.popVlan();
actionList.add(popVlan);

/* 向一个端口发送不是OXM而是一个OFAction */
OFActionOutput output = actions.buildOutput()
    .setMaxLen(0xFFffFFff)
    .setPort(OFPort.of(1))
    .build();
actionList.add(output);

FlowMods

OpenFlowJ-Loxigen库提供了一个版本无关的OFFlowMod接口,它由很多子接口允许你写入一个与特定OFFlowModCommand相关的特定类型的OFFlowMod:

OFFlowAdd
OFFlowModify
OFFlowModifyStrict
OFFlowDelete
OFFlowDeleteStrict
关于OFFlowMods需要注意:OpenFlow 1.3移除了默认的table-miss操作(packet-in到控制器),OpenFlow 1.3指定了控制器必须插入一条特定的优先级为0的table-miss流表,通配所有匹配域,由OFAction’s定义的action列表

OFFlowAdd flowAdd = myFactory.buildFlowAdd()

与其他OpenFlow概念类似,OFFactory可以用于产生一种特定类型的OFFlowMod。
OFFactory可以返回你指定的OFFlowMod类型的构造器。但一般情况下,我们会发现将OFFlowMod从一种OFFlowModCommand转换成另一种会更实用。这个特性目前OpenFlowJ-Loxigen还不支持,但是可以通过net.floodlightcontroller.util.FlowModUtils.java来实现

OFFlowAdd flowAdd = myFactory.buildFlowAdd().build();

/* 将FlowAdd转换为FloodModify. */
OFFlowModify flowModify = FlowModUtils.toFlowModify(flowAdd);
OFFlowModifyStrict flowModifyStrict = FlowModUtils.toFlowModifyStrict(flowAdd);
OFFlowDelete flowDelete = FlowModUtils.toFlowDelete(flowAdd);
OFFlowDeleteStrict flowDelStrict = FlowModUtils.toFlowDeleteStrict(flowAdd);
OFFlowAdd flowAdd2 = FlowModUtils.toFlowAdd(flowModify);

下面讨论如何组成一个OFFlowMod

OFFlowAdd flowAdd = my13Factory.buildFlowAdd()
    .setBufferId(OFBufferId.NO_BUFFER)
    .setHardTimeout(3600)
    .setIdleTimeout(10)
    .setPriority(32768)
    .setMatch(myMatch)
    .setActions(actionList)
    .setOutPort(OFPort.FLOOD)
    .setTableId(TableId.of(1))
    .build();
<script type="text/javascript"> $(function () { $(‘pre.prettyprint code‘).each(function () { var lines = $(this).text().split(‘\n‘).length; var $numbering = $(‘
    ‘).addClass(‘pre-numbering‘).hide(); $(this).addClass(‘has-numbering‘).parent().append($numbering); for (i = 1; i <= lines; i++) { $numbering.append($(‘
  • ‘).text(i)); }; $numbering.fadeIn(1700); }); }); </script>

    OpenFlowJ-Loxigen简介