问题标签 [enunciate]

我正在使用Enunciate构建原型 REST api，并且需要包含一个包含自定义代码的 jar 作为库。

我的 Ant 脚本如下所示：

问题是我的自定义 jar 被排除在 WAR 文件之外。有必要编译 enunciate 带注释的类，因此 jar 在编译时显然位于类路径上，但 enunciate 未能将其包含在分发中。我还注意到 enunciate 所需的几个 jar 没有包含在 WAR 文件中。

为什么他们被排除在外，我该如何解决？

因此，我正在尝试 Enunciate，并且在我的 servlet 启动时遇到了问题。出于某种原因，尽管文件在那里，在类路径中，并且所有内容都正确指定，但 Spring 告诉我以下内容：

结构是我在 WEB-INF 中有 applicationContext.xml（由 Enunciate 生成）、web.xml 和 spring-user-config.xml，然后在 WEB-INF/classes/resources 中有 hibernate.xml。

我已经使用“类路径：”尝试了所有相对路径和绝对路径，但我想不出任何其他找不到它的原因。

这是在我的 spring-user-config.xml 文件中声明 sessionFactory bean 的位置：

任何帮助使其工作的人将不胜感激！

提前致谢。

只是想问一下是否有人知道将 Web 服务（wsdl）作为 Web 表单向最终用户公开的可靠且简单的方法。

我们的团队为外部联系人开发了很多软件，这通常涉及创建 Web 服务并将其公开为 wsdl 和网站。我们希望尽可能地自动化这最后一步（尤其是对于无意识的数据泵送项目），这样我们就可以专注于开发 Web 服务而不是网站。

我最近遇到了 Enunciate，但还没有时间详细玩它。我想知道是否有人对此（或任何类似项目）有任何经验，您的发现是什么，以及您会建议我们采取什么方向。

最好的问候，蒂姆

更新 2 ：原来我需要的东西在这个 Enunciate 模块中得到了完美的描述：http : //jira.codehaus.org/browse/ENUNCIATE-23。唯一的问题是它没有实现......（还没有？）
任何人都有创建自己的模块的经验，或者知道提供相同功能的现有解决方案吗？

我尝试使用 spring 和 enunciate+jax-ws/jax-rs 注释设置一个简单的项目，但我没有得到它的工作。

我在发音集成教程中使用了一些很棒的教程

像在教程中一样发音创建 api 页面，但我收到此错误：如果我打开一个挂载点，例如 REST 一个 (/rest/Service/getService/1)，我将收到 404-Error: NOT_FOUND

这是我的代码示例：

发音.xml：

我的网络服务实现：

我的网络服务界面：

我将@XmlRootElement 放在模型上。在 spring 应用程序上下文 xml 文件中：

这是我的 web.xml ：

合并 xml：

你可以看到一些关于 flex、jersey 和 spring 的配置并发音。我已经尝试了几种配置，我无法获得 xml 或 json 响应......只有 404。没有人知道出了什么问题吗？enter code here

如果我有一个用 Symfony [symfony-project.org] 框架（即 PHP）编写的基于 REST 的服务，是否有任何像样的工具/框架可以解析我的代码并生成 API 文档？

基于 Java 的框架 enunciate 具有类似于我需要的文档功能，您可以在此处查看此示例：http: //enunciate.codehaus.org/wannabecool/step1/index.html。

我了解基于 REST 的服务的前提应该是不言而喻的，但是我正在寻找可以为我生成此文档的东西，而无需手动编写所有端点、支持的格式、示例输出等。

谢谢

我们正在使用 Apache CXF 代码优先方法来创建 Web 服务。我们有一个自定义的肥皂头来传递用户凭据。

我正在尝试使用 @webparam 注释在 SEI 中传递用户凭据。

这是 Service 类中的两个操作。

生成 wsdl 时发音会抛出错误，说

D:\workspace\myService\src\main\java\com\ws\api\ItemPublicationWebService.java:52: [xml] Web 方法定义了一个名为“userDetails”的消息部分，它与定义的 Web 消息部分的名称相同在 D:\workspace\myService\src\main\java\com\ws\api\ItemPublicationWebService.java:41。请使用注释来消除歧义。

我发现保持 webParam 名称唯一会生成 wsdl。但这不是预期的结果。

我在这里想念什么？

我创建了一个 Web 服务并希望为 API 生成文档。所以我查看了Enunciate下载了 maven enunciate 插件。但是，我在编译时收到以下错误，因为 web 服务注释在我的 POJO 实现的接口类上，而不是 POJO 本身。

pom.xml 片段在这里

我整天都在编译我的应用程序，但它突然开始失败。正如您从下面看到的那样，这是一个NullPointException但我不知道出了什么问题。有没有人处理过这个问题，或者可以提供任何帮助或指导？

我正在使用 Enunciate 为我正在处理的 Wicket Web 应用程序生成一个 SOAP 端点，我有几个问题我还没有找到解决方案。

1 如何更改 xsd 文件的名称？我浏览了常见问题解答，它告诉我做类似的事情：

但是，我还没有完全弄清楚如何为我的数据对象设置 targetNamespace。我已经通过 @WebService ( targetNamespace="blah" ) 为我的服务完成了这项工作，但是如何注释我的数据对象以让 Enunciate 知道它们应该属于哪个命名空间？

2 Enunciate 可以很好地生成我的 XSD，但我并不特别喜欢它使用的元素名称。我有一个 ServiceRequest 和 ServiceResponse 对象。ServiceRequest 对象有一个用户对象列表。ServiceResponse 有一个 Group 对象列表。Enunciate 建议 ServiceRequest 中的每个“用户”对象都应该使用标签“<users>”。我觉得使用单数形式“<user>”更有意义，因为标签实际上只包含一个用户。是否有可能改变这种行为，如果可以，如何改变？

提前致谢。

我遇到了一个相当有趣的发音错误：

“不允许超过一个 JAX-RS 实体参数（所有其他参数必须使用 JAX-RS 资源参数注释之一进行注释）。”

我正在使用 enunciate 构建支持 XML 和 JSON 的 SOAP 和 REST API。Enunciate 配置为使用所有 service.* 和 service.impl.* 类。每个服务都包含用于发音文档的所有 Javadoc，以及一个 [@GET @POST @PUT @DELETE] 和一个 @Path 注释。每个服务实现都包含一个类 @Path 注释。

示例界面：

示例实现：

当我在我的服务中注释掉“@POST”和“@PUT”注释时，发音会运行得很好。但是，评论其中任何一个都将失败并显示上述消息。问题是我的服务包含 2-8 个不同的模型（例如：我的 addressService 包含 3 个对象：地址、州和国家/地区），因此我指定了路径上下文（使用地址）如下：

在 impl 上：

关于方法：

如果我能提供更多信息，我很乐意提供。这是一个相当令人沮丧的问题，因为我不确定我是否错误地配置了发音（值得怀疑，这是一个基本配置），或者我是否在扩展 JAX-RS 的功能。我花了很多时间阅读教程、谷歌搜索和查看 Javadoc（用于发音和 JAX-RS），但运气不佳。

有没有其他人看到这个问题？关于我可以做些什么来解决它的任何想法？我有一种感觉，这将是那些“没有”的修复之一……只是不能把我的手指放在它上面。

在此先感谢您的帮助。