Question

I have successfully created the documentation for my endpoints using enunciate. This is a sample from the endpoint:

@Produces("application/json")
public class Messages {
  .....
  @DocumentationExample("provide an example")
  @Consumes("application/json")
  @GET
  Message createMessage (Message input) {
    .... store the message, validate, etc. 
  }
  ....
}

The Message is mapped in JAX-WS through Jackson and has this structure:

@XmlRootType
public class Message {
  ..
}

While this works for enunciate, I can't see neither the @Produces, nor @Consumes anywhere in the documentation. Is is possible to 'mark' domain classes somehow else -- not through @XmlRootElement, but through some external configuration file? I'm not keen on changing the domain only for enunciate (even if annotations are concerned).

I also don't see @DocumentationExample annotation (or the value specified as example). Is is possible to provide multiple examples?

Thanks.

Was it helpful?

Solution

This has since been fixed. The latest Enunciate version is 1.27.

Licensed under: CC-BY-SA with attribution
Not affiliated with StackOverflow
scroll top