简单 web 服务与客户端开发实战

服务计算Homework09

项目地址
文件说明：

• 见下文主要界面及其结构

使用说明：

• 使用命令npm install安装好对应的依赖
• 使用命令npm run dev运行项目后进入网址localhost:8080即可

课程任务

利用 web 客户端调用远端服务是服务开发本实验的重要内容。其中，要点建立 API First 的开发理念，实现前后端分离，使得团队协作变得更有效率

任务目标

• 选择合适的 API，实现从接口或资源（领域）建模，到 API 设计的过程
• 使用 API 工具，编制 API 描述文件，编译生成服务器、客户端原型
• 使用 Github 建立一个组织，通过 API 文档，实现 客户端项目 与 RESTful 服务项目同步开发
• 使用 API 设计工具提供 Mock 服务，两个团队独立测试 API
• 使用 travis 测试相关模块

实现过程

1. 使用swagger生成接口文件

   为了便于前后端分离，首先做好API的编写。
   使用Swagger编辑器进行yaml文件的编写，以生成API文件。使用较为简单，详细教程参考博客，yaml代码及API文档展示如下

   swagger: '2.0'
   info:
     description: 极简博客
     version: 1.0.0
     title: The minimalist blog
   tags:
     - name: Article
       description: API about Articles
     - name: Action
       description: user activity
   schemes:
     - https
     - http
   paths:
     /articles:
       get:
         tags:
           - Article
         summary: Get articles from currenge page
         description: ''
         parameters:
           - name: page
             in: query
             description: currenge page
             required: true
             type: string
             x-exportParamName: Page
         responses:
           '200':
             description: OK
             schema:
               $ref: '#/definitions/ArtitleList'
     '/article/{
        id}':
       get:
         tags:
           - Article
         summary: Get article by article_id
         description: ''
         parameters:
           - name: id
             in: path
             required: true
             type: integer
             x-exportParamName: Id
         responses:
           '200':
             description: OK
             schema:
               $ref: '#/definitions/Artitle'
     '/article/{
        id}/comments':
       get:
         tags:
           - Article
         summary: Get comments about current article
         description: ''
         parameters:
           - name: id
             in: path
             required: true
             type: integer
             x-exportParamName: Id
         responses:
           '200':
             description: OK
             schema:
               $ref: '#/definitions/CommentList'
               
     /user/register:
       post:
         tags:
           - Action
         summary: Sign up a user
         description: ''
         parameters:
           - in: body
             name: body
             required: true
             schema:
               $ref: