This method generates a new WebResource object from this object (WebResource object). The Web resource URI that is stored in the generated object is the URI for which the query parameter specified in the parameter is added to the Web resource URI stored in this object.

public WebResource queryParams(MultivaluedMap<String,String> params)

params

This is the map of query parameters.

The method returns the generated WebResource object.

• The NullPointerException exception is thrown if null is specified in the params parameter.
• If a null key is included in the query parameter map specified in the params parameter, the IllegalArgumentException exception is thrown.
• From the combination of keys and values in the query parameter map specified in the params parameter, if the key is non-null and the value is null, only the key is added as a query parameter of the generated WebResource object.
• Specify the correct query parameter in the params parameter. The invalid characters are automatically URL encoded according to the standard specifications.
  
  • The following characters are not encoded:
    ! $ ' ( ) * - / ; ? @ _ ~ . ,
    Single-byte alphanumeric characters (0 to 9, A to Z, and a to z)
    
  • The already URL-encoded tokens are correctly recognized and hence are not URL-encoded again.
  • Spaces are encoded as +.
  • The query parameter of the generated WebResource object is the one for which the query parameter specified in the parameter is added in the query parameter of this object (WebResource object). Note that this is applicable even when a query parameter of the same name exists in this object.
• The entity of this object (WebResource object) is not copied to the WebResource object generated with this method.