node -v
v10.16.0

npm -v
6.9.0

$ npm install -g swagger

$ swagger project create hello-world

? Framework? (Use arrow keys)
  connect
❯ express
  hapi
  restify
  sails

$ cd cd hello-world

//依存性のあるモジュールをインストールします
$ npm install

$ swagger project start

'use strict';/*
 'use strict' is not required but helpful for turning syntactical errors into true errors in the program flow
 https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Strict_mode
*//*
 Modules make it possible to import JavaScript files into your application.  Modules are imported
 using 'require' statements that give you a reference to the module.

  It is a good idea to list the modules that your application depends on in the package.json in the project root
 */varutil=require('util');/*
 Once you 'require' a module you can reference the things that it exports.  These are defined in module.exports.

 For a controller in a127 (which this is) you should export the functions referenced in your Swagger document by name.

 Either:
  - The HTTP Verb of the corresponding operation (get, put, post, delete, etc)
  - Or the operationId associated with the operation in your Swagger document

  In the starter/skeleton project the 'get' operation on the '/hello' path has an operationId named 'hello'.  Here,
  we specify that in the exports of this module that 'hello' maps to the function named 'hello'
 */module.exports={goodbye:goodbye};/*
  Functions in a127 controllers used for operations should take two parameters:

  Param 1: a handle to the request object
  Param 2: a handle to the response object
 */functiongoodbye(req,res){// variables defined in the Swagger document can be referenced using req.swagger.params.{parameter_name}varname=req.swagger.params.name.value||'stranger';vargoodbye=util.format('Good bay, %s!',name);// this sends back a JSON response which is a single stringres.json(goodbye);}

paths:/hello:# binds a127 app logic to a routex-swagger-router-controller:hello_worldget:description:Returns 'Hello' to the caller# used as the method name of the controlleroperationId:helloparameters:-name:namein:querydescription:The name of the person to whom to say hellorequired:falsetype:stringresponses:"200":description:Successschema:# a pointer to a definition$ref:"#/definitions/HelloWorldResponse"# responses may fall through to errorsdefault:description:Errorschema:$ref:"#/definitions/ErrorResponse"/goodbye:# binds a127 app logic to a routex-swagger-router-controller:goodbyeget:description:Returns 'Good Bye' to the API Caller.# used as the method name of the controlleroperationId:goodbyeparameters:-name:namein:querydescription:The name of the person to whom to say hellorequired:falsetype:stringresponses:"200":description:Successschema:# a pointer to a definition$ref:"#/definitions/HelloWorldResponse"# responses may fall through to errorsdefault:description:Errorschema:$ref:"#/definitions/ErrorResponse"