招摇不工作 [英] Swagger not working

问题描述

我在使用 Restlet 制作 Swagger 显示 API 文档时遇到了一些麻烦.Swagger 展示的只是这些东西:

I'm having a bit of trouble making Swagger display API docs using Restlet. What Swagger shows is just these stuff:

并检查 api-docs 它只显示这一点:

And checking the api-docs it only shows this:

我想知道我的代码有什么问题:

I wonder what is wrong with my code:

public class MyApplication extends SwaggerApplication {
    private static final String ROOT_URI = "/";
    public Restlet createInboundRoot() {
        Router router = new Router(getContext());
        router.attach(ROOT_URI, RootServerResource.class);
        router.attach(ROOT_URI + "ping", PingServerResource.class);
        router.attach(ROOT_URI + "ping/", PingServerResource.class);
        // Some code omitted for simplicity
        return router;
    }
}

推荐答案

你可以看看这篇文章:

• APISpark 可以为您现有的 Web API 带来什么(第 2 部分)-http://restlet.com/blog/2016/01/04/what-c​​an-apispark-bring-to-your-existing-web-apis-part-2/

Swagger1 和 2 都由 Restlet 的 Swagger 扩展支持:

Both Swagger1 and 2 are supported by the Swagger extension of Restlet:

• Swagger v1

public class ContactsApplication extends SwaggerApplication {
    public Restlet createInboundRoot() {
        Router router = new Router();
        (...)
        attachSwaggerSpecificationRestlet(router, "/docs");

        return router;
    }
}

Swagger v2

public class ContactsApplication extends Application {
   public Restlet createInboundRoot() {
        Router router = new Router();
        (...)
        Swagger2SpecificationRestlet swagger2SpecificationRestlet
                               = new Swagger2SpecificationRestlet(this);
        swagger2SpecificationRestlet.setBasePath("http://myapp.org/");
        swagger2SpecificationRestlet.attach(router, "/docs");
        return router;
    }
}

这篇关于招摇不工作的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！