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());
}