In JAX-RS, you can use @FormParam annotation to bind HTML form parameters value to a Java method. The following example show you how to do it :

1. HTML Form

See a simple HTML form with “post” method.


<html>
<body>
	<h1>JAX-RS @FormQuery Testing</h1>

	<form action="rest/user/add" method="post">
		<p>
			Name : <input type="text" name="name" />
		</p>
		<p>
			Age : <input type="text" name="age" />
		</p>
		<input type="submit" value="Add User" />
	</form>

</body>
</html>

2. @FormParam Example

Example to use @FormParam to get above HTML form parameter values.


import javax.ws.rs.FormParam;
import javax.ws.rs.POST;
import javax.ws.rs.Path;
import javax.ws.rs.core.Response;

@Path("/user")
public class UserService {

	@POST
	@Path("/add")
	public Response addUser(
		@FormParam("name") String name,
		@FormParam("age") int age) {

		return Response.status(200)
			.entity("addUser is called, name : " + name + ", age : " + age)
			.build();

	}

}

3. Demo

Access HTML Page. URL : http://localhost:8080/RESTfulExample/UserForm.html

demo html page

When “add user” button is clicked, it will redirect to URL : http://localhost:8080/RESTfulExample/rest/user/add

demo jax-rs result

and display the following output :


addUser is called, name : mkyong 123, age : 12

Download Source Code

Download it – JAX-RS-FormParam-Example.zip (6 KB)

Reference

  1. JAX-RS @FormParam JavaDoc