HTTPConnection (grinder-parent 3.11 API)

java.lang.Object
- HTTPClient.HTTPConnection

All Implemented Interfaces:

HTTPClientModuleConstants
```
public class HTTPConnection
extends Object
implements HTTPClientModuleConstants
```
This class implements http protocol requests; it contains most of HTTP/1.1 and ought to be unconditionally compliant. Redirections are automatically handled, and authorizations requests are recognized and dealt with via an authorization handler. Only full HTTP/1.0 and HTTP/1.1 requests are generated. HTTP/1.1, HTTP/1.0 and HTTP/0.9 responses are recognized.
Using the HTTPClient should be quite simple. First add the import statement 'import HTTPClient.*;' to your file(s). Request can then be sent using one of the methods Head(), Get(), Post(), etc in HTTPConnection. These methods all return an instance of HTTPResponse which has methods for accessing the response headers (getHeader(), getHeaderAsInt(), etc), various response info (getStatusCode(), getReasonLine(), etc) and the reponse data (getData(), getText(), and getInputStream()). Following are some examples.
If this is in an applet you can retrieve files from your server as follows:
```
     try
     {
         HTTPConnection con = new HTTPConnection(this);
         HTTPResponse   rsp = con.Get("/my_file");
         if (rsp.getStatusCode() >= 300)
         {
             System.err.println("Received Error: "+rsp.getReasonLine());
             System.err.println(rsp.getText());
         }
         else
             data = rsp.getData();

         rsp = con.Get("/another_file");
         if (rsp.getStatusCode() >= 300)
         {
             System.err.println("Received Error: "+rsp.getReasonLine());
             System.err.println(rsp.getText());
         }
         else
             other_data = rsp.getData();
     }
     catch (IOException ioe)
     {
         System.err.println(ioe.toString());
     }
     catch (ModuleException me)
     {
         System.err.println("Error handling request: " + me.getMessage());
     }
 
```
This will get the files "/my_file" and "/another_file" and put their contents into byte[]'s accessible via getData(). Note that you need to only create a new HTTPConnection when sending a request to a new server (different host or port); although you may create a new HTTPConnection for every request to the same server this not recommended, as various information about the server is cached after the first request (to optimize subsequent requests) and persistent connections are used whenever possible.
To POST form data you would use something like this (assuming you have two fields called name and e-mail, whose contents are stored in the variables name and email):
```
     try
     {
         NVPair form_data[] = new NVPair[2];
         form_data[0] = new NVPair("name", name);
         form_data[1] = new NVPair("e-mail", email);

         HTTPConnection con = new HTTPConnection(this);
         HTTPResponse   rsp = con.Post("/cgi-bin/my_script", form_data);
         if (rsp.getStatusCode() >= 300)
         {
             System.err.println("Received Error: "+rsp.getReasonLine());
             System.err.println(rsp.getText());
         }
         else
             stream = rsp.getInputStream();
     }
     catch (IOException ioe)
     {
         System.err.println(ioe.toString());
     }
     catch (ModuleException me)
     {
         System.err.println("Error handling request: " + me.getMessage());
     }
 
```
Here the response data is read at leasure via an InputStream instead of all at once into a byte[].
As another example, if you have a URL you're trying to send a request to you would do something like the following:
```
     try
     {
         URL url = new URL("http://www.mydomain.us/test/my_file");
         HTTPConnection con = new HTTPConnection(url);
         HTTPResponse   rsp = con.Put(url.getFile(), "Hello World");
         if (rsp.getStatusCode() >= 300)
         {
             System.err.println("Received Error: "+rsp.getReasonLine());
             System.err.println(rsp.getText());
         }
         else
             text = rsp.getText();
     }
     catch (IOException ioe)
     {
         System.err.println(ioe.toString());
     }
     catch (ModuleException me)
     {
         System.err.println("Error handling request: " + me.getMessage());
     }
 
```
There are a whole number of methods for each request type; however the general forms are ([...] means that the enclosed is optional):
- Head ( file [, form-data [, headers ] ] )
- Head ( file [, query [, headers ] ] )
- Get ( file [, form-data [, headers ] ] )
- Get ( file [, query [, headers ] ] )
- Post ( file [, form-data [, headers ] ] )
- Post ( file [, data [, headers ] ] )
- Post ( file [, stream [, headers ] ] )
- Put ( file , data [, headers ] )
- Put ( file , stream [, headers ] )
- Delete ( file [, headers ] )
- Options ( file [, headers [, data] ] )
- Options ( file [, headers [, stream] ] )
- Trace ( file [, headers ] )
Version:

0.3-3E 06/05/2001

Author:

