Simple Console Example

This example demonstrates how to develop RESTful web services with the embedded Grizzly server.

Contents

The example consists of three Java classes and one HTML file:

com.sun.ws.rest.sample.console.Main
Contains the main function which starts and stops the HTTP server.
com.sun.jersey.samples.console.resource.Colours
A resource class that can produce two different representations of a list of colors. The list can be filtered by a client-supplied query parameter. The resource references the Form resource using the Path annotation declared on the Colours.getColours method.
com.sun.jersey.samples.console.resource.Form
A resource class that produces a form in response to an HTTP GET, processes the content of the form when submitted, and produces a table of the submitted values in respose to the form being posted.
form.html
A static HTML file that is returned by the Form resource.

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

URI path Resource class HTTP methods
/form Form GET, POST
/form/colours Colours GET

Running the Example

Run the example as follows:

mvn clean compile exec:java

From a web browser, visit:

http://127.0.0.1:9998/resources/form

Fill in the form and submit it. Note that the pull-down list of colors is populated dynamically. Enter part of a color name in the hint box to see a filtered list of colors containing the hint.

You can see the complete list of colors at:

http://127.0.0.1:9998/resources/form/colours

Or see only those colors containing the letter 'r':

http://127.0.0.1:9998/resources/form/colours?match=r

A WADL description may be accessed at the URL:

http://127.0.0.1:9998/resources/application.wadl