为 GAE 使用 Restlet Swagger 扩展的指南

Question

我尝试做类似的方法：

public Restlet createInboundRoot() {
        Router apiRouter = createApiRouter();
        attachSwaggerSpecificationRestlet(apiRouter, "/api-docs");
        return apiRouter;
}

当/api-docs 被访问时，Restlet 会抛出错误 404，这可能是什么问题。我们的想法是，当我们访问 /stuff 等资源时，我们拥有的 apiRouter 完全在这种状态下工作。

此代码中可能缺少什么？或者在为 GAE 使用 Restlet Swagger 扩展时是否有任何具体的注意事项需要考虑？

Answer 1

我测试了您的用例，我可以使用以下 Maven 配置 (restlet-version = 2.3.1)AE 开发服务器使 Swagger 扩展工作：

<dependencies>
    <dependency>
        <groupId>org.restlet.gae</groupId>
        <artifactId>org.restlet</artifactId>
        <version>${restlet-version}</version>
    </dependency>

    <dependency>
        <groupId>org.restlet.gae</groupId>
        <artifactId>org.restlet.ext.servlet</artifactId>
        <version>${restlet-version}</version>
    </dependency>

    <dependency>
        <groupId>org.restlet.gae</groupId>
        <artifactId>org.restlet.ext.swagger</artifactId>
        <version>${restlet-version}</version>
        <exclusions>
            <exclusion>
                <groupId>org.raml</groupId>
                <artifactId>raml-parser</artifactId>
            </exclusion>
        </exclusions>
    </dependency>

    <dependency>
        <groupId>org.restlet.jse</groupId>
        <artifactId>org.restlet.ext.jetty</artifactId>
        <version>${restlet-version}</version>
    </dependency>
</dependencies>

您会注意到我必须在 ext.swagger 中排除 RAML 解析器。

这是我的 Restlet 应用程序的代码：

public class RestletApplication extends SwaggerApplication {
    @Override
    public Restlet createInboundRoot() {
        Router router = new Router(getContext());

        router.attach("/ping", MyServerResource.class);
        attachSwaggerSpecificationRestlet(router, "/docs");

        return router;
    }
}

如果对您有帮助，我可以在 Github 存储库中提供我的测试项目。

希望对你有帮助