Select Page

Build a REST Service That Collects HTML Form Data

Chad Lung
Published: July 13, 2022

The Jersey project is very well documented so it makes it easy to learn REST with Java. In this article I’m going to build two projects. The first project will be a very simple HTML page that presents a form to the user and then submits it to a REST project residing on the same server. The second project will be the REST part.

For this article I used the following tools:
1. Netbeans 7
2. Apache Tomcat 7
3. Jersey
4. Java

I built this on OS X Lion.

Go ahead and create a new Maven Web Application with Netbeans 7 called: MyForm

Once the project has been generated take the resulting (default) index.jsp file and delete it. In its place add a file called: index.html and add the following content to it:

<!DOCTYPE html>
        <title>REST with Forms</title>
        <meta data-fr-http-equiv="Content-Type" content="text/html; charset=UTF-8">
        <br />
        <form method="post" action="http://localhost:8080/RESTwithForms-1.0-SNAPSHOT/messages">
            Name: <input type="text" name="name" id="name" /><br />
            Message: <input type="text" name="message" id="message" /><br />
            Item 1: <input type="text" name="thelist" id="thelist" /><br />
            Item 2: <input type="text" name="thelist" id="thelist" /><br />
            <input type="submit" value="Submit" />

Basically, I created a simple (ugly) form that takes a few parameters the user enters. They submit the form and the data is sent to the REST project we will soon be building. The idea here is we are using an HTTP POST to create a new message.

Related learning by Ram N:

That’s it for the first project! With Netbean’s Maven integration do a Clean and Build and then deploy the resulting WAR file to Apache Tomcat.

Create another new Maven Web Application with Netbeans 7 called: RESTwithForms

Add two new Java classes to the new project:
1. MyApplication
2. MessageResource

The code for is as follows:

package com.giantflyingsaucer;
import com.sun.jersey.api.core.PackagesResourceConfig;
public class MyApplication extends PackagesResourceConfig {
    public MyApplication() {

In a brief nutshell this code allows us to make use of some Servlet 3.0 goodies (we don’t need to create a web.xml file for this project as an example). For more details see the sections titled: Example 2.8. Reusing Jersey implementation in your custom application model and Example 2.9. Deployment of a JAX-RS application using @ApplicationPath with Servlet 3.0 at this link.

The real guts of the REST project are in the file as seen below:

package com.giantflyingsaucer;
import java.util.List;
import java.util.UUID;
public class MessageResource {
    public Response createMessage(@FormParam("name") String name,
                                @FormParam("message") String message,
                                @FormParam("thelist") List<String> list) {
        if(name.trim().length() > 0 && message.trim().length() > 0 && !list.isEmpty()) {
            // Note 1: Normally you would persist the new message to a datastore
            // of some sort. I'm going to pretend I've done that and
            // use a unique id for it that obviously points to nothing in
            // this case.
            // Note 2: The way I'm returning the data should be more like the commented
            // out piece, I am being verbose for the sake of showing you how to
            // get the values and show that it was read.
            return Response.created(URI.create("/messages/" + String.valueOf(UUID.randomUUID()))).entity(
                    name+ ": " + message + " --> the items: " + list.get(0) + " - " + list.get(1)).build();
            // This is a more real world "return"
            //return Response.created(URI.create("/messages/" + String.valueOf(UUID.randomUUID()))).build();
        return Response.status(Response.Status.PRECONDITION_FAILED).build();

Note: Pay special attention to the comments. Please don’t email me stating I shouldn’t be returning text back with the values, also please don’t tell me I should be iterating the list, etc. this is just a demo. You will obviously do this differently in a production environment. The key here is simplicity and minimal code.

At this point you need to add jersey-server as a dependency in your POM file.


With Netbean’s Maven integration do a Clean and Build and then deploy the resulting WAR file to Apache Tomcat. You are now ready to test it out. Load up the HTML file from the first project and enter some data and then submit it.

If you have a tool like FireBug for Firefox, you can also see that an HTTP 201 was returned (if successful).

If you don’t enter any data in the form then you should get an HTTP 412 back.

With not much more work you could just as easily use something like jQuery and submit the form via AJAX.