Ronald Tschalär

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static interface`	`HTTPConnection.BandwidthLimiter` Something that can restrict data transfer bandwidth.
`static interface`	`HTTPConnection.BandwidthLimiterFactory`
`static interface`	`HTTPConnection.TimeAuthority`

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`CD_0`
`static int`	`CD_CHUNKED`
`static int`	`CD_CLOSE`
`static int`	`CD_CONTLEN`
`static int`	`CD_HDRS`
`static int`	`CD_MP_BR`
`static int`	`CD_NONE` Content delimiters
`static int`	`HTTP` possible http protocols we (might) handle
`static int`	`HTTP_1_0` some known http versions
`static int`	`HTTP_1_1`
`static int`	`HTTP_NG`
`static int`	`HTTPS`
`static int`	`SHTTP`
`static String`	`version` The current version of this package.

Fields inherited from interface HTTPClient.HTTPClientModuleConstants
REQ_CONTINUE, REQ_NEWCON_RST, REQ_NEWCON_SND, REQ_RESPONSE, REQ_RESTART, REQ_RETURN, REQ_SHORTCIRC, RSP_CONTINUE, RSP_NEWCON_REQ, RSP_NEWCON_SND, RSP_REQUEST, RSP_RESTART, RSP_SEND, RSP_SHORTCIRC

Constructor Summary

Constructors
Constructor and Description
`HTTPConnection(Applet applet)` Constructs a connection to the host from where the applet was loaded.
`HTTPConnection(String host)` Constructs a connection to the specified host on port 80
`HTTPConnection(String host, int port)` Constructs a connection to the specified host on the specified port
`HTTPConnection(String prot, String host, int port)` Constructs a connection to the specified host on the specified port, using the specified protocol (currently only "http" is supported).
`HTTPConnection(String prot, String host, int port, InetAddress localAddr, int localPort)` Constructs a connection to the specified host on the specified port, using the specified protocol (currently only "http" is supported), local address, and local port.
`HTTPConnection(URI uri)` Constructs a connection to the host (port) as given in the uri.
`HTTPConnection(URL url)` Constructs a connection to the host (port) as given in the url.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`addBasicAuthorization(String realm, String user, String passwd)` Adds an authorization entry for the "basic" authorization scheme to the list.
`static boolean`	`addDefaultModule(Class module, int pos)` Adds a module to the default list.
`void`	`addDigestAuthorization(String realm, String user, String passwd)` Adds an authorization entry for the "digest" authorization scheme to the list.
`boolean`	`addModule(Class module, int pos)` Adds a module to the current list.
`HTTPResponse`	`Delete(String file)` Requests that `file` be DELETEd from the server.
`HTTPResponse`	`Delete(String file, NVPair[] headers)` Requests that `file` be DELETEd from the server.
`static void`	`dontProxyFor(String host)` Add `host` to the list of hosts which should be accessed directly, not via any proxy set by `setProxyServer()`.
`static void`	`dontProxyFor(String[] hosts)` Convenience method to add a number of hosts at once.
`static boolean`	`doProxyFor(String host)` Remove `host` from the list of hosts for which the proxy should not be used.
`HTTPResponse`	`ExtensionMethod(String method, String file, byte[] data, NVPair[] headers)` This is here to allow an arbitrary, non-standard request to be sent.
`HTTPResponse`	`ExtensionMethod(String method, String file, HttpOutputStream os, NVPair[] headers)` This is here to allow an arbitrary, non-standard request to be sent.
`HTTPResponse`	`Get(String file)` GETs the file.
`HTTPResponse`	`Get(String file, NVPair[] form_data)` GETs the file with a query consisting of the specified form-data.
`HTTPResponse`	`Get(String file, NVPair[] form_data, NVPair[] headers)` GETs the file with a query consisting of the specified form-data.
`HTTPResponse`	`Get(String file, String query)` GETs the file using the specified query string.
`HTTPResponse`	`Get(String file, String query, NVPair[] headers)` GETs the file using the specified query string.
`boolean`	`getAllowUserInteraction()` returns whether modules are allowed to prompt or popup dialogs if neccessary.
`boolean`	`getCheckCertificates()`
`long`	`getConnectionsEstablished()`
`long`	`getConnectTime()`
`Object`	`getContext()` Returns the current context.
`static boolean`	`getDefaultAllowUserInteraction()` Gets the default allow-user-action.
`static Object`	`getDefaultContext()` Returns the default context.
`NVPair[]`	`getDefaultHeaders()` Gets the current list of default http headers.
`static Class[]`	`getDefaultModules()` Returns the default list of modules.
`static SSLSocketFactory`	`getDefaultSSLSocketFactory()` Set the current SSL socket factory for this connection.
`static int`	`getDefaultTimeout()` Gets the default timeout value to be used for each new HTTPConnection.
`long`	`getDnsTime()` ++GRINDER-MODIFICATION++
`String`	`getHost()` Returns the host this connection is talking to.
`Class[]`	`getModules()` Returns the list of modules used currently.
`int`	`getPort()` Returns the port this connection connects to.
`String`	`getProtocol()` Returns the protocol this connection is talking.
`String`	`getProxyHost()` Returns the host of the proxy this connection is using.
`int`	`getProxyPort()` Returns the port of the proxy this connection is using.
`static String[]`	`getSSLCipherSuites()` The list of cipher suites that will used for SSL sockets.
`static String[]`	`getSSLProtocols()` The list of protocols that will used for SSL sockets.
`SSLSocketFactory`	`getSSLSocketFactory()` Set the current SSL socket factory for this connection.
`boolean`	`getTestConnectionHealthWithBlockingRead()`
`HTTPConnection.TimeAuthority`	`getTimeAuthority()`
`int`	`getTimeout()` Gets the timeout used for reading response data.
`HTTPResponse`	`Head(String file)` Sends the HEAD request.
`HTTPResponse`	`Head(String file, NVPair[] form_data)` Sends the HEAD request.
`HTTPResponse`	`Head(String file, NVPair[] form_data, NVPair[] headers)` Sends the HEAD request.
`HTTPResponse`	`Head(String file, String query)` Sends the HEAD request.
`HTTPResponse`	`Head(String file, String query, NVPair[] headers)` Sends the HEAD request.
`boolean`	`isCompatibleWith(URI uri)` See if the given uri is compatible with this connection.
`HTTPResponse`	`Options(String file)` Request OPTIONS from the server.
`HTTPResponse`	`Options(String file, NVPair[] headers)` Request OPTIONS from the server.
`HTTPResponse`	`Options(String file, NVPair[] headers, byte[] data)` Request OPTIONS from the server.
`HTTPResponse`	`Options(String file, NVPair[] headers, HttpOutputStream stream)` Request OPTIONS from the server.
`HTTPResponse`	`Post(String file)` POSTs to the specified file.
`HTTPResponse`	`Post(String file, byte[] data)` POSTs the raw data to the specified file.
`HTTPResponse`	`Post(String file, byte[] data, NVPair[] headers)` POSTs the raw data to the specified file using the specified headers.
`HTTPResponse`	`Post(String file, HttpOutputStream stream)` POSTs the data written to the output stream to the specified file.
`HTTPResponse`	`Post(String file, HttpOutputStream stream, NVPair[] headers)` POSTs the data written to the output stream to the specified file using the specified headers.
`HTTPResponse`	`Post(String file, NVPair[] form_data)` POSTs form-data to the specified file.
`HTTPResponse`	`Post(String file, NVPair[] form_data, NVPair[] headers)` POST's form-data to the specified file using the specified headers.
`HTTPResponse`	`Post(String file, String data)` POSTs the data to the specified file.
`HTTPResponse`	`Post(String file, String data, NVPair[] headers)` POSTs the data to the specified file using the specified headers.
`HTTPResponse`	`Put(String file, byte[] data)` PUTs the raw data into the specified file.
`HTTPResponse`	`Put(String file, byte[] data, NVPair[] headers)` PUTs the raw data into the specified file using the additional headers.
`HTTPResponse`	`Put(String file, HttpOutputStream stream)` PUTs the data written to the output stream into the specified file.
`HTTPResponse`	`Put(String file, HttpOutputStream stream, NVPair[] headers)` PUTs the data written to the output stream into the specified file using the additional headers.
`HTTPResponse`	`Put(String file, String data)` PUTs the data into the specified file.
`HTTPResponse`	`Put(String file, String data, NVPair[] headers)` PUTs the data into the specified file using the additional headers for the request.
`static boolean`	`removeDefaultModule(Class module)` Removes a module from the default list.
`boolean`	`removeModule(Class module)` Removes a module from the current list.
`void`	`setAllowUserInteraction(boolean allow)` Controls whether modules are allowed to prompt the user or pop up dialogs if neccessary.
`void`	`setBufferGrowthStrategyFactory(HTTPConnection.BandwidthLimiterFactory f)`
`void`	`setCheckCertificates(boolean b)`
`void`	`setContext(Object context)` Sets the current context.
`void`	`setCurrentProxy(String host, int port)` Sets the proxy used by this instance.
`static void`	`setDefaultAllowUserInteraction(boolean allow)` Sets the default allow-user-action.
`void`	`setDefaultHeaders(NVPair[] headers)` Sets the default http headers to be sent with each request.
`static void`	`setDefaultSSLSocketFactory(SSLSocketFactory sslFactory)` Set the SSL socket factory for this connection.
`static void`	`setDefaultTimeout(int time)` Sets the default timeout value to be used for each new HTTPConnection.
`void`	`setLocalAddress(InetAddress localAddress, int localPort)` Allow local address and port to be modified after HTTPConnection has been created.
`static void`	`setProxyServer(String host, int port)` Sets the default proxy server to use.
`void`	`setRawMode(boolean raw)` Deprecated. This is not really needed anymore; in V0.2 request were synchronous and therefore to do pipelining you needed to disable the processing of responses.
`static void`	`setSocksServer(String host)` Sets the SOCKS server to use.
`static void`	`setSocksServer(String host, int port)` Sets the SOCKS server to use.
`static void`	`setSocksServer(String host, int port, int version)` Sets the SOCKS server to use.
`void`	`setSSLSocketFactory(SSLSocketFactory sslFactory)` Set the SSL socket factory for this connection.
`void`	`setTestConnectionHealthWithBlockingRead(boolean b)`
`void`	`setTimeAuthority(HTTPConnection.TimeAuthority timeAuthority)`
`void`	`setTimeout(int time)` Sets the timeout to be used for creating connections and reading responses.
`protected HTTPResponse`	`setupRequest(String method, String resource, NVPair[] headers, byte[] entity, HttpOutputStream stream)` Sets up the request, creating the list of headers to send and creating instances of the modules.
`void`	`stop()` Aborts all the requests currently in progress on this connection and closes all associated sockets.
`String`	`toString()` Generates a string of the form protocol://host.domain:port .
`HTTPResponse`	`Trace(String file)` Requests a TRACE.
`HTTPResponse`	`Trace(String file, NVPair[] headers)` Requests a TRACE.

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

- Field Detail
  - version
```
public static final String version
```
    The current version of this package.
    
    See Also:
    Constant Field Values
  - HTTP
```
public static final int HTTP
```
    possible http protocols we (might) handle
    
    See Also:
    Constant Field Values
  - HTTPS
```
public static final int HTTPS
```
    See Also:
    Constant Field Values
  - SHTTP
```
public static final int SHTTP
```
    See Also:
    Constant Field Values
  - HTTP_NG
```
public static final int HTTP_NG
```
    See Also:
    Constant Field Values
  - HTTP_1_0
```
public static final int HTTP_1_0
```
    some known http versions
    
    See Also:
    Constant Field Values
  - HTTP_1_1
```
public static final int HTTP_1_1
```
    See Also:
    Constant Field Values
  - CD_NONE
```
public static final int CD_NONE
```
    Content delimiters
    
    See Also:
    Constant Field Values
  - CD_HDRS
```
public static final int CD_HDRS
```
    See Also:
    Constant Field Values
  - CD_0
```
public static final int CD_0
```
    See Also:
    Constant Field Values
  - CD_CLOSE
```
public static final int CD_CLOSE
```
    See Also:
    Constant Field Values
  - CD_CONTLEN
```
public static final int CD_CONTLEN
```
    See Also:
    Constant Field Values
  - CD_CHUNKED
```
public static final int CD_CHUNKED
```
    See Also:
    Constant Field Values
  - CD_MP_BR
```
public static final int CD_MP_BR
```
    See Also:
    Constant Field Values
- Constructor Detail
  - HTTPConnection
```
public HTTPConnection(Applet applet)
               throws ProtocolNotSuppException
