问题标签 [enunciate]

我有一个返回“javax.ws.rs.core.Response”实体的 REST Web 服务。当我运行 enunciate 时，它​​无法确定输出类型，因此生成的 wadl 中的响应留空：

如果代码如下所示：

WADL 内容如下：

而不是：

无论如何，它在这里要清楚地识别响应返回类型？

我正在尝试使用 CXF 的 Enunciate 插件通过配置如下的 Maven 插件为我的 REST 接口生成文档：

但是当我尝试运行插件时，我从命令行收到错误命令：

错误是：

有什么建议么？

提前致谢，

马克

更新：我将插件更改为：

它可以工作，但我的 JSON 对象返回类型和参数没有被记录。

发音是否提供了一种选择性忽略某些 api 的方法？例如，如果我有以下 REST 服务：

如何将它从发音生成的文档中排除？例如：

我很难在我的项目上运行 Enunciate。该项目是一个多模块 maven 项目，可从https://svn.opentripplanner.org/trunk获得。我想要的只是 API 文档。没有其他的。我们曾经通过 Maven 和 Hudson 进行这项工作，但它不久前就坏了，并且设置它的人不可用。真的，我更愿意通过命令行界面来做这件事，但如果有人有 Maven 解决方案，我会接受的。

我口齿不清的命令行是：

我的 enunciate.xml 看起来像这样：

我口齿不清的输出是：

AgencyAndIdAdapter确实适应了 AgencyAndId。当我运行它时，实际代码工作得很好。我尝试使用 XmlAdapter 适应随机 Java 类 (JPanel) 构建一个小型测试用例，它工作正常。所以我无法弄清楚如何进一步减少问题。

我不认为有关 Autowire/Component/etc 的错误会导致此问题，因为如果我排除所有包含这些注释的文件（|xargs grep -L 'Autowire|Component|Request' 就在结束反引号之前），我仍然得到错误的其余部分。不过，解决这些问题也很好。

我正在以 RESTful 方式创建 Web API。Grails 当然对创建 REST Web 服务有很好的支持。阐明在 API 部分提供帮助的声明，其中文档、客户端库等很重要。

这篇文章的目的是邀请使用 Enunciate with Grails 的经验，或关于如何做到这一点的想法。

一起使用它们有两个主要问题：

1. Enunciate 与 JAX-RS 一起工作，而不是 Grails 对 REST 的本机实现。谢天谢地，有一个可用的 JAX-RS 插件，但不确定 Enunciate 是否能够使用它。

2. Grails 域类在 Groovy 中，而 Enunciate 使用 Java 源代码（示例）。

我的 RESTEasy 代码中有以下注释：

Enunciate 在文档中生成一个“挂载点”，如下所示：

我尝试在我的 enunciate.xml 中使用以下内容来覆盖“/rest”上下文：

我也尝试了以下方法，但它也没有做任何事情：

我正在使用 enunciate 1.23 为 Maven 3 多模块项目生成文档。

以下是写入控制台的内容：

知道我做错了什么吗？

更多信息... 完整的 enunciate.xml（以防出现影响条目的问题：

顺便说一句，如果有更好的方法来获得这个问题的帮助（某种错误论坛），请告诉我。我是一个发音清晰的新手，不知道这是一个错误还是我的无知。

有谁知道 Enunciate 是否支持 Spring MVC @RequestMapping 休息注释。如果是这样，是否有人有用于运行 mvn 插件的 enunciate.xml 和 pom.xml 文件。mvn 插件没有正确合并我的 web.xml..

那么，您如何重命名 Enunciate 创建的 /api servlet……这是我要记录的 servlet 的名称。

提前致谢。

我有多个 Maven 模块，它们为我的服务公开各种 REST。最重要的是，我有一个（几乎是空的）模块，称为 project-docs，我想使用它并生成一个聚合的 Enunciate api 文档。不幸的是，Enunciate 确实希望在执行它的模块中找到一些（如果不是全部）REST。

我试过这个https://github.com/stoicflame/enunciate/wiki/Multi-Module-Projects-%28Version-1%29，但似乎没有用。此外，我还没有找到org.codehaus.enunciate:maven-enunciate-plugin的任何教程/描述。

查看上面的链接，我已经明确公开了其中一个模块的源代码，并将其复制到target/enunciate-scratch目录中。但是，我认为我缺少一些配置选项。

任何人都可以帮忙吗？

如果有任何错误，请原谅我 - 我对 Java 完全陌生。我的任务是为即将推出的 Facebook 游戏设置客户端/服务器架构。在服务器端，我有：

• 爪哇
• 雄猫
• 高枕无忧
• BlazeDS
• 发音

所有这些都与 Maven 结合在一起。我可以用 @Path() 注释 RESTful 端点，当我在浏览器中点击它们时，它们会吐出在 AMF 中序列化的对象。到现在为止还挺好。现在我需要在客户端/Flex 端使用这些端点。Enunciate 已经为我在 Java 中使用 @XmlRootElement 注释的类型生成了 AS 文件，我可以在我的 AS3 代码中使用这些类型。问题是在 AS3 中访问 REST 端点非常难看。它看起来像这样：

丑陋 - 我必须手写这个才能获得强类型的好处。然而！我在挖掘源代码时注意到，如果使用@WebService 和@WebMethod 标签而不是@Path，我的服务类的精彩强类型AS3 包装器将由Enunciate 生成，以及相应的AS3 事件。它还会生成正确的 services-config.xml！然后用法变成这样：

如您所见，生成代码的使用者不需要知道端点在哪里，从事件返回什么类型等。我想走这条路线，因为我相信它会更容易维护。这让我想到了我的问题：

1. 为什么只为@WebService 和@WebMethod（互联网告诉我是JAX-WS）而不是@Path 生成美妙的Service 和ServiceEvent 对象？是尚未完成的工作，还是鉴于 JAX-RS 和 JAX-WS 之间的规范差异而无法完成的工作？（我看到 as3-endpoint.fmt 专门只适用于代码中的@WebService）
2. 我想在这里使用 REST 有错吗？我的 CTO 推荐了 Java/Tomcat/RestEasy/BlazeDS 堆栈，但在我看来（在摆弄了一两天之后）BlazeDS/Flex 与 REST 相处得不太好。
3. 是否有我应该考虑的 Java->AMF->Flex 堆栈？

感谢您抽出宝贵时间，如果这些是明显的问题，我再次感到抱歉。我的背景是游戏开发，而不是网络开发。

我正在尝试让 REST Web 服务在我的应用程序中运行。我正在使用带有 Spring 2.5 的球衣。Web 服务的端点是使用 enunciate 1.9 生成的。当我使用 Tomcat 部署生成的 war 文件并访问 REST Web 服务时，出现以下异常：

根本原因：

note Apache Tomcat/6.0.33 日志中提供了根本原因的完整堆栈跟踪。

我web.xml的 REST servlet 部分如下所示：

我需要在配置中修复一些可以解决问题的东西吗？