org.sonar.api.server.ws
Class Request

java.lang.Object
  org.sonar.api.server.ws.Request

Direct Known Subclasses:

SimpleGetRequest, ValidatingRequest

public abstract class Request
extends Object

Since:

4.2

Constructor Summary

Request()

Method Summary

String	mandatoryParam(String key) Returns a non-null value.
boolean	mandatoryParamAsBoolean(String key) Returns a boolean value.
<E extends Enum<E>> E	mandatoryParamAsEnum(String key, Class<E> enumClass)
int	mandatoryParamAsInt(String key) Returns an int value.
long	mandatoryParamAsLong(String key) Returns a long value.
List<String>	mandatoryParamAsStrings(String key)
abstract String	method() Returns the name of the HTTP method with which this request was made.
abstract String	param(String key)
String	param(String key, String defaultValue) Deprecated. to be dropped in 4.4. Default values are declared in ws metadata
Boolean	paramAsBoolean(String key)
boolean	paramAsBoolean(String key, boolean defaultValue) Deprecated. to be dropped in 4.4. Default values must be declared in WebService then this method can be replaced by mandatoryParamAsBoolean(String).
Date	paramAsDate(String key)
Date	paramAsDateTime(String key)
<E extends Enum<E>> E	paramAsEnum(String key, Class<E> enumClass)
<E extends Enum<E>> List<E>	paramAsEnums(String key, Class<E> enumClass)
Integer	paramAsInt(String key)
int	paramAsInt(String key, int defaultValue) Deprecated. to be dropped in 4.4. Default values must be declared in WebService then this method can be replaced by mandatoryParamAsInt(String).
Long	paramAsLong(String key)
long	paramAsLong(String key, long defaultValue) Deprecated. to be dropped in 4.4. Default values must be declared in WebService then this method can be replaced by mandatoryParamAsLong(String).
List<String>	paramAsStrings(String key)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Request

public Request()

Method Detail

method

public abstract String method()

Returns the name of the HTTP method with which this request was made. Possible values are GET and POST. Others are not supported.

mandatoryParam

public String mandatoryParam(String key)

Returns a non-null value. To be used when parameter is required or has a default value.

Throws:

IllegalArgumentException - is value is null or blank

mandatoryParamAsBoolean

public boolean mandatoryParamAsBoolean(String key)

Returns a boolean value. To be used when parameter is required or has a default value.

Throws:

IllegalArgumentException - is value is null or blank

mandatoryParamAsInt

public int mandatoryParamAsInt(String key)

Returns an int value. To be used when parameter is required or has a default value.

Throws:

IllegalArgumentException - is value is null or blank

mandatoryParamAsLong

public long mandatoryParamAsLong(String key)

Returns a long value. To be used when parameter is required or has a default value.

Throws:

IllegalArgumentException - is value is null or blank

mandatoryParamAsEnum

public <E extends Enum<E>> E mandatoryParamAsEnum(String key,
                                                  Class<E> enumClass)

mandatoryParamAsStrings

public List<String> mandatoryParamAsStrings(String key)

paramAsStrings

@CheckForNull
public List<String> paramAsStrings(String key)

param

@CheckForNull
public abstract String param(String key)

param

@CheckForNull
@Deprecated
public String param(String key,
                                            @CheckForNull
                                            String defaultValue)

Deprecated. to be dropped in 4.4. Default values are declared in ws metadata

paramAsBoolean

@Deprecated
public boolean paramAsBoolean(String key,
                                         boolean defaultValue)

Deprecated. to be dropped in 4.4. Default values must be declared in WebService then this method can be replaced by mandatoryParamAsBoolean(String).

paramAsInt

@Deprecated
public int paramAsInt(String key,
                                 int defaultValue)

Deprecated. to be dropped in 4.4. Default values must be declared in WebService then this method can be replaced by mandatoryParamAsInt(String).

paramAsLong

@Deprecated
public long paramAsLong(String key,
                                   long defaultValue)

Deprecated. to be dropped in 4.4. Default values must be declared in WebService then this method can be replaced by mandatoryParamAsLong(String).

paramAsBoolean

@CheckForNull
public Boolean paramAsBoolean(String key)

paramAsInt

@CheckForNull
public Integer paramAsInt(String key)

paramAsLong

@CheckForNull
public Long paramAsLong(String key)

paramAsEnum

@CheckForNull
public <E extends Enum<E>> E paramAsEnum(String key,
                                                      Class<E> enumClass)

paramAsEnums

@CheckForNull
public <E extends Enum<E>> List<E> paramAsEnums(String key,
                                                             Class<E> enumClass)

paramAsDateTime

@CheckForNull
public Date paramAsDateTime(String key)

paramAsDate

@CheckForNull
public Date paramAsDate(String key)