```
    Constructs a connection to the host from where the applet was loaded. Note that current security policies only let applets connect home.
    
    Parameters:
    applet - the current applet
    
    Throws:
    
    ProtocolNotSuppException
  - HTTPConnection
```
public HTTPConnection(String host)
```
    Constructs a connection to the specified host on port 80
    
    Parameters:
    host - the host
  - HTTPConnection
```
public HTTPConnection(String host,
              int port)
```
    Constructs a connection to the specified host on the specified port
    
    Parameters:
    host - the host
    port - the port
  - HTTPConnection
```
public HTTPConnection(String prot,
              String host,
              int port)
               throws ProtocolNotSuppException
```
    Constructs a connection to the specified host on the specified port, using the specified protocol (currently only "http" is supported).
    
    Parameters:
    prot - the protocol
    host - the host
    port - the port, or -1 for the default port
    
    Throws:
    
    ProtocolNotSuppException - if the protocol is not HTTP
  - HTTPConnection
```
public HTTPConnection(String prot,
              String host,
              int port,
              InetAddress localAddr,
              int localPort)
               throws ProtocolNotSuppException
```
    Constructs a connection to the specified host on the specified port, using the specified protocol (currently only "http" is supported), local address, and local port.
    
    Parameters:
    prot - the protocol
    host - the host
    port - the port, or -1 for the default port
    localAddr - the local address to bind to
    lcoalPort - the local port to bind to
    
    Throws:
    
    ProtocolNotSuppException - if the protocol is not HTTP
  - HTTPConnection
```
public HTTPConnection(URL url)
               throws ProtocolNotSuppException
```
    Constructs a connection to the host (port) as given in the url.
    
    Parameters:
    url - the url
    
    Throws:
    
    ProtocolNotSuppException - if the protocol is not HTTP
  - HTTPConnection
```
public HTTPConnection(URI uri)
               throws ProtocolNotSuppException
```
    Constructs a connection to the host (port) as given in the uri.
    
    Parameters:
    uri - the uri
    
    Throws:
    
    ProtocolNotSuppException - if the protocol is not HTTP
- Method Detail
  - setTimeAuthority
```
public void setTimeAuthority(HTTPConnection.TimeAuthority timeAuthority)
```
  - getTimeAuthority
```
public HTTPConnection.TimeAuthority getTimeAuthority()
```
  - getSSLCipherSuites
```
public static String[] getSSLCipherSuites()
```
    The list of cipher suites that will used for SSL sockets.
    By default, this is the list of all cipher suites supported by the JVM. It can be overridden with the system property https.cipherSuites.
    
    Returns:
    The list of cipher suites.
  - getSSLProtocols
```
public static String[] getSSLProtocols()
```
    The list of protocols that will used for SSL sockets.
    By default, this is the list of all protocols supported by the JVM. It can be overridden with the system property https.protocols.
    
    Returns:
    The list of protocols.
  - Head
```
public HTTPResponse Head(String file)
                  throws IOException,
                         ModuleException
