问题标签 [enunciate]
For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.
java - Enunciate 无法确定 javax.ws.rs.core.Response 的输出类型
我有一个返回“javax.ws.rs.core.Response”实体的 REST Web 服务。当我运行 enunciate 时,它无法确定输出类型,因此生成的 wadl 中的响应留空:
如果代码如下所示:
WADL 内容如下:
而不是:
无论如何,它在这里要清楚地识别响应返回类型?
maven - 为 JAX-RS 阐明 CXF 插件
我正在尝试使用 CXF 的 Enunciate 插件通过配置如下的 Maven 插件为我的 REST 接口生成文档:
但是当我尝试运行插件时,我从命令行收到错误命令:
错误是:
有什么建议么?
提前致谢,
马克
更新:我将插件更改为:
它可以工作,但我的 JSON 对象返回类型和参数没有被记录。
java - 选择性地忽略某些 api 的文档
发音是否提供了一种选择性忽略某些 api 的方法?例如,如果我有以下 REST 服务:
如何将它从发音生成的文档中排除?例如:
java - XmlJavaTypeAdapter 和发音?
我很难在我的项目上运行 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' 就在结束反引号之前),我仍然得到错误的其余部分。不过,解决这些问题也很好。
api - 在 Grails 中使用 Enunciate
我正在以 RESTful 方式创建 Web API。Grails 当然对创建 REST Web 服务有很好的支持。阐明在 API 部分提供帮助的声明,其中文档、客户端库等很重要。
这篇文章的目的是邀请使用 Enunciate with Grails 的经验,或关于如何做到这一点的想法。
一起使用它们有两个主要问题:
Enunciate 与 JAX-RS 一起工作,而不是 Grails 对 REST 的本机实现。谢天谢地,有一个可用的 JAX-RS 插件,但不确定 Enunciate 是否能够使用它。
Grails 域类在 Groovy 中,而 Enunciate 使用 Java 源代码(示例)。
java - 如何更改 enunciate 生成的 REST 上下文?
我的 RESTEasy 代码中有以下注释:
Enunciate 在文档中生成一个“挂载点”,如下所示:
我尝试在我的 enunciate.xml 中使用以下内容来覆盖“/rest”上下文:
我也尝试了以下方法,但它也没有做任何事情:
我正在使用 enunciate 1.23 为 Maven 3 多模块项目生成文档。
以下是写入控制台的内容:
知道我做错了什么吗?
更多信息... 完整的 enunciate.xml(以防出现影响条目的问题:
顺便说一句,如果有更好的方法来获得这个问题的帮助(某种错误论坛),请告诉我。我是一个发音清晰的新手,不知道这是一个错误还是我的无知。
spring-mvc - 用 spring mvc rest 和其他 Enunciate Questions 进行发音
有谁知道 Enunciate 是否支持 Spring MVC @RequestMapping 休息注释。如果是这样,是否有人有用于运行 mvn 插件的 enunciate.xml 和 pom.xml 文件。mvn 插件没有正确合并我的 web.xml..
那么,您如何重命名 Enunciate 创建的 /api servlet……这是我要记录的 servlet 的名称。
提前致谢。
maven - 将 Enunciate 与 Maven/多个模块一起使用
我有多个 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 - AMF/JAX-RS 问题(一些一般性问题,一些特定于 Enunciate 的问题)
如果有任何错误,请原谅我 - 我对 Java 完全陌生。我的任务是为即将推出的 Facebook 游戏设置客户端/服务器架构。在服务器端,我有:
- 爪哇
- 雄猫
- 高枕无忧
- BlazeDS
- 发音
所有这些都与 Maven 结合在一起。我可以用 @Path() 注释 RESTful 端点,当我在浏览器中点击它们时,它们会吐出在 AMF 中序列化的对象。到现在为止还挺好。现在我需要在客户端/Flex 端使用这些端点。Enunciate 已经为我在 Java 中使用 @XmlRootElement 注释的类型生成了 AS 文件,我可以在我的 AS3 代码中使用这些类型。问题是在 AS3 中访问 REST 端点非常难看。它看起来像这样:
丑陋 - 我必须手写这个才能获得强类型的好处。然而!我在挖掘源代码时注意到,如果使用@WebService 和@WebMethod 标签而不是@Path,我的服务类的精彩强类型AS3 包装器将由Enunciate 生成,以及相应的AS3 事件。它还会生成正确的 services-config.xml!然后用法变成这样:
如您所见,生成代码的使用者不需要知道端点在哪里,从事件返回什么类型等。我想走这条路线,因为我相信它会更容易维护。这让我想到了我的问题:
- 为什么只为@WebService 和@WebMethod(互联网告诉我是JAX-WS)而不是@Path 生成美妙的Service 和ServiceEvent 对象?是尚未完成的工作,还是鉴于 JAX-RS 和 JAX-WS 之间的规范差异而无法完成的工作?(我看到 as3-endpoint.fmt 专门只适用于代码中的@WebService)
- 我想在这里使用 REST 有错吗?我的 CTO 推荐了 Java/Tomcat/RestEasy/BlazeDS 堆栈,但在我看来(在摆弄了一两天之后)BlazeDS/Flex 与 REST 相处得不太好。
- 是否有我应该考虑的 Java->AMF->Flex 堆栈?
感谢您抽出宝贵时间,如果这些是明显的问题,我再次感到抱歉。我的背景是游戏开发,而不是网络开发。
java - 访问 Jersey REST Web 服务时出现异常
我正在尝试让 REST Web 服务在我的应用程序中运行。我正在使用带有 Spring 2.5 的球衣。Web 服务的端点是使用 enunciate 1.9 生成的。当我使用 Tomcat 部署生成的 war 文件并访问 REST Web 服务时,出现以下异常:
根本原因:
note Apache Tomcat/6.0.33 日志中提供了根本原因的完整堆栈跟踪。
我web.xml
的 REST servlet 部分如下所示:
我需要在配置中修复一些可以解决问题的东西吗?