Questions tagged [enunciate]

Enunciate is an engine for dramatically enhancing your Java Web service API.

Enunciate is a tool that can be used to automatically generate REST documentation by using JAX-RS and javadoc annotations. This can be integrated with build technologies such as ant, maven, and gradle.

140 questions
2
votes
1 answer

enunciate to create docs for existing java REST API

i am using 'enunciate' for the existing Java REST (using Jersey) project. i have build.xml and enunciate.xml: output file docs.zip is created but after unzip this file, i have: css/ dir, js/ dir, robots.txt, model.html, index.html, favicon.ico,…
derek
  • 51
  • 3
  • 6
2
votes
2 answers

Enunciate Ant task broken since upgrade to Java 7

I use enunciate (1.27) to generate rest documentation as part of an ant build (1.9.2), as follows:
YetAnotherMatt
  • 391
  • 4
  • 9
2
votes
2 answers

Enunciate not able to assemble a jersey based REST API to upload a file: No more than one JAX-RS entity parameter is allowed

I have a resource like this. Enunciate has problem documenting this resource: "No more than one JAX-RS entity parameter is allowed (all other parameters must be annotated with one of the JAX-RS resource parameter…
Rama Palaniappan
  • 365
  • 1
  • 3
  • 12
2
votes
2 answers

Unable to create enunciate java client using ant task

I am attempting to create the java-client library using an enunciate v1.26.2 ant task. The problem is that every time I attempt to do this, I get this warning message: WARNING: Unknown artifact 'java.client.library'. Artifact will not be…
QuestionMarcs
  • 1,672
  • 1
  • 12
  • 15
2
votes
2 answers

Enunciate REST API doc generation using ant

I am trying to integrate Enunicate to generate REST documentation of our existing API's. I get a warning "WARNING: Unknown artifact 'docs'. Artifact will not be exported." when the ant task is executed. Is there something that is missing in my…
venu
  • 21
  • 2
2
votes
1 answer

Enunciate not recognizing JAXBElement

I have a fully working & tested REST API. To create the documentation I am using enunciate. The request & response objects are generated from xsd files using jaxb. In the documentation the response objects are recognized but the type of my request…
ToHe
  • 147
  • 3
  • 13
2
votes
2 answers

Has anyone used Enunciate to generate WADL for a RestEasy service?

There are two similar questions asked here and here but no adequate answers are given. I found that I can use Enunciate to create WADL for a RestEasy service. So I tried it. In one of my services I have a method mapped to HTTP GET which I am using…
gresdiplitude
  • 1,665
  • 1
  • 15
  • 27
1
vote
3 answers

Exception while accessing Jersey REST webservice

I am trying to get REST webservices working in my app. I am using jersey with Spring 2.5. The endpoints for the webservices are generated with enunciate 1.9. When I deploy the generated war file with Tomcat and access the REST webservice I get the…
user1140448
  • 149
  • 4
  • 12
1
vote
0 answers

enunciate-maven-plugin fails to compile class with generic type

I'm updating a legacy project using java 8 and enunciate-maven-plugin version 2.13.0. I have updated to jdk 11 and enunciate-maven-plugin 2.15.1 and since this I have encountered problems. parent-pom jax-rs-api
ChambreNoire
  • 387
  • 7
  • 19
1
vote
2 answers

Enunciate with spring mvc rest and other Enunciate Questions

Does any knows if Enunciate supports Spring MVC @RequestMapping rest annotations. If so does anyone have an enunciate.xml and pom.xml file for running the mvn plugin. The mvn plugin is not merging my web.xml properly.. So how do you rename /api…
chrislovecnm
  • 2,549
  • 3
  • 20
  • 36
1
vote
1 answer

measure pact test coverage of an API

Given the importance of automated tests I am wondering if there are possibilities to measure the test coverage for Pact tests. Remember that for unit tests, most frameworks/IDEs provide means to check which parts of the code were executed and thus…
melli79
  • 21
  • 1
  • 3
1
vote
1 answer

Selectively ignore certain api's for documentation

Does enunciate provide a means to selectively ignore certain api's? For example, if I have the following REST service: @PUT @Path("/somePath") @Produces({"application/xml"}) Response somePrivateService(Data someData); How can I exclude it from the…
TERACytE
  • 7,553
  • 13
  • 75
  • 111
1
vote
0 answers

Using Enanciate 2.6 with spring framework

I have spring 4 application i try to document rest api. This in my pom.xml : org.springframework.boot spring-boot-maven-plugin
Ivan Georgiev
  • 11
  • 1
  • 4
1
vote
1 answer

JAX-WS and Enunciate - How to change Enunciate's default XSD naming convention

I'm using Enunciate to generate a SOAP endpoint for a Wicket web application I am working on and I have a couple of questions that I haven't figured out the solution to yet. 1 How do I change the name of the xsd files? I've looked through the FAQ…
John
  • 2,571
  • 6
  • 32
  • 40
1
vote
1 answer

How to get enunciate to ignore duplicate REST paths?

We have several methods in a spring REST API that designed to handle requests that fit our API exactly, or allow for a trailing slash. We use this annotation: @RequestMapping(value = {"", "/"}, produces = {"application/json"}, method =…
crobicha
  • 1,674
  • 1
  • 16
  • 21
1 2
3
9 10