Question

resources.js

'use strict';
var sw = require('swagger-node-express');
var paramTypes = sw.paramTypes;
var swe = sw.errors;

var petData = require('./service.js');

// the description will be picked up in the resource listing
exports.findById = {
  'spec': {
    description : 'Operations about pets',  
    path : '/pet/{petId}',
    method: 'GET',
    summary : 'Find pet by ID',
    notes : 'Returns a pet based on ID',
    type : 'Pet',
    nickname : 'getPetById',
    produces : ['application/json'],
    parameters : [paramTypes.path('petId', 'ID of pet that needs to be fetched', 'string')],
    responseMessages : [swe.invalid('id'), swe.notFound('pet')]
  },
  'action': function (req,res) {
      console.log('findById call');
    if (!req.params.petId) {
      throw swe.invalid('id'); }
    var id = parseInt(req.params.petId);
    var pet = petData.getPetById(id);

    if(pet) { 
        res.send(JSON.stringify(pet));
    } else { 
        throw swe.notFound('pet', res); 
    }
  }
};

model.js

exports.models = {
    'Pet':{
      'id':'Pet',
      'required': ['id', 'name'],
      'properties':{
        'id':{
          'type':'integer',
          'format':'int64',
          'description': 'Unique identifier for the Pet',
          'minimum': '0.0',
          'maximum': '100.0'
        },
        'name':{
          'type':'string',
          'description': 'Friendly name of the pet'
        }
      }
    }
  };

您好我在我的node.js应用程序中使用swagger-node-express。我成功配置，它工作正常。

但是现在我在用swagger-ui记录时遇到了问题。 swagger-ui需要JSON文件。如何从这两个文件生成文档。

Answer 1

Swagger-node-express根据您提供的规范生成json。你只需要通过调用

告诉它在哪里发布它

swagger.configureSwaggerPaths('', 'api-docs', '');

在[yourdomain] / api-docs上发布json api描述，例如

localhost:8080/api-docs

当然，你可以改变api-docs＆＃39;任何你想要的名字。

要使用swagger-ui检查api，您需要将其解压缩到目录中的某个位置。我的是../swagger-ui/dist。告诉express以静态方式提供其中的文件，并给它一个路径，如/ docs：

var dirname = __dirname + '/../swagger-ui/dist/';
var docs_handler = express.static(dirname);
app.get(/^\/docs(\/.*)?$/, function(req, res, next) {
  if (req.url === '/docs') { // express static barfs on root url w/o trailing slash
    res.writeHead(302, { 'Location' : req.url + '/' });
    res.end();
    return;
  }
  // take off leading /docs so that connect locates file correctly
  req.url = req.url.substr('/docs'.length);
  return docs_handler(req, res, next);
});

现在将浏览器指向

localhost:8080/docs

应显示swagger-ui界面。要使UI直接显示您的api规范，请在swagger-ui index.html文件中添加api-docs url：

window.swaggerUi = new SwaggerUi({
    url: "/api-docs",

应该采用更简洁的方式进行最后一次调整，但我还没有发现。

从swagger-node-express spec.js和model.js创建文档

1 个答案: