ONOS编程系列一剖析.docx

ONOS编程系列(一)之简单应用开发北京石头 ??15-04-17 ??3,275?人围观一个ONOS application是使用maven做管理的OSGi bundle。 因此，ONOS application 可以归结为Java类和POM文件的集合。本教程以基于intent的交互式转发application为例，讨论了如何从零开始建立一个新应用。本教程假设读者已经具备ONOS的运行经验，能够熟练启动ONOS实例。有关ONOS的启动不做过多描述。如果出现启动上的问题，请移步官方wiki文档自行寻找答案。本文章结束后，你应该学会：应用的组织与结构；如何在多个服务中注册你的应用；北向API的基本应用；如何运行一个应用。一、在Eclipse中导入工程直接按照maven项目导入就可以，详情请见ONOS环境部署。1.1 注意在ONOS项目中，对代码有着格式上的一些要求，不管是正式代码，还是测试用例。请根据要求修改增加代码的格式。如果想要跳过代码checkstyle，可以在onos项目根目录下的pom。xml文件中，注释掉关于checkstyle的plugin：不过非常不建议这样做。最好的方法还是按照官方的要求，进行编程。关于代码格式检查，如果使用的是Eclipse，可以配置checkstyle进行检查：一路点击eclipse--help--Eclipse Marketplace，进入界面：在输入框里输入“checkstyle”，然后选择框住的那个插件进行傻瓜式安装，就是一路next。这个过程很有可能会报错，Eclipse提示找不到下载网址。如果这种情况，可在/update/这个地方下载，在本地安装就可以了。安装好以后，在window--preference弹出的界面里就能看到checkstyle的选项了。单击该选项，右面出现相关界面：然后点击NEW按钮，增加一个checkstyle文件，在本地ONOS工程里找到onos自己的checkstyle文件，别忘记起个名字。然后就能在checkstyle文件列表里看到刚刚新添加的文件了。我给它的命名是ONOS。接下来选中该项，点击右边的“Set as Default”，再点击OK，就大功告成了。后面再新加的文件任意处右键，就能在菜单列表里看到checkstyle的选项了。只需要点击“Check Code with Checkstyle”，就能检查本文件的代码格式是否符合onos的要求了。二、项目骨架2.1 设置项目的目录结构应用的根目录设置在apps/之下：1$ mkdir -p ${ONOS_ROOT}/apps/ifwd应用的源文件定义在src/main/java/之下：1? $ mkdir -p ${ONOS_ROOT}/apps/ifwd/src/main/java/org/onosproject/ifwd类似的，测试文件定义在src/test/java/之下：1 $ mkdir -p ${ONOS_ROOT}/apps/ifwd/src/test/java/org/onosproject/ifwd2.2 添加并编辑pom文件在应用的根目录/apps/ifwd/下编辑pom文件：在本例中，应用的名字是onos-app-ifwd。在启动karaf/ONOS命令行界面以后，直接用feature:install加上名字，即可安装此应用。然后，编辑apps/pom.xml，在文件中以形式包含该项目：2.3 在karaf中注册该应用Karaf在运行时若要部署该应用module，需要名为feature.xml的描述性文件，编辑?${ONOS_ROOT}/features/features.xml：三、完成项目代码该应用的核心是名为?IntentReactiveForwarding.java的文件，被定义在${ONOS_ROOT}/apps/?src/main/java/org/onosproject/ifwd/?里。为了便于对文档进行注释，在main/java/下需要添加一个package-info.java文件，其包含一下内容：一般IDE会提供生成这个文件的选项。Eclipse在新建包的时候会提供该选项：剩下的部分将会描述如何编辑IntentReactiveForwarding类。3.1 注册Karaf，使其自动加载karaf的模块加载机制需要几个annotations，即注解，去注册。可用的注解尤其是以下四个尤为重要：@Component(immediate = true)?-?declares a class as a component to activate, and?forces immediate activation;@Activate?- marks a method as t