使用enunciate，如何在针对多模块pom运行时从一个页面链接所有其他API？

I'm able to run mvn enunciate:docs against my multi-module pom where modules are complete implementations of services and the sites are created under each of those (ex. service1/rest/api/target/site/wsdocs/index.html) but I would like all the rest APIs linked in a single page via enunciate.

我能够对我的多模块pom运行mvn enunciate:docs,其中模块是服务的完整实现,并且在每个模块下创建站点(例如service1 / rest / api / target / site / wsdocs / index.html) )但我希望所有其他API通过enunciate链接在一个页面中。

I'm only using enunciate to generate the API and example xml/json message bodies.

我只使用enunciate来生成API和示例xml / json消息体。

Is this possible, or do I have to create the site myself with some scripting or what have you?

这是可能的,还是我必须自己用一些脚本创建网站或者你有什么?

Thanks.

1 个解决方案

#1

This may not be the best solution but you can create a site using the maven-site-plugin and specify the different APIs for your rest from there. You need to create a site.xml and the links from there.

这可能不是最好的解决方案,但您可以使用maven-site-plugin创建一个站点,并从那里为您的其余部分指定不同的API。您需要从那里创建一个site.xml和链接。

In the site.xml you can add a link in the menu by doing something like this:

在site.xml中,您可以通过执行以下操作在菜单中添加链接:

<menu name="Overview">
        <item name="Description" href="index.html"/>
        <item name="API" href="api/index.html"/>
</menu>

In the previous example api/index.html is my API entry point.

在前面的示例中,api / index.html是我的API入口点。

#1