@4geit/swg-notification-model 中文文档教程
@4geit/swg-notification-model
通知模型为通知菜单功能提供数据模型+端点
Installation
- A recommended way to install @4geit/swg-notification-model is through npm package manager using the following command:
npm i @4geit/swg-notification-model --save
或者使用 yarn
使用以下命令:
yarn add @4geit/swg-notification-model
- In your swagger file, you need to add a reference to the
SwgNotificationModel
definition under thedefinitions
property (e.g./api/swagger/swagger.yaml
) as below:
swagger: "2.0"
# ...
definitions:
SwgNotificationModel:
$ref: ../../node_modules/@4geit/swg-notification-model/swagger.yaml#/definitions/SwgNotificationModel
# ...
- SwgNotificationModel also comes along with some endpoints you can expose to the API, to do so you will need to add a reference to the
SwgNotificationModel
definition under thepaths
property (e.g./api/swagger/swagger.yaml
) as below:
swagger: "2.0"
# ...
paths:
/notification:
$ref: ../../node_modules/@4geit/swg-notification-model/swagger.yaml#/definitions/NotificationListPath
/notification/{id}:
$ref: ../../node_modules/@4geit/swg-notification-model/swagger.yaml#/definitions/NotificationItemPath
/notification/populate:
$ref: ../../node_modules/@4geit/swg-notification-model/swagger.yaml#/definitions/PopulatePath
# ...
你还需要添加 controllers
文件夹的路径 < code>swg-notification-model 包,这样 swagger-node 会找到相关的控制器来使用。 编辑文件 /config/default.yaml
并向属性 mockControllersDirs
和 controllersDirs
添加两个新路径,如下所示:
swagger:
# ...
bagpipes:
_router:
# ...
mockControllersDirs:
# ...
- node_modules/@4geit/swg-notification-model/mocks
# ...
controllersDirs:
# ...
- node_modules/@4geit/swg-notification-model/controllers
# ...
@4geit/swg-notification-model
notification model provides data model + endpoints for the notifications menu feature
Installation
- A recommended way to install @4geit/swg-notification-model is through npm package manager using the following command:
npm i @4geit/swg-notification-model --save
Or use yarn
using the following command:
yarn add @4geit/swg-notification-model
- In your swagger file, you need to add a reference to the
SwgNotificationModel
definition under thedefinitions
property (e.g./api/swagger/swagger.yaml
) as below:
swagger: "2.0"
# ...
definitions:
SwgNotificationModel:
$ref: ../../node_modules/@4geit/swg-notification-model/swagger.yaml#/definitions/SwgNotificationModel
# ...
- SwgNotificationModel also comes along with some endpoints you can expose to the API, to do so you will need to add a reference to the
SwgNotificationModel
definition under thepaths
property (e.g./api/swagger/swagger.yaml
) as below:
swagger: "2.0"
# ...
paths:
/notification:
$ref: ../../node_modules/@4geit/swg-notification-model/swagger.yaml#/definitions/NotificationListPath
/notification/{id}:
$ref: ../../node_modules/@4geit/swg-notification-model/swagger.yaml#/definitions/NotificationItemPath
/notification/populate:
$ref: ../../node_modules/@4geit/swg-notification-model/swagger.yaml#/definitions/PopulatePath
# ...
And you will also need to add the path to the controllers
folder of the swg-notification-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-notification-model/mocks
# ...
controllersDirs:
# ...
- node_modules/@4geit/swg-notification-model/controllers
# ...