# Generate WADL Example

The example shows, how to generate a customized WADL for your application offline (without a running jersey app).

## How to run the example

### Generate the application.wadl

Build the project, generate the `resourcedoc.xml` with javadoc and generate the wadl file:

    $ mvn compile javadoc:javadoc com.sun.jersey.contribs:maven-wadl-plugin:generate

Afterwards have a look at the `target/classes/application.wadl` and at these artifacts:

`pom.xml`
  How all this wadl generation stuff is configured
`src/main/java/com/sun/jersey/samples/generatewadl/resources/ItemsResource.java`
  Shows how custom javadoc tags can be used to extend the generated wadl documentation
`src/main/java/com/sun/jersey/samples/generatewadl/util/ExampleDocProcessor.java`
  Shows how you can process your custom tags and add them to the generated `resourcedoc.xml`. An "@example.tag" can be found at `ItemsResource.createItem`
`src/main/java/com/sun/jersey/samples/generatewadl/util/ExampleWadlGenerator`
  Shows how the custom information added by the ExampleDocProcessor to the `resourcedoc.xml` can be processed by this WadlGenerator and used to extend the generated `application.wadl`

### Generate a complete application.html

If you're on unix and have xsltproc installed you can simply run mvn package

    $ mvn package

and afterwards have a look at the generated `target/application.html`