日本丰满熟妇videossex一,日韩精品久久无码人妻中文字幕,日本特黄aaaaaa片在线观看

cd ./todo-app
git init
git add .; git commit -m "Initial commit";

將 express-openapi 引入我們的程序：

npm i express-openapi -s

// ./app.js



...



app.listen(3030);



...



// OpenAPI routes

initialize({

  app,

  apiDoc: require("./api/api-doc"),

  paths: "./api/paths",

});



module.exports = app;

添加 OpenAPI 基礎(chǔ)模型。

請(qǐng)注意，模型中定義了?Todo?的類(lèi)型，將在路由處理程序中引用。

// ./api/api-doc.js



const apiDoc = {

  swagger: "2.0",

  basePath: "/",

  info: {

    title: "Todo app API.",

    version: "1.0.0",

  },

  definitions: {

    Todo: {

      type: "object",

      properties: {

        id: {

          type: "number",

        },

        message: {

          type: "string",

        },

      },

      required: ["id", "message"],

    },

  },

  paths: {},

};



module.exports = apiDoc;

添加路由處理程序。

每個(gè)處理程序都聲明它支持哪些操作（GET、POST …），對(duì)每個(gè)操作的回調(diào)，以及該處理程序的?apiDoc?OpenAPI 模型。

// ./api/paths/todos/index.js

module.exports = function () {

  let operations = {

    GET,

    POST,

    PUT,

    DELETE,

  };



  function GET(req, res, next) {

    res.status(200).json([

      { id: 0, message: "First todo" },

      { id: 1, message: "Second todo" },

    ]);

  }



  function POST(req, res, next) {

    console.log(About to create todo: ${JSON.stringify(req.body)});
    res.status(201).send();
  }

  function PUT(req, res, next) {
    console.log(About to update todo id: ${req.query.id});
    res.status(200).send();
  }

  function DELETE(req, res, next) {
    console.log(About to delete todo id: ${req.query.id});
    res.status(200).send();
  }

  GET.apiDoc = {
    summary: "Fetch todos.",
    operationId: "getTodos",
    responses: {
      200: {
        description: "List of todos.",
        schema: {
          type: "array",
          items: {
            $ref: "#/definitions/Todo",
          },
        },
      },
    },
  };

  POST.apiDoc = {
    summary: "Create todo.",
    operationId: "createTodo",
    consumes: ["application/json"],
    parameters: [
      {
        in: "body",
        name: "todo",
        schema: {
          $ref: "#/definitions/Todo",
        },
      },
    ],
    responses: {
      201: {
        description: "Created",
      },
    },
  };

  PUT.apiDoc = {
    summary: "Update todo.",
    operationId: "updateTodo",
    parameters: [
      {
        in: "query",
        name: "id",
        required: true,
        type: "string",
      },
      {
        in: "body",
        name: "todo",
        schema: {
          $ref: "#/definitions/Todo",
        },
      },
    ],
    responses: {
      200: {
        description: "Updated ok",
      },
    },
  };

  DELETE.apiDoc = {
    summary: "Delete todo.",
    operationId: "deleteTodo",
    consumes: ["application/json"],
    parameters: [
      {
        in: "query",
        name: "id",
        required: true,
        type: "string",
      },
    ],
    responses: {
      200: {
        description: "Delete",
      },
    },
  };

  return operations;
};

添加自動(dòng)生成的文檔，swagger-ui-express：

npm i swagger-ui-express -s

// ./app.js



...



// OpenAPI UI

app.use(

  "/api-documentation",

  swaggerUi.serve,

  swaggerUi.setup(null, {

    swaggerOptions: {

      url: "http://localhost:3030/api-docs",

    },

  })

);



module.exports = app;

這就是我們最終獲得的效果：