问题标签 [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 - 阐明:在我的 wadl 中,为什么我所有的资源路径属性都以“/rest”为前缀?
资源类定义如下:
我有一个这样定义的方法:
当我运行 maven 命令运行enunciate doc 目标时,生成的 wadl 如下所示:
这个“/rest/”在资源路径中来自哪里?我在我的项目中到处搜索,没有任何参考。
这是我的 enunciate.xml 配置文件:
jaxb - Enunciate 生成的文档中的 JSON 对象缺少对象根元素
我正在使用 Enunciate 为我的 REST 项目生成文档。我遇到的问题是它生成的示例 json 对象。虽然 XML 表示是正确的,但同一对象的 JSON 表示缺少根元素(在下面的示例中是“env”)
然后Java类定义对象类型“env”
Enunciate 生成的 XML 文档(这是正确的 - 根元素和所有)
Enunciate 生成的 JSON 文档(不正确 - 缺少根元素 "env")
任何帮助是极大的赞赏。
java - Enunciate 的命名空间问题
我有一个 jax-ws 项目,它使用 Enunciate 和 Maven 构建一个 war 文件。当我将它部署到我的应用服务器时,我在尝试使用 SoapUI 进行测试时遇到了奇怪的命名空间问题。xml 请求将具有我的复杂类型的正确命名空间前缀,但是当请求提交到服务器时,该对象始终为空。
这是我的网络服务界面:
用发音可以很好地构建,但是当我尝试通过 SoapUI 发出请求时,“狗”对象作为 null 传入服务器。
如果我在 Maven 中禁用 enunciate 的“assemble”目标,并将“targetNamespace”添加到我的狗 WebParam,那么该请求与 SoapUI 完美配合。
但是,如果我尝试使用“assemble”目标构建我的项目,部署将失败并出现以下错误:
我看到发音生成的“提交”请求包装类和我的“狗”对象之间存在某种脱节,但对于我的生活,我无法解决它。请帮忙!提前致谢。
java - Maven 阐明错误:“字符串索引超出范围:0”
当我使用 构建我的 Maven 项目或生成我的 eclipse 配置mvn eclipse:eclipse
时,我收到以下错误:
我已将问题隔离为单个依赖项:
我需要这种依赖,所以摆脱它不是一种选择,但为什么这会导致发音错误?有没有什么办法解决这一问题?
编辑:经过一些进一步的测试,问题的根源可能来自上一个依赖项的依赖项的依赖项的依赖项的依赖项:
完整错误:
java - 说明验证失败
在项目上运行时出现以下错误mvn -e enunciate:docs
:
任何地方都没有提到我的 java 文件。有什么方法可以找出导致问题的文件吗?
我也启用了 -X 选项运行命令,我得到的唯一 [DEBUG] 消息是类型[class name] is a potential schema type definition, but we're not going to add it directly to the model. (It could still be indirectly added, though.)
知道出了什么问题吗?
enunciate - 以发音方式停用 XML 示例和 XML 文档
我有一个使用 enunciate 记录的 REST 服务。我的端点都没有提供应用程序/xml 输出。我仍然得到类似于这里的文档: http: //enunciate.codehaus.org/wannabecool/step4/el_persona_persona.html(示例 XML)和这里:http ://enunciate.codehaus.org/wannabecool/step4/persona_persona.html ( XML 属性)。
我只提供带有 JSON 输出的服务(不要问我为什么,这不是我的决定)。因此,我不需要 XML 输出,因为它会向界面用户建议可以将界面与 XML 数据一起使用。
您可以在下面找到我的 enunciate.xml。您可以看到我已经尝试通过仅将 content-type application/json 放入 content-types 并放入 xml/disabled=true 来禁用 XML 生成:
如何正确停用 XML 文档?
java - 从 Enunciate 文档中排除某些响应模型字段
问题:我有一些 Java 模型在某些端点上同时用于请求和响应主体。问题是,根据特定请求,我不想显示该模型中的所有字段;另外,在响应中,也许我想展示来自同一模型的完全不同的字段。
问题:这可能使用 Enunciate 吗?或者我们只需要在请求和响应中使用相同的模型组合?
我对此进行了调查并找到了Enunciate API Facets。但是,还没有弄清楚如何从模型中只排除一些字段。除了这个特定功能之外,目前我发现 Enunciate 非常有用且易于使用。它还可以生成非常好看的文档。:)
documentation - 阐明数据模型文档
我在多模块 Maven 项目中使用 Enunciate。我使用 1.28 版,我只是将它用于 SOAP 服务的文档目的。
这适用于所有服务。targetNamespace 和 endpointInterface 必须在 @WebService 注释中声明,一切正常。我得到了带有 wsdl/wadl/xsd/html 输出的 zip。
通过输出文件识别和发布所有 javadoc。
但是...如果没有,我不会在这里写但是...
所有数据模型文件都不会!我尝试了以下选项:
模块不包含在 webarchive 中,但声明为依赖项:
数据模型中的 DTO 和 ENUMS 通常提供有:
以及关于类和属性的 Javadoc。
但我也在 getter 和 setter 上尝试了 Javadoc。
我什至从我的项目的示例实现中尝试了一些 xml 注释:
没有成功。javadoc 不会像 SOAP 服务那样包含在 xsd/wsdl/html 文件中。
你有什么主意吗?
java - 使用基于 SpringMVC Annotation 的配置进行发音
我正在尝试使用 Enunciate 为使用 Spring MVC 3.2 用 Java 编写的 REST API 生成静态文档。Enunciate 网站声称它通过在此处使用特定插件来支持 Spring:
http://enunciate.codehaus.org/module_spring_app.html
查看配置选项时,看起来我应该导入一个spring applicationContext.xml。我对这个项目使用了基于注解的配置,所以我没有 applicationContext.xml。有没有办法在我的情况下完成这项工作?
提前感谢您的帮助。
java - 无法从浏览器中部署的战争访问发音生成的文档
我正在使用 enunciate 来生成我的 rest api 文档,最初它工作正常,除非我将 spring 依赖项添加到我的项目中。
我现在的pom:
上面的配置是在api
生成的war目录下生成文档。我有以下enunciate.xml配置:
文档生成正确,但是当我试图点击http://localhost:8080/amg-web/api/index.html
它给出 404 响应时。!我在 tomcat webapp 中检查了提取的战争,其中api
目录成功生成了所有必需的文件,但仍然无法从浏览器中部署的应用程序访问它。请帮忙。