stanford.cs106.net

Class SimpleClient

java.lang.Object

stanford.cs106.net.SimpleClient

public class SimpleClient
extends Object

This class implements a basic synchronous HTTP client. It can connect to an HTTP server on a given port (perhaps a SimpleServer?), send it requests, and receive/return their responses.

Field Summary

Fields

Modifier and Type	Field and Description
static String	ERROR_KEY A special error prefix that will appear at the start of error responses.
static String	SESSION_KEY_PARAM_NAME A special request parameter used to indicate that the server should maintain a session with this client.

Constructor Summary

Constructors

Constructor and Description
SimpleClient(String host) Initialiazes a new client to connect to the given HTTP server/host.

Method Summary

Modifier and Type	Method and Description
String	makeRequest(Request request) Initiates a synchronous HTTP request to this client's given server host, waiting for the HTTP response to be sent back, and returns the response.
String	makeRequest(String command, String... params) Initiates a synchronous HTTP request to this client's given server host, waiting for the HTTP response to be sent back, and returns the response.
void	sessionEnd() Ends any current session between this client and the server host.
boolean	sessionIsInProgress() Returns true if a session is currently in progress between this client and the server host.
void	sessionStart() Begins a session between this client and the server host.
String	toString() Returns a string representation of this client.

Methods inherited from class java.lang.Object

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

Field Detail

ERROR_KEY

public static final String ERROR_KEY

A special error prefix that will appear at the start of error responses.

See Also:

Constant Field Values

SESSION_KEY_PARAM_NAME

public static final String SESSION_KEY_PARAM_NAME

A special request parameter used to indicate that the server should maintain a session with this client.

See Also:

Constant Field Values

Constructor Detail

SimpleClient

public SimpleClient(String host)

Initialiazes a new client to connect to the given HTTP server/host.

Parameters:

host - e.g. "http://localhost:8080/"

Method Detail

makeRequest

public String makeRequest(Request request)

Initiates a synchronous HTTP request to this client's given server host, waiting for the HTTP response to be sent back, and returns the response.

makeRequest

public String makeRequest(String command,
                          String... params)

Initiates a synchronous HTTP request to this client's given server host, waiting for the HTTP response to be sent back, and returns the response.

sessionEnd

public void sessionEnd()

Ends any current session between this client and the server host. If no session is in progress, has no effect.

sessionIsInProgress

public boolean sessionIsInProgress()

Returns true if a session is currently in progress between this client and the server host.

sessionStart

public void sessionStart()

Begins a session between this client and the server host. If a session is already in progress, has no effect.

toString

public String toString()

Returns a string representation of this client.

Overrides:

toString in class Object