```
    Sends the HEAD request. This request is just like the corresponding GET except that it only returns the headers and no data.
    
    Parameters:
    file - the absolute path of the file
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
    See Also:
    Get(java.lang.String)
  - Head
```
public HTTPResponse Head(String file,
                NVPair[] form_data)
                  throws IOException,
                         ModuleException
```
    Sends the HEAD request. This request is just like the corresponding GET except that it only returns the headers and no data.
    
    Parameters:
    file - the absolute path of the file
    form_data - an array of Name/Value pairs
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
    See Also:
    Get(java.lang.String, HTTPClient.NVPair[])
  - Head
```
public HTTPResponse Head(String file,
                NVPair[] form_data,
                NVPair[] headers)
                  throws IOException,
                         ModuleException
```
    Sends the HEAD request. This request is just like the corresponding GET except that it only returns the headers and no data.
    
    Parameters:
    file - the absolute path of the file
    form_data - an array of Name/Value pairs
    headers - additional headers
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
    See Also:
    Get(java.lang.String, HTTPClient.NVPair[], HTTPClient.NVPair[])
  - Head
```
public HTTPResponse Head(String file,
                String query)
                  throws IOException,
                         ModuleException
```
    Sends the HEAD request. This request is just like the corresponding GET except that it only returns the headers and no data.
    
    Parameters:
    file - the absolute path of the file
    query - the query string; it will be urlencoded
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
    See Also:
    Get(java.lang.String, java.lang.String)
  - Head
```
public HTTPResponse Head(String file,
                String query,
                NVPair[] headers)
                  throws IOException,
                         ModuleException
```
    Sends the HEAD request. This request is just like the corresponding GET except that it only returns the headers and no data.
    
    Parameters:
    file - the absolute path of the file
    query - the query string; it will be urlencoded
    headers - additional headers
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
    See Also:
    Get(java.lang.String, java.lang.String, HTTPClient.NVPair[])
  - Get
```
public HTTPResponse Get(String file)
                 throws IOException,
                        ModuleException
```
    GETs the file.
    
    Parameters:
    file - the absolute path of the file
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Get
```
public HTTPResponse Get(String file,
               NVPair[] form_data)
                 throws IOException,
                        ModuleException
```
    GETs the file with a query consisting of the specified form-data. The data is urlencoded, turned into a string of the form "name1=value1&name2=value2" and then sent as a query string.
    
    Parameters:
    file - the absolute path of the file
    form_data - an array of Name/Value pairs
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Get
```
public HTTPResponse Get(String file,
               NVPair[] form_data,
               NVPair[] headers)
                 throws IOException,
                        ModuleException
```
    GETs the file with a query consisting of the specified form-data. The data is urlencoded, turned into a string of the form "name1=value1&name2=value2" and then sent as a query string.
    
    Parameters:
    file - the absolute path of the file
    form_data - an array of Name/Value pairs
    headers - additional headers
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Get
```
public HTTPResponse Get(String file,
               String query)
                 throws IOException,
                        ModuleException
```
    GETs the file using the specified query string. The query string is first urlencoded.
    
    Parameters:
    file - the absolute path of the file
    query - the query
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Get
```
public HTTPResponse Get(String file,
               String query,
               NVPair[] headers)
                 throws IOException,
                        ModuleException
```
    GETs the file using the specified query string. The query string is first urlencoded.
    
    Parameters:
    file - the absolute path of the file
    query - the query string
    headers - additional headers
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Post
```
public HTTPResponse Post(String file)
                  throws IOException,
                         ModuleException
```
    POSTs to the specified file. No data is sent.
    
    Parameters:
    file - the absolute path of the file
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Post
```
public HTTPResponse Post(String file,
                NVPair[] form_data)
                  throws IOException,
                         ModuleException
```
    POSTs form-data to the specified file. The data is first urlencoded and then turned into a string of the form "name1=value1&name2=value2". A Content-type header with the value application/x-www-form-urlencoded is added.
    
    Parameters:
    file - the absolute path of the file
    form_data - an array of Name/Value pairs
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Post
```
public HTTPResponse Post(String file,
                NVPair[] form_data,
                NVPair[] headers)
                  throws IOException,
                         ModuleException
```
    POST's form-data to the specified file using the specified headers. The data is first urlencoded and then turned into a string of the form "name1=value1&name2=value2". If no Content-type header is given then one is added with a value of application/x-www-form-urlencoded.
    
    Parameters:
    file - the absolute path of the file
    form_data - an array of Name/Value pairs
    headers - additional headers
    
    Returns:
    a HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Post
```
public HTTPResponse Post(String file,
                String data)
                  throws IOException,
                         ModuleException
```
    POSTs the data to the specified file. The data is converted to an array of bytes using the default character converter. The request is sent using the content-type "application/octet-stream".
    
    Parameters:
    file - the absolute path of the file
    data - the data
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
    See Also:
    String.getBytes()
  - Post
```
public HTTPResponse Post(String file,
                String data,
                NVPair[] headers)
                  throws IOException,
                         ModuleException
```
    POSTs the data to the specified file using the specified headers.
    
    Parameters:
    file - the absolute path of the file
    data - the data
    headers - additional headers
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
    See Also:
    String.getBytes()
  - Post
```
public HTTPResponse Post(String file,
                byte[] data)
                  throws IOException,
                         ModuleException
```
    POSTs the raw data to the specified file. The request is sent using the content-type "application/octet-stream"
    
    Parameters:
    file - the absolute path of the file
    data - the data
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Post
```
public HTTPResponse Post(String file,
                byte[] data,
                NVPair[] headers)
                  throws IOException,
                         ModuleException
```
    POSTs the raw data to the specified file using the specified headers.
    
    Parameters:
    file - the absolute path of the file
    data - the data
    headers - additional headers
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Post
```
public HTTPResponse Post(String file,
                HttpOutputStream stream)
                  throws IOException,
                         ModuleException
```
    POSTs the data written to the output stream to the specified file. The request is sent using the content-type "application/octet-stream"
    
    Parameters:
    file - the absolute path of the file
    stream - the output stream on which the data is written
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Post
```
public HTTPResponse Post(String file,
                HttpOutputStream stream,
                NVPair[] headers)
                  throws IOException,
                         ModuleException
```
    POSTs the data written to the output stream to the specified file using the specified headers.
    
    Parameters:
    file - the absolute path of the file
    stream - the output stream on which the data is written
    headers - additional headers
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Put
```
public HTTPResponse Put(String file,
               String data)
                 throws IOException,
                        ModuleException
