介绍
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服务器公开数据，那么它必须公开一个接口来获取该数据。
Configuration
模块默认启用，加载模块不需要更改配置。
