@4geit/swg-account-model 中文文档教程
@4geit/swg-account-model
遵循 REST CRUD 模式的帐户模型的 swagger 定义
Installation
- A recommended way to install @4geit/swg-account-model is through npm package manager using the following command:
npm i @4geit/swg-account-model --save
或者使用 yarn
使用以下命令:
yarn add @4geit/swg-account-model
- In your swagger file, you need to add a reference to the
SwgAccountModel
definition under thedefinitions
property (e.g./api/swagger/swagger.yaml
) as below:
swagger: "2.0"
# ...
definitions:
SwgAccountModel:
$ref: ../../node_modules/@4geit/swg-account-model/swagger.yaml#/definitions/SwgAccountModel
# ...
- In your swagger file, you need to add a reference to the
PopulatePath
definition under thepaths
property (e.g./api/swagger/swagger.yaml
) as below:
swagger: "2.0"
# ...
paths:
/populate:
$ref: ../../node_modules/@4geit/swg-account-model/swagger.yaml#/definitions/PopulatePath
/users:
$ref: ../../node_modules/@4geit/swg-account-model/swagger.yaml#/definitions/UsersPath
# ...
并且您还需要将路径添加到 的
包,这样 swagger-node 会找到相关的控制器来使用。 编辑文件 controllers
文件夹>swg-account-model/config/default.yaml
并向属性 mockControllersDirs
和 controllersDirs
添加两个新路径,如下所示:
swagger:
# ...
bagpipes:
_router:
# ...
mockControllersDirs:
# ...
- node_modules/@4geit/swg-account-model/mocks
# ...
controllersDirs:
# ...
- node_modules/@4geit/swg-account-model/controllers
# ...
@4geit/swg-account-model
swagger definition of an account model following the REST CRUD pattern
Installation
- A recommended way to install @4geit/swg-account-model is through npm package manager using the following command:
npm i @4geit/swg-account-model --save
Or use yarn
using the following command:
yarn add @4geit/swg-account-model
- In your swagger file, you need to add a reference to the
SwgAccountModel
definition under thedefinitions
property (e.g./api/swagger/swagger.yaml
) as below:
swagger: "2.0"
# ...
definitions:
SwgAccountModel:
$ref: ../../node_modules/@4geit/swg-account-model/swagger.yaml#/definitions/SwgAccountModel
# ...
- In your swagger file, you need to add a reference to the
PopulatePath
definition under thepaths
property (e.g./api/swagger/swagger.yaml
) as below:
swagger: "2.0"
# ...
paths:
/populate:
$ref: ../../node_modules/@4geit/swg-account-model/swagger.yaml#/definitions/PopulatePath
/users:
$ref: ../../node_modules/@4geit/swg-account-model/swagger.yaml#/definitions/UsersPath
# ...
And you will also need to add the path to the controllers
folder of the swg-account-model
package so that swagger-node will find the relevant controller to use. Edit the file /config/default.yaml
and add two new paths to the properties mockControllersDirs
and controllersDirs
as illustrated below:
swagger:
# ...
bagpipes:
_router:
# ...
mockControllersDirs:
# ...
- node_modules/@4geit/swg-account-model/mocks
# ...
controllersDirs:
# ...
- node_modules/@4geit/swg-account-model/controllers
# ...