```
    PUTs the data into the specified file. The data is converted to an array of bytes using the default character converter. The request ist sent using the content-type "application/octet-stream".
    
    Parameters:
    file - the absolute path of the file
    data - the data
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
    See Also:
    String.getBytes()
  - Put
```
public HTTPResponse Put(String file,
               String data,
               NVPair[] headers)
                 throws IOException,
                        ModuleException
```
    PUTs the data into the specified file using the additional headers for the request.
    
    Parameters:
    file - the absolute path of the file
    data - the data
    headers - additional headers
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
    See Also:
    String.getBytes()
  - Put
```
public HTTPResponse Put(String file,
               byte[] data)
                 throws IOException,
                        ModuleException
```
    PUTs the raw data into the specified file. The request is sent using the content-type "application/octet-stream".
    
    Parameters:
    file - the absolute path of the file
    data - the data
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Put
```
public HTTPResponse Put(String file,
               byte[] data,
               NVPair[] headers)
                 throws IOException,
                        ModuleException
```
    PUTs the raw data into the specified file using the additional headers.
    
    Parameters:
    file - the absolute path of the file
    data - the data
    headers - any additional headers
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Put
```
public HTTPResponse Put(String file,
               HttpOutputStream stream)
                 throws IOException,
                        ModuleException
```
    PUTs the data written to the output stream into the specified file. The request is sent using the content-type "application/octet-stream".
    
    Parameters:
    file - the absolute path of the file
    stream - the output stream on which the data is written
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Put
```
public HTTPResponse Put(String file,
               HttpOutputStream stream,
               NVPair[] headers)
                 throws IOException,
                        ModuleException
```
    PUTs the data written to the output stream into the specified file using the additional headers.
    
    Parameters:
    file - the absolute path of the file
    stream - the output stream on which the data is written
    headers - any additional headers
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Options
```
public HTTPResponse Options(String file)
                     throws IOException,
                            ModuleException
```
    Request OPTIONS from the server. If file is "*" then the request applies to the server as a whole; otherwise it applies only to that resource.
    
    Parameters:
    file - the absolute path of the resource, or "*"
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Options
```
public HTTPResponse Options(String file,
                   NVPair[] headers)
                     throws IOException,
                            ModuleException
```
    Request OPTIONS from the server. If file is "*" then the request applies to the server as a whole; otherwise it applies only to that resource.
    
    Parameters:
    file - the absolute path of the resource, or "*"
    headers - the headers containing optional info.
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Options
```
public HTTPResponse Options(String file,
                   NVPair[] headers,
                   byte[] data)
                     throws IOException,
                            ModuleException
```
    Request OPTIONS from the server. If file is "*" then the request applies to the server as a whole; otherwise it applies only to that resource.
    
    Parameters:
    file - the absolute path of the resource, or "*"
    headers - the headers containing optional info.
    data - any data to be sent in the optional body
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Options
```
public HTTPResponse Options(String file,
                   NVPair[] headers,
                   HttpOutputStream stream)
                     throws IOException,
                            ModuleException
```
    Request OPTIONS from the server. If file is "*" then the request applies to the server as a whole; otherwise it applies only to that resource.
    
    Parameters:
    file - the absolute path of the resource, or "*"
    headers - the headers containing optional info.
    stream - an output stream for sending the optional body
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Delete
```
public HTTPResponse Delete(String file)
                    throws IOException,
                           ModuleException
```
    Requests that file be DELETEd from the server.
    
    Parameters:
    file - the absolute path of the resource
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Delete
```
public HTTPResponse Delete(String file,
                  NVPair[] headers)
                    throws IOException,
                           ModuleException
```
    Requests that file be DELETEd from the server.
    
    Parameters:
    file - the absolute path of the resource
    headers - additional headers
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Trace
```
public HTTPResponse Trace(String file,
                 NVPair[] headers)
                   throws IOException,
                          ModuleException
```
    Requests a TRACE. Headers of particular interest here are "Via" and "Max-Forwards".
    
    Parameters:
    file - the absolute path of the resource
    headers - additional headers
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - Trace
```
public HTTPResponse Trace(String file)
                   throws IOException,
                          ModuleException
```
    Requests a TRACE.
    
    Parameters:
    file - the absolute path of the resource
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - ExtensionMethod
```
public HTTPResponse ExtensionMethod(String method,
                           String file,
                           byte[] data,
                           NVPair[] headers)
                             throws IOException,
                                    ModuleException
```
    This is here to allow an arbitrary, non-standard request to be sent. I'm assuming you know what you are doing...
    
    Parameters:
    method - the extension method
    file - the absolute path of the resource, or null
    data - optional data, or null
    headers - optional headers, or null
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - ExtensionMethod
```
public HTTPResponse ExtensionMethod(String method,
                           String file,
                           HttpOutputStream os,
                           NVPair[] headers)
                             throws IOException,
                                    ModuleException
