retrofit2.http

Annotation Type QueryMap

@Documented
 @Target(value=PARAMETER)
 @Retention(value=RUNTIME)
public @interface QueryMap

Query parameter keys and values appended to the URL.

Both keys and values are converted to strings using String.valueOf(Object).

Simple Example:

 @GET("/search")
 Call<ResponseBody> list(@QueryMap Map<String, String> filters);
 

Calling with foo.list(ImmutableMap.of("foo", "bar", "kit", "kat")) yields /search?foo=bar&kit=kat.

Map keys and values representing parameter values are URL encoded by default. Specify encoded=true to change this behavior.

 @GET("/search")
 Call<ResponseBody> list(@QueryMap(encoded=true) Map<String, String> filters);
 

Calling with foo.list(ImmutableMap.of("foo", "foo+bar")) yields /search?foo=foo+bar.

A null value for the map, as a key, or as a value is not allowed.

See Also:

Query

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
boolean	encoded Specifies whether parameter names and values are already URL encoded.

Element Detail

encoded

public abstract boolean encoded

Specifies whether parameter names and values are already URL encoded.

Default:

false