# Extended WADL WebApp Example

This example demonstrates how to get an extended WADL generated by jersey.

## Contents

The description of what's done here you'll find in the jersey wiki.

Just as a pointer at which files you might have a look:

- pom.xml
- src/main/webapp/WEB-INF/web.xml
- src/main/resources/*
- src/main/xsd/schema.xsd
- com.sun.jersey.samples.extendedwadl.SampleWadlGeneratorConfig

The mapping of the URI path space is presented in the following table:

URI path | Resource class | HTTP method | Description
--- | --- | --- | ---
items | ItemsResource | POST | Creates a new item and allocates a new unique URI for it, the new URI is returned back in the Location header
items/{id} | ItemResource | GET | Returns an item with the id={id}
items/{id}/value/{val} | ItemResource | PUT | Updates the value of the item with the id={id} with the new value {val}

## Running the Example

If you are working with Jersey GlassFish update center module installed into your existing GlassFish instance, you will need to follow instructions at the module README file in order to deploy the example.

Otherwise, you can run the example using embedded GlassFish as follows:

run

> `mvn clean package embedded-glassfish:run`

or you can run the example using Jetty as follows:

> `mvn clean package jetty:run`

Get the generated wadl via curl:

> `curl http://localhost:8080/extended-wadl-webapp/application.wadl`

Or from a web browser, visit:

> `http://localhost:8080/extended-wadl-webapp/application.wadl`