```
    This is here to allow an arbitrary, non-standard request to be sent. I'm assuming you know what you are doing...
    
    Parameters:
    method - the extension method
    file - the absolute path of the resource, or null
    stream - optional output stream, or null
    headers - optional headers, or null
    
    Returns:
    an HTTPResponse structure containing the response
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - stop
```
public void stop()
```
    Aborts all the requests currently in progress on this connection and closes all associated sockets. You usually do not need to invoke this - it only meant for when you need to abruptly stop things, such as for example the stop button in a browser.
    Note: there is a small window where a request method such as Get() may have been invoked but the request has not been built and added to the list. Any request in this window will not be aborted.
    
    Since:
    
    V0.2-3
  - setDefaultSSLSocketFactory
```
public static void setDefaultSSLSocketFactory(SSLSocketFactory sslFactory)
```
    Set the SSL socket factory for this connection. If not set, uses the default factory.
    
    Parameters:
    sslFactory - the SSL socket factory
  - getDefaultSSLSocketFactory
```
public static SSLSocketFactory getDefaultSSLSocketFactory()
```
    Set the current SSL socket factory for this connection.
    
    Returns:
    the current SSL socket factory
  - setSSLSocketFactory
```
public void setSSLSocketFactory(SSLSocketFactory sslFactory)
```
    Set the SSL socket factory for this connection. If not set, uses the default factory.
    
    Parameters:
    sslFactory - the SSL socket factory
  - getSSLSocketFactory
```
public SSLSocketFactory getSSLSocketFactory()
```
    Set the current SSL socket factory for this connection.
    
    Returns:
    the current SSL socket factory
  - setDefaultHeaders
```
public void setDefaultHeaders(NVPair[] headers)
```
    Sets the default http headers to be sent with each request. The actual headers sent are determined as follows: for each header specified in multiple places a value given as part of the request takes priority over any default values set by this method, which in turn takes priority over any built-in default values. A different way of looking at it is that we start off with a list of all headers specified with the request, then add any default headers set by this method which aren't already in our list, and finally add any built-in headers which aren't yet in the list. There is one exception to this rule: the "Content-length" header is always ignored; and when posting form-data any default "Content-type" is ignored in favor of the built-in "application/x-www-form-urlencoded" (however it will be overriden by any content-type header specified as part of the request).
    Typical headers you might want to set here are "Accept" and its "Accept-*" relatives, "Connection", "From", "User-Agent", etc.
    
    Parameters:
    headers - an array of header-name/value pairs (do not give the separating ':').
  - getDefaultHeaders
```
public NVPair[] getDefaultHeaders()
```
    Gets the current list of default http headers.
    
    Returns:
    an array of header/value pairs.
  - getProtocol
```
public String getProtocol()
```
    Returns the protocol this connection is talking.
    
    Returns:
    a string containing the (lowercased) protocol
  - getHost
```
public String getHost()
```
    Returns the host this connection is talking to.
    
    Returns:
    a string containing the (lowercased) host name.
  - getPort
```
public int getPort()
```
    Returns the port this connection connects to. This is always the actual port number, never -1.
    
    Returns:
    the port number
  - getProxyHost
```
public String getProxyHost()
```
    Returns the host of the proxy this connection is using.
    
    Returns:
    a string containing the (lowercased) host name.
  - getProxyPort
```
public int getProxyPort()
```
    Returns the port of the proxy this connection is using.
    
    Returns:
    the port number
  - isCompatibleWith
```
public boolean isCompatibleWith(URI uri)
```
    See if the given uri is compatible with this connection. Compatible means that the given uri can be retrieved using this connection object.
    
    Parameters:
    uri - the URI to check
    
    Returns:
    true if they're compatible, false otherwise
    Since:
    
    V0.3-2
  - setRawMode
```
public void setRawMode(boolean raw)
```
    Deprecated. This is not really needed anymore; in V0.2 request were synchronous and therefore to do pipelining you needed to disable the processing of responses.
    
    Sets/Resets raw mode. In raw mode all modules are bypassed, meaning the automatic handling of authorization requests, redirections, cookies, etc. is turned off.
    The default is false.
    
    Parameters:
    raw - if true removes all modules (except for the retry module)
    See Also:
    removeModule(java.lang.Class)
  - setDefaultTimeout
```
public static void setDefaultTimeout(int time)
```
    Sets the default timeout value to be used for each new HTTPConnection. The default is 0.
    
    Parameters:
    time - the timeout in milliseconds.
    See Also:
    setTimeout(int)
  - getDefaultTimeout
```
public static int getDefaultTimeout()
```
    Gets the default timeout value to be used for each new HTTPConnection.
    
    Returns:
    the timeout in milliseconds.
    See Also:
    setTimeout(int)
  - setTimeout
```
public void setTimeout(int time)
```
    Sets the timeout to be used for creating connections and reading responses. When a timeout expires the operation will throw an InterruptedIOException. The operation may be restarted again afterwards. If the operation is not restarted and it is a read operation (i.e HTTPResponse.xxxx()) then resp.getInputStream().close() should be invoked.
    When creating new sockets the timeout will limit the time spent doing the host name translation and establishing the connection with the server.
    The timeout also influences the reading of the response headers. However, it does not specify a how long, for example, getStatusCode() may take, as might be assumed. Instead it specifies how long a read on the socket may take. If the response dribbles in slowly with packets arriving quicker than the timeout then the method will complete normally. I.e. the exception is only thrown if nothing arrives on the socket for the specified time. Furthermore, the timeout only influences the reading of the headers, not the reading of the body.
    Read Timeouts are associated with responses, so that you may change this value before each request and it won't affect the reading of responses to previous requests.
    
    Parameters:
    time - the time in milliseconds. A time of 0 means wait indefinitely.
    See Also:
    stop()
  - getTimeout
```
public int getTimeout()
```
    Gets the timeout used for reading response data.
    
    Returns:
    the current timeout value
    See Also:
    setTimeout(int)
  - setAllowUserInteraction
```
public void setAllowUserInteraction(boolean allow)
```
    Controls whether modules are allowed to prompt the user or pop up dialogs if neccessary.
    
    Parameters:
    allow - if true allows modules to interact with user.
  - getAllowUserInteraction
```
public boolean getAllowUserInteraction()
```
    returns whether modules are allowed to prompt or popup dialogs if neccessary.
    
    Returns:
    true if modules are allowed to interact with user.
  - setDefaultAllowUserInteraction
```
public static void setDefaultAllowUserInteraction(boolean allow)
```
    Sets the default allow-user-action.
    
    Parameters:
    allow - if true allows modules to interact with user.
  - getDefaultAllowUserInteraction
```
public static boolean getDefaultAllowUserInteraction()
```
    Gets the default allow-user-action.
    
    Returns:
    true if modules are allowed to interact with user.
  - getDefaultModules
```
public static Class[] getDefaultModules()
```
    Returns the default list of modules.
    
    Returns:
    an array of classes
  - addDefaultModule
```
public static boolean addDefaultModule(Class module,
                       int pos)
```
    Adds a module to the default list. It must implement the HTTPClientModule interface. If the module is already in the list then this method does nothing. This method only affects instances of HTTPConnection created after this method has been invoked; it does not affect existing instances.
    Example:
```
 HTTPConnection.addDefaultModule(Class.forName("HTTPClient.CookieModule"), 1);
 
```
    adds the cookie module as the second module in the list.
    The default list is created at class initialization time from the property HTTPClient.Modules. This must contain a "|" separated list of classes in the order they're to be invoked. If this property is not set it defaults to: "HTTPClient.RetryModule | HTTPClient.CookieModule | HTTPClient.RedirectionModule | HTTPClient.AuthorizationModule | HTTPClient.DefaultModule | HTTPClient.TransferEncodingModule | HTTPClient.ContentMD5Module | HTTPClient.ContentEncodingModule"
    Parameters:
    module - the module's Class object
    pos - the position of this module in the list; if pos >= 0 then this is the absolute position in the list (0 is the first position); if pos < 0 then this is the position relative to the end of the list (-1 means the last element, -2 the second to last element, etc).
    
    Returns:
    true if module was successfully added; false if the module is already in the list.
    
    Throws:
    
    ArrayIndexOutOfBoundsException - if pos > list-size or if pos < -(list-size).
    
    ClassCastException - if module does not implement the HTTPClientModule interface.
    
    RuntimeException - if module cannot be instantiated.
    See Also:
    HTTPClientModule
  - removeDefaultModule
```
public static boolean removeDefaultModule(Class module)
```
    Removes a module from the default list. If the module is not in the list it does nothing. This method only affects instances of HTTPConnection created after this method has been invoked; it does not affect existing instances.
    
    Parameters:
    module - the module's Class object
    
    Returns:
    true if module was successfully removed; false otherwise
  - getModules
```
public Class[] getModules()
```
    Returns the list of modules used currently.
    
    Returns:
    an array of classes
  - addModule
```
public boolean addModule(Class module,
                int pos)
