Request

java.lang.Object
- stanford.cs106.net.Request

```
public class Request
extends Object
```
A Request object encapsulates a basic HTTP request along with its various query parameter key/value pairs.

Constructor Summary

Constructors
Constructor and Description
`Request(String cmd)` Constructs a new Request object with the given command verb.
`Request(String cmd, String... parameters)` Constructs a new Request object with the given command verb and the given set of parameter key/value pairs.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addParam(String key)` Adds a new query parameter with the given name and an empty value.
`void`	`addParam(String key, String value)` Adds a new query parameter with the given name and value.
`void`	`addParams(String... params)` Adds new query parameters with the given name/value pairs, passed as a var-args array in the order K1, V1, K2, V2, etc.
`void`	`addRaw(String key, String value)` Adds a new query parameter with the given name and value.
`static String`	`decode(String str)` URL-decodes the given string.
`static String`	`encode(String str)` URL-encodes the given string.
`static Request`	`fromUrl(String url)` Converts the given string into a Request object, parsing and separating any of its query parameters.
`static Request`	`fromUrl(URL url)` Converts the given URL into a Request object, parsing and separating any of its query parameters.
`String`	`getCommand()` Returns this request's HTTP command verb.
`String`	`getParam(String key)` Returns the value of this request's query parameter with the given name.
`Map<String,String>`	`getParams()` Returns all of this request's query parameters as a map.
`String`	`getRaw(String key)` Returns the value of this request's query parameter with the given name.
`boolean`	`hasParam(String key)` Returns true if this request contains a query parameter with the given name.
`void`	`removeParam(String key)` Removes the query parameter with the given name from this request.
`String`	`toGetRequest()` Converts this request into a URL string that could be used for an HTTP GET request, such as "http://server:port/verb?param1=value1¶m2=value2...¶mN=valueN".
`String`	`toString()` Returns a string representation of this request for debugging.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - Request
```
public Request(String cmd)
```
    Constructs a new Request object with the given command verb.
  - Request
```
public Request(String cmd,
               String... parameters)
```
    Constructs a new Request object with the given command verb and the given set of parameter key/value pairs.
- Method Detail
  - decode
```
public static String decode(String str)
```
    URL-decodes the given string.
  - encode
```
public static String encode(String str)
```
    URL-encodes the given string.
  - fromUrl
```
public static Request fromUrl(String url)
```
    Converts the given string into a Request object, parsing and separating any of its query parameters.
  - fromUrl
```
public static Request fromUrl(URL url)
```
    Converts the given URL into a Request object, parsing and separating any of its query parameters.
  - addParam
```
public void addParam(String key)
```
    Adds a new query parameter with the given name and an empty value.
  - addParam
```
public void addParam(String key,
                     String value)
```
    Adds a new query parameter with the given name and value.
  - addParams
```
public void addParams(String... params)
```
    Adds new query parameters with the given name/value pairs, passed as a var-args array in the order K1, V1, K2, V2, etc.
  - addRaw
```
public void addRaw(String key,
                   String value)
```
    Adds a new query parameter with the given name and value. The value is not URL-encoded before including it.
  - getCommand
```
public String getCommand()
```
    Returns this request's HTTP command verb.
  - getParam
```
public String getParam(String key)
```
    Returns the value of this request's query parameter with the given name. The parameter value is URL-decoded before returning it. If the request contains no such parameter, returns null.
  - getParams
```
public Map<String,String> getParams()
```
    Returns all of this request's query parameters as a map. The map returned is immutable and cannot be directly modified. If the request contains no parameters, returns an empty map.
  - getRaw
```
public String getRaw(String key)
```
    Returns the value of this request's query parameter with the given name. The parameter value is *not* URL-decoded before returning it. If the request contains no such parameter, returns null.
  - hasParam
```
public boolean hasParam(String key)
```
    Returns true if this request contains a query parameter with the given name.
  - removeParam
```
public void removeParam(String key)
```
    Removes the query parameter with the given name from this request. If no such query parameter was present, has no effect.
  - toGetRequest
```
public String toGetRequest()
```
    Converts this request into a URL string that could be used for an HTTP GET request, such as "http://server:port/verb?param1=value1¶m2=value2...¶mN=valueN".
  - toString
```
public String toString()
```
    Returns a string representation of this request for debugging.
    
    Overrides:
    
    toString in class Object

Class Request

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Request

Request

Method Detail

decode

encode

fromUrl

fromUrl

addParam

addParam

addParams

addRaw

getCommand

getParam

getParams

getRaw

hasParam

removeParam

toGetRequest

toString