floodlight官方文档（九）：controller module详解----RestApiServer

Description

RESTAPI服务器允许模块通过HTTP公开REST API。

Services Provided

IRestApiService

Service Dependencies依赖的服务

None.

Java File

该模块在net.flowlightcontroller.restserver.restapiserver中实现。

How it works

RESTAPI服务器使用restlets库。有关restlet的更多文档可从这里获得。其他将REST服务器作为依赖项的模块通过添加实现restletroutable的类来公开API。每个restletroutable都包含一个连接restlet资源的路由器（最常见的是serverresource）。用户将附加自己的类来扩展restlet资源，以便处理特定URL的请求。在诸如@get、@put等资源注释中，选择将用于HTTP请求的方法。序列化是通过包含在restlet库中的Jackson库完成的。Jackson可以用两种方式序列化对象。一种是它将自动在对象上使用可用的getter来序列化这些字段。否则，可以在类的顶部创建和注释自定义序列化程序。

Limitations

• 基路径不能重叠，必须是唯一的。
• Restlet只能通过服务接口访问模块数据。如果一个模块需要通过REST服务器公开数据，那么它必须公开一个接口来获取该数据。