```
    Adds a module to the current list. It must implement the HTTPClientModule interface. If the module is already in the list then this method does nothing.
    
    Parameters:
    module - the module's Class object
    pos - the position of this module in the list; if pos >= 0 then this is the absolute position in the list (0 is the first position); if pos < 0 then this is the position relative to the end of the list (-1 means the last element, -2 the second to last element, etc).
    
    Returns:
    true if module was successfully added; false if the module is already in the list.
    
    Throws:
    
    ArrayIndexOutOfBoundsException - if pos > list-size or if pos < -(list-size).
    
    ClassCastException - if module does not implement the HTTPClientModule interface.
    
    RuntimeException - if module cannot be instantiated.
    See Also:
    HTTPClientModule
  - removeModule
```
public boolean removeModule(Class module)
```
    Removes a module from the current list. If the module is not in the list it does nothing.
    
    Parameters:
    module - the module's Class object
    
    Returns:
    true if module was successfully removed; false otherwise
  - setContext
```
public void setContext(Object context)
```
    Sets the current context. The context is used by modules such as the AuthorizationModule and the CookieModule which keep lists of info that is normally shared between all instances of HTTPConnection. This is usually the desired behaviour. However, in some cases one would like to simulate multiple independent clients within the same application and hence the sharing of such info should be restricted. This is where the context comes in. Modules will only share their info between requests using the same context (i.e. they keep multiple lists, one for each context).
    The context may be any object. Contexts are considered equal if equals() returns true. Examples of useful context objects are threads (e.g. if you are running multiple clients, one per thread) and sockets (e.g. if you are implementing a gateway).
    When a new HTTPConnection is created it is initialized with a default context which is the same for all instances. This method must be invoked immediately after a new HTTPConnection is created and before any request method is invoked. Furthermore, this method may only be called once (i.e. the context is "sticky").
    
    Parameters:
    context - the new context; must be non-null
    
    Throws:
    
    IllegalArgumentException - if context is null
    
    IllegalStateException - if the context has already been set
  - getContext
```
public Object getContext()
```
    Returns the current context.
    
    Returns:
    the current context, or the default context if setContext() hasn't been invoked
    See Also:
    setContext(java.lang.Object)
  - getDefaultContext
```
public static Object getDefaultContext()
```
    Returns the default context.
    
    Returns:
    the default context
    See Also:
    setContext(java.lang.Object)
  - addDigestAuthorization
```
public void addDigestAuthorization(String realm,
                          String user,
                          String passwd)
```
    Adds an authorization entry for the "digest" authorization scheme to the list. If an entry already exists for the "digest" scheme and the specified realm then it is overwritten.
    This is a convenience method and just invokes the corresponding method in AuthorizationInfo.
    
    Parameters:
    realm - the realm
    user - the username
    passw - the password
    See Also:
    AuthorizationInfo.addDigestAuthorization(java.lang.String, int, java.lang.String, java.lang.String, java.lang.String)
  - addBasicAuthorization
```
public void addBasicAuthorization(String realm,
                         String user,
                         String passwd)
```
    Adds an authorization entry for the "basic" authorization scheme to the list. If an entry already exists for the "basic" scheme and the specified realm then it is overwritten.
    This is a convenience method and just invokes the corresponding method in AuthorizationInfo.
    
    Parameters:
    realm - the realm
    user - the username
    passw - the password
    See Also:
    AuthorizationInfo.addBasicAuthorization(java.lang.String, int, java.lang.String, java.lang.String, java.lang.String)
  - setProxyServer
```
public static void setProxyServer(String host,
                  int port)
```
    Sets the default proxy server to use. The proxy will only be used for new HTTPConnections created after this call and will not affect currrent instances of HTTPConnection. A null or empty string host parameter disables the proxy.
    In an application or using the Appletviewer an alternative to this method is to set the following properties (either in the properties file or on the command line): http.proxyHost and http.proxyPort. Whether http.proxyHost is set or not determines whether a proxy server is used.
    If the proxy server requires authorization and you wish to set this authorization information in the code, then you may use any of the AuthorizationInfo.addXXXAuthorization() methods to do so. Specify the same host and port as in this method. If you have not given any authorization info and the proxy server requires authorization then you will be prompted for the necessary info via a popup the first time you do a request.
    
    Parameters:
    host - the host on which the proxy server resides.
    port - the port the proxy server is listening on.
    See Also:
    setCurrentProxy(java.lang.String, int)
  - setCurrentProxy
```
public void setCurrentProxy(String host,
                   int port)
```
    Sets the proxy used by this instance. This can be used to override the proxy setting inherited from the default proxy setting. A null or empty string host parameter disables the proxy.
    Note that if you set a proxy for the connection using this method, and a request made over this connection is redirected to a different server, then the connection used for new server will not pick this proxy setting, but instead will use the default proxy settings.
    
    Parameters:
    host - the host the proxy runs on
    port - the port the proxy is listening on
    See Also:
    setProxyServer(java.lang.String, int)
  - dontProxyFor
```
public static void dontProxyFor(String host)
                         throws ParseException
```
    Add host to the list of hosts which should be accessed directly, not via any proxy set by setProxyServer().
    The host may be any of:
    - a complete host name (e.g. "www.disney.com")
    - a domain name; domain names must begin with a dot (e.g. ".disney.com")
    - an IP-address (e.g. "12.34.56.78")
    - an IP-subnet, specified as an IP-address and a netmask separated by a "/" (e.g. "34.56.78/255.255.255.192"); a 0 bit in the netmask means that that bit won't be used in the comparison (i.e. the addresses are AND'ed with the netmask before comparison).
    The two properties HTTPClient.nonProxyHosts and http.nonProxyHosts are used when this class is loaded to initialize the list of non-proxy hosts. The second property is only read if the first one is not set; the second property is also used the JDK's URLConnection. These properties must contain a "|" separated list of entries which conform to the above rules for the host parameter (e.g. "11.22.33.44|.disney.com").
    Parameters:
    host - a host name, domain name, IP-address or IP-subnet.
    
    Throws:
    
    ParseException - if the length of the netmask does not match the length of the IP-address
  - dontProxyFor
```
public static void dontProxyFor(String[] hosts)
```
    Convenience method to add a number of hosts at once. If any one host is null or cannot be parsed it is ignored.
    
    Parameters:
    hosts - The list of hosts to set
    Since:
    
    V0.3-2
    
    See Also:
    dontProxyFor(java.lang.String)
  - doProxyFor
```
public static boolean doProxyFor(String host)
                          throws ParseException
