QueryParam Interface
Implements
public interface QueryParam
implements Annotation
Annotation for query parameters to be appended to a REST API Request URI.
Example 1:
@Get("subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/resources")
Mono<ResponseBase<ResponseHeaders, ResponseBody>> listByResourceGroup(
@PathParam("resourceGroupName") String resourceGroupName,
@PathParam("subscriptionId") String subscriptionId,
@QueryParam("$filter") String filter,
@QueryParam("$expand") String expand,
@QueryParam("$top") Integer top,
@QueryParam("api-version") String apiVersion);
// The value of parameters filter, expand, top, apiVersion will be encoded and will be used to set the query
// parameters {$filter}, {$expand}, {$top}, {api-version} on the HTTP URL.
Example 2: (A use case where PathParam.encoded=true will be used)
// It is possible that a query parameter will need to be encoded:
@Get("http://wq.com/foo/{subpath}/value")
String getValue(@PathParam("subpath") String param,
@QueryParam("query") String query);
// In this case, if consumer pass "a=b" as the value for 'query' then the resolved url looks like:
// "http://wq.com/foo/subpath/value?query=a%3Db"
For such cases the encoded attribute can be used:
@Get("http://wq.com/foo/{subpath}/values")
List<String> getValues(@PathParam("subpath") String param,
@QueryParam(value = "query", encoded = true) String query);
// In this case, if consumer pass "a=b" as the value for 'query' then the resolved url looks like:
// "http://wq.com/foo/paramblah/values?connectionString=a=b"
Example 3:
@Get("http://wq.com/foo/multiple/params")
String multipleParams(@QueryParam(value = "query", multipleQueryParams = true) List<String> query);
// The value of parameter avoid would look like this:
// "http://wq.com/foo/multiple/params?avoid%3Dtest1&avoid%3Dtest2&avoid%3Dtest3"
Method Summary
Modifier and Type | Method and Description |
---|---|
abstract boolean |
encoded()
A value true for this argument indicates that value of value() is already encoded hence engine should not encode it, by default value will be encoded. |
abstract boolean |
multipleQueryParams()
A value true for this argument indicates that value of value() should not be converted to Json in case it is an array but instead sent as multiple values with same parameter name. |
abstract String |
value()
The name of the variable in the endpoint uri template which will be replaced with the value of the parameter annotated with this annotation. |
Method Details
encoded
public abstract boolean encoded()
A value true for this argument indicates that value of value() is already encoded hence engine should not encode it, by default value will be encoded.
Returns:
multipleQueryParams
public abstract boolean multipleQueryParams()
A value true for this argument indicates that value of value() should not be converted to Json in case it is an array but instead sent as multiple values with same parameter name.
Returns:
value
public abstract String value()
The name of the variable in the endpoint uri template which will be replaced with the value of the parameter annotated with this annotation.
Returns:
Applies to
Azure SDK for Java
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for