-
User guide
- back
- Part 1 - Introduction
- Part 2 - Core Restlet
- Part 3 - Restlet Editions
-
Part 4 - Restlet Extensions
- back
- Overview
- Editions matrix
- Atom
- Crypto
- E4
- EMF
- FileUpload
- FreeMarker
- GAE
- GSON
- Guice
- GWT
- HTML
- HTTP Client
- JAAS
- Jackson
- JavaMail
- JAXB
- JAX-RS
- JDBC
- Jetty
- JiBX
- JSON
- jSSLutils
- Lucene
- Nio
- OAuth
- OData
- OpenID
- OSGi
- RAML
- RDF
- ROME
- SDC
- Servlet
- Simple
- SIP
- SLF4J
- Spring
- Swagger
- Thymeleaf
- Velocity
- WADL
- XDB
- XML
- XStream
- Appendices
- Tutorials
- Javadocs
- Change Log
Parameters
Getting parameter values
This is a common need to retrieve data, especially “key=value” pairs from the query, the entity, or the cookies. Here are some sample lines of code which illustrate this feature.
Getting values from a web form
The web form is in fact the entity of the POST request sent to the server, thus you have access to it via request.getEntity(). There is a shortcut which allows to have a list of all input fields:
Form form = new Form(request.getEntity())
for (Parameter parameter : form) {
System.out.print("parameter " + parameter.getName());
System.out.println("/" + parameter.getValue());
}
Getting values from a query
The query is a part of the identifier (the URI) of the request resource. Thus, you have access to it via request.getResourceRef().getQuery(). There is a shortcut which allows to have a list of all “key=value” pairs:
Form form = request.getResourceRef().getQueryAsForm();
for (Parameter parameter : form) {
System.out.print("parameter " + parameter.getName());
System.out.println("/" + parameter.getValue());
}
Getting values from the cookies
Cookies are directly available from the request via the request.getCookies() method. It returns a collection of “Cookie” objects which extends the Parameter class and contains additional attributes:
for (Cookie cookie : request.getCookies()) {
System.out.println("name = " + cookie.getName());
System.out.println("value = " + cookie.getValue());
System.out.println("domain = " + cookie.getDomain());
System.out.println("path = " + cookie.getPath());
System.out.println("version = " + cookie.getVersion());
}