@Define&@Reuse

@Define 用来定义复用的公共模块,通常用来复用一些相同的设置,如请求头部,请求参数等。 复用模块可以通过@Reuse引用。

用法:@Define moduleName@Reuse moduleName

示例:

// 定义复用模块ReuseItem
/**
 * @ApiStart
 * 
 * @Define ReuseItem
 * 
 * @HeaderParam {String} access-token the request token in header
 * 
 * @QueryParam {Integer} page current page
 * @QueryParam {Integer} pageSize current page size
 * 
 * @ApiEnd
 */

注:在@Define定义的模块中,@Api@Name@Define@Reuse等注解命令会失效。其他指令均可正常使用。

// 引用该模块
/**
 * @ApiStart
 *
 * @Name getDemo
 * @Group demoGroup
 *
 * @Api get /api/getTest
 * 
 * @QueryParam {String} id 查询参数id
 * 
 * @Reuse ReuseItem
 * 
 * @ApiEnd
 */

上述接口引用定义的公共模块后,该接口会自动引入@HeaderParam; 同时,由于接口自身有定义@QueryParam {String} id,引入的公共模块ReuseItem 中的所有@QueryParam将不会起作用。

results matching ""

    No results matching ""