com.knowgate.http

Class HttpRequest

java.lang.Object

java.lang.Thread

com.knowgate.http.HttpRequest

All Implemented Interfaces:

Runnable, Callable<Object>

public class HttpRequest
extends Thread
implements Callable<Object>

Wrapper for an HTTP request

Version:

9.0

Author:

Sergio Montoro Ten

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

Thread.State, Thread.UncaughtExceptionHandler

Field Summary

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
HttpRequest(String sUrl) Create new request for the given URL with default method GET
HttpRequest(String sUrl, URL oReferUrl, String sMethod, Map.Entry<String,String>[] aParams) Create new request for the given URL
HttpRequest(String sUrl, URL oReferUrl, String sMethod, Map.Entry<String,String>[] aParams, String sUsr, String sPwd) Create new request for the given URL with basic authentication

Method Summary

Modifier and Type	Method and Description
void	addCookie(String name, String value) Add a cookie for the next call
void	addHeader(String name, String value) Add a header for the next call
Object	call()
String	encoding() Get response encoding
Object	get() Perform HTTP GET request
List<Map.Entry<String,String>>	getCookies() Get cookies read from the last get or post call
List<Map.Entry<String,String>>	getHeaders() Get headers read from the last get or post call
String	getLanguage() Get response HTML document content language
String	getTitle() Get response HTML document title
int	head() Perform HTTP HEAD request
Object	post() Perform HTTP POST request
int	responseCode() Get response code from last GET, POST or HEAD request
void	run()
void	setCookies(List<Map.Entry<String,String>> aCookies) Set cookies for next call to get or post method
void	setCookies(Map<String,String> mCookies) Set cookies for next call to get or post method
void	setHeaders(List<Map.Entry<String,String>> aHeaders) Set headers for next call to get or post method
void	setHeaders(Map<String,String> mHeaders) Set headers for next call to get or post method
String	src() Get response as String
String	url()

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpRequest

public HttpRequest(String sUrl)

Create new request for the given URL with default method GET

Parameters:

sUrl - String

HttpRequest

public HttpRequest(String sUrl,
                   URL oReferUrl,
                   String sMethod,
                   Map.Entry<String,String>[] aParams)

Create new request for the given URL

Parameters:

sUrl - String requested URL

oReferUrl - String Referrer URL

sMethod - String Must be "get" or "post"

aParams - Array with parameters to be sent along with get or post

HttpRequest

public HttpRequest(String sUrl,
                   URL oReferUrl,
                   String sMethod,
                   Map.Entry<String,String>[] aParams,
                   String sUsr,
                   String sPwd)

Create new request for the given URL with basic authentication

Parameters:

sUrl - String requested URL

oReferUrl - String Referer URL

sMethod - String Must be "get" or "post"

aParams - Array with parameters to be sent along with get or post

sUsr - String

sPwd - String

Method Detail

addCookie

public void addCookie(String name,
                      String value)

Add a cookie for the next call

Parameters:

name - String Cookie Name

value - String Cookie Value

addHeader

public void addHeader(String name,
                      String value)

Add a header for the next call

Parameters:

name - String Header Name

value - String Header Value

getCookies

public List<Map.Entry<String,String>> getCookies()

Get cookies read from the last get or post call

Returns:

List<Entry<String,String>>

getHeaders

public List<Map.Entry<String,String>> getHeaders()

Get headers read from the last get or post call

Returns:

List<Entry<String,String>>

setCookies

public void setCookies(List<Map.Entry<String,String>> aCookies)

Set cookies for next call to get or post method

Parameters:

aCookies - List<Entry<String,String>>

setCookies

public void setCookies(Map<String,String> mCookies)

Set cookies for next call to get or post method

Parameters:

mCookies - Map<String,String>

setHeaders

public void setHeaders(List<Map.Entry<String,String>> aHeaders)

Set headers for next call to get or post method

Parameters:

aHeaders - List<Entry<String,String>>

setHeaders

public void setHeaders(Map<String,String> mHeaders)

Set headers for next call to get or post method

Parameters:

mHeaders - Map<String,String>

run

public void run()

Specified by:

run in interface Runnable

Overrides:

run in class Thread

call

public Object call()

Specified by:

call in interface Callable<Object>

post

public Object post()
            throws IOException,
                   URISyntaxException,
                   MalformedURLException

Perform HTTP POST request

Returns:

Object A String or a byte array containing the response to the request

Throws:

IOException - if server returned any status different from HTTP_MOVED_PERM (301), HTTP_MOVED_TEMP (302), HTTP_OK (200) or HTTP_ACCEPTED (202)

URISyntaxException

MalformedURLException

url

public String url()

get

public Object get()
           throws IOException,
                  URISyntaxException,
                  MalformedURLException

Perform HTTP GET request

Returns:

Object A String or a byte array containing the response to the request

Throws:

IOException - if server returned any status different from HTTP_MOVED_PERM (301), HTTP_MOVED_TEMP (302), HTTP_OK (200) or HTTP_ACCEPTED (202)

URISyntaxException

MalformedURLException

head

public int head()
         throws IOException,
                URISyntaxException,
                MalformedURLException

Perform HTTP HEAD request

Returns:

int HTTP response code

Throws:

IOException

URISyntaxException

MalformedURLException

responseCode

public int responseCode()

Get response code from last GET, POST or HEAD request

Returns:

int

src

public String src()
           throws IOException,
                  UnsupportedEncodingException,
                  URISyntaxException

Get response as String

Returns:

String

Throws:

IOException

UnsupportedEncodingException

URISyntaxException

encoding

public String encoding()
                throws IOException,
                       UnsupportedEncodingException,
                       URISyntaxException

Get response encoding

Returns:

String

Throws:

IOException

UnsupportedEncodingException

URISyntaxException

getTitle

public String getTitle()
                throws IOException,
                       URISyntaxException,
                       MalformedURLException,
                       UnsupportedEncodingException

Get response HTML document title

Returns:

String

Throws:

IOException

URISyntaxException

MalformedURLException

UnsupportedEncodingException

getLanguage

public String getLanguage()
                   throws IOException,
                          URISyntaxException,
                          MalformedURLException,
                          UnsupportedEncodingException,
                          org.htmlparser.util.ParserException

Get response HTML document content language

Returns:

String

Throws:

IOException

org.htmlparser.util.ParserException

URISyntaxException

MalformedURLException

UnsupportedEncodingException