@4geit/swg-contact-model 中文文档教程
@4geit/swg-contact-model
使用 CRUD 运算符联系模型和端点
Installation
- A recommended way to install @4geit/swg-contact-model is through npm package manager using the following command:
npm i @4geit/swg-contact-model --save
或者使用 yarn
使用以下命令:
yarn add @4geit/swg-contact-model
- In your swagger file, you need to add a reference to the
SwgContactModel
definition under thedefinitions
property (e.g./api/swagger/swagger.yaml
) as below:
swagger: "2.0"
# ...
definitions:
SwgContactModel:
$ref: ../../node_modules/@4geit/swg-contact-model/swagger.yaml#/definitions/SwgContactModel
# ...
- SwgContactModel also comes along with some endpoints you can expose to the API, to do so you will need to add a reference to the
SwgContactModel
definition under thepaths
property (e.g./api/swagger/swagger.yaml
) as below:
swagger: "2.0"
# ...
paths:
/contact:
$ref: ../../node_modules/@4geit/swg-contact-model/swagger.yaml#/definitions/ContactListPath
/contact/{id}:
$ref: ../../node_modules/@4geit/swg-contact-model/swagger.yaml#/definitions/ContactItemPath
/contact/populate:
$ref: ../../node_modules/@4geit/swg-contact-model/swagger.yaml#/definitions/PopulatePath
# ...
并且您还需要将路径添加到 swg-contact 的
包,这样 swagger-node 就会找到相关的控制器来使用。 编辑文件 controllers
文件夹-model/config/default.yaml
并向属性 mockControllersDirs
和 controllersDirs
添加两个新路径,如下所示:
swagger:
# ...
bagpipes:
_router:
# ...
mockControllersDirs:
# ...
- node_modules/@4geit/swg-contact-model/mocks
# ...
controllersDirs:
# ...
- node_modules/@4geit/swg-contact-model/controllers
# ...
@4geit/swg-contact-model
contact model and endpoints with CRUD operators
Installation
- A recommended way to install @4geit/swg-contact-model is through npm package manager using the following command:
npm i @4geit/swg-contact-model --save
Or use yarn
using the following command:
yarn add @4geit/swg-contact-model
- In your swagger file, you need to add a reference to the
SwgContactModel
definition under thedefinitions
property (e.g./api/swagger/swagger.yaml
) as below:
swagger: "2.0"
# ...
definitions:
SwgContactModel:
$ref: ../../node_modules/@4geit/swg-contact-model/swagger.yaml#/definitions/SwgContactModel
# ...
- SwgContactModel also comes along with some endpoints you can expose to the API, to do so you will need to add a reference to the
SwgContactModel
definition under thepaths
property (e.g./api/swagger/swagger.yaml
) as below:
swagger: "2.0"
# ...
paths:
/contact:
$ref: ../../node_modules/@4geit/swg-contact-model/swagger.yaml#/definitions/ContactListPath
/contact/{id}:
$ref: ../../node_modules/@4geit/swg-contact-model/swagger.yaml#/definitions/ContactItemPath
/contact/populate:
$ref: ../../node_modules/@4geit/swg-contact-model/swagger.yaml#/definitions/PopulatePath
# ...
And you will also need to add the path to the controllers
folder of the swg-contact-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-contact-model/mocks
# ...
controllersDirs:
# ...
- node_modules/@4geit/swg-contact-model/controllers
# ...