```
    Remove host from the list of hosts for which the proxy should not be used. This modifies the same list that dontProxyFor() uses, i.e. this is used to undo a dontProxyFor() setting. The syntax for host is specified in dontProxyFor().
    
    Parameters:
    host - a host name, domain name, IP-address or IP-subnet.
    
    Returns:
    true if the remove was sucessful, false otherwise
    
    Throws:
    
    ParseException - if the length of the netmask does not match the length of the IP-address
    See Also:
    dontProxyFor(java.lang.String)
  - setSocksServer
```
public static void setSocksServer(String host)
```
    Sets the SOCKS server to use. The server will only be used for new HTTPConnections created after this call and will not affect currrent instances of HTTPConnection. A null or empty string host parameter disables SOCKS.
    The code will try to determine the SOCKS version to use at connection time. This might fail for a number of reasons, however, in which case you must specify the version explicitly.
    
    Parameters:
    host - the host on which the proxy server resides. The port used is the default port 1080.
    See Also:
    setSocksServer(java.lang.String, int, int)
  - setSocksServer
```
public static void setSocksServer(String host,
                  int port)
```
    Sets the SOCKS server to use. The server will only be used for new HTTPConnections created after this call and will not affect currrent instances of HTTPConnection. A null or empty string host parameter disables SOCKS.
    The code will try to determine the SOCKS version to use at connection time. This might fail for a number of reasons, however, in which case you must specify the version explicitly.
    
    Parameters:
    host - the host on which the proxy server resides.
    port - the port the proxy server is listening on.
    See Also:
    setSocksServer(java.lang.String, int, int)
  - setSocksServer
```
public static void setSocksServer(String host,
                  int port,
                  int version)
                           throws SocksException
```
    Sets the SOCKS server to use. The server will only be used for new HTTPConnections created after this call and will not affect currrent instances of HTTPConnection. A null or empty string host parameter disables SOCKS.
    In an application or using the Appletviewer an alternative to this method is to set the following properties (either in the properties file or on the command line): HTTPClient.socksHost, HTTPClient.socksPort and HTTPClient.socksVersion. Whether HTTPClient.socksHost is set or not determines whether a SOCKS server is used; if HTTPClient.socksPort is not set it defaults to 1080; if HTTPClient.socksVersion is not set an attempt will be made to automatically determine the version used by the server.
    Note: If you have also set a proxy server then a connection will be made to the SOCKS server, which in turn then makes a connection to the proxy server (possibly via other SOCKS servers), which in turn makes the final connection.
    If the proxy server is running SOCKS version 5 and requires username/password authorization, and you wish to set this authorization information in the code, then you may use the AuthorizationInfo.addAuthorization() method to do so. Specify the same host and port as in this method, give the scheme "SOCKS5" and the realm "USER/PASS", set the cookie to null and the params to an array containing a single NVPair in turn containing the username and password. Example:
```
     NVPair[] up = { new NVPair(username, password) };
     AuthorizationInfo.addAuthorization(host, port, "SOCKS5", "USER/PASS",
                                        null, up);
 
```
    If you have not given any authorization info and the proxy server requires authorization then you will be prompted for the necessary info via a popup the first time you do a request.
    Parameters:
    host - the host on which the proxy server resides.
    port - the port the proxy server is listening on.
    version - the SOCKS version the server is running. Currently this must be '4' or '5'.
    
    Throws:
    
    SocksException - If version is not '4' or '5'.
  - setupRequest
```
protected final HTTPResponse setupRequest(String method,
                        String resource,
                        NVPair[] headers,
                        byte[] entity,
                        HttpOutputStream stream)
                                   throws IOException,
                                          ModuleException
```
    Sets up the request, creating the list of headers to send and creating instances of the modules. This may be invoked by subclasses which add further methods (such as those from DAV and IPP).
    
    Parameters:
    method - GET, POST, etc.
    resource - the resource
    headers - an array of headers to be used
    entity - the entity (or null)
    stream - the output stream (or null) - only one of stream and entity may be non-null
    
    Returns:
    the response.
    
    Throws:
    
    IOException - when an exception is returned from the socket.
    
    ModuleException - if an exception is encountered in any module.
  - setCheckCertificates
```
public final void setCheckCertificates(boolean b)
```
  - getCheckCertificates
```
public final boolean getCheckCertificates()
```
  - setTestConnectionHealthWithBlockingRead
```
public final void setTestConnectionHealthWithBlockingRead(boolean b)
```
  - getTestConnectionHealthWithBlockingRead
```
public final boolean getTestConnectionHealthWithBlockingRead()
```
  - setLocalAddress
```
public final void setLocalAddress(InetAddress localAddress,
                   int localPort)
```
    Allow local address and port to be modified after HTTPConnection has been created. Will only affect new socket connections, so you may want to call stop() first.
    
    Parameters:
    localAddress - an InetAddress value
    localPort - an int value
  - getDnsTime
```
public long getDnsTime()
```
    ++GRINDER-MODIFICATION++
  - getConnectTime
```
public long getConnectTime()
```
  - getConnectionsEstablished
```
public long getConnectionsEstablished()
```
  - toString
```
public String toString()
```
    Generates a string of the form protocol://host.domain:port .
    
    Overrides:
    
    toString in class Object
    
    Returns:
    the string
  - setBufferGrowthStrategyFactory
```
public void setBufferGrowthStrategyFactory(HTTPConnection.BandwidthLimiterFactory f)
```

Class HTTPConnection

Nested Class Summary

Field Summary

Fields inherited from interface HTTPClient.HTTPClientModuleConstants

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

version

HTTP

HTTPS

SHTTP

HTTP_NG

HTTP_1_0

HTTP_1_1

CD_NONE

CD_HDRS

CD_0

CD_CLOSE

CD_CONTLEN

CD_CHUNKED

CD_MP_BR

Constructor Detail

HTTPConnection

HTTPConnection

HTTPConnection

HTTPConnection

HTTPConnection

HTTPConnection

HTTPConnection

Method Detail

setTimeAuthority

getTimeAuthority

getSSLCipherSuites

getSSLProtocols

Head

Head

Head

Head

Head

Get

Get

Get

Get

Get

Post

Post

Post

Post

Post

Post

Post

Post

Post

Put

Put

Put

Put

Put

Put

Options

Options

Options

Options

Delete

Delete

Trace

Trace

ExtensionMethod

ExtensionMethod

stop

setDefaultSSLSocketFactory

getDefaultSSLSocketFactory

setSSLSocketFactory

getSSLSocketFactory

setDefaultHeaders

getDefaultHeaders

getProtocol

getHost

getPort