edu.msoe.se1021.Lab6

Class WebsiteTester

java.lang.Object

edu.msoe.se1021.Lab6.WebsiteTester

public class WebsiteTester
extends java.lang.Object

This class will handle making connections with a website, downloading the conent, and will provide feedback on the performance of the website.

Author:

Walter Schilling

Constructor Summary

Constructors

Constructor and Description
WebsiteTester()

Method Summary

Modifier and Type	Method and Description
void	downloadText()
java.lang.String	getContent() This method will return the contents that have been downloaded from the given site.
long	getDownloadTime() This method will obtain the download time in MS for the given file.
java.lang.String	getHostname() This method will return the hostname for the given machine which is hosting the website.
int	getPort() This method will return the Port that the system is connected to.
int	getSize() This method will return the size of the downloaded web resource.
java.lang.String	getTimeout() This method will return the current timeout as a string.
boolean	isUrlSet() This method will determine if the URL that is to be accessed has been initialized.
void	openConnection() This method will open a connection with a remote site in order that the page can be downloaded.
void	openURL(java.lang.String url) This method will convert a string into a URL that can be accessed.
void	setTimeout(java.lang.String timeout) This method will set the timeout, or how long the system will wait for a connection from the remote server.

Methods inherited from class java.lang.Object

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

Constructor Detail

WebsiteTester

public WebsiteTester()

Method Detail

openURL

public void openURL(java.lang.String url)
             throws java.net.MalformedURLException

This method will convert a string into a URL that can be accessed.

Parameters:

url - This is a string representation for the URL. The string should include

Throws:

java.net.MalformedURLException - This exception will be thrown if the url passed in does not represent a valid URL.

openConnection

public void openConnection()
                    throws java.net.MalformedURLException,
                           java.net.UnknownHostException,
                           java.net.SocketTimeoutException,
                           java.io.IOException

This method will open a connection with a remote site in order that the page can be downloaded.

Throws:

java.net.MalformedURLException - This exception will be thrown if the url passed in does not represent a valid URL.

java.net.UnknownHostException - This exception will be thrown if the system is unable to connect to the remote host because while the URL is a valid URL, it does not reference a machine which is online.

java.net.SocketTimeoutException - This exception will be thrown if it is taking too long to connect to the given machine.

java.io.IOException - This exception will be thrown if there is another IO exception opening the connection with the remote machine.

downloadText

public void downloadText()
                  throws java.net.UnknownHostException,
                         java.net.ConnectException,
                         java.io.FileNotFoundException,
                         java.io.IOException

Throws:

java.net.UnknownHostException - This exception will be thrown if the system is unable to connect to the remote host because while the URL is a valid URL, it does not reference a machine which is online.

java.net.ConnectException - This exception will be thrown if the system is unable to connect to the given URL and download it to the local machine.

java.io.FileNotFoundException - This exception will be thrown if the given file does not exist on the remote machine and therefore can not be downloaded.

java.io.IOException - This exception will be thrown if there is a general problem downloading the given file.

getSize

public int getSize()

This method will return the size of the downloaded web resource.

Returns:

The return will be the size of the web resource in bytes.

setTimeout

public void setTimeout(java.lang.String timeout)
                throws java.lang.NumberFormatException

This method will set the timeout, or how long the system will wait for a connection from the remote server.

Parameters:

timeout - This is the timeout in ms.

Throws:

java.lang.NumberFormatException - A number format exception will be thrown if the entry is either not an integer or is a negative number.

getTimeout

public java.lang.String getTimeout()

This method will return the current timeout as a string.

Returns:

The timeout in ms will be returned as a string.

getContent

public java.lang.String getContent()

This method will return the contents that have been downloaded from the given site.

Returns:

The material downloaded will be returned as a string.

getDownloadTime

public long getDownloadTime()

This method will obtain the download time in MS for the given file.

Returns:

This is the time it takes to download the given file.

getPort

public int getPort()

This method will return the Port that the system is connected to.

Returns:

The port number will be returned.

getHostname

public java.lang.String getHostname()

This method will return the hostname for the given machine which is hosting the website.

Returns:

The hostname will be returned as a string.

isUrlSet

public boolean isUrlSet()

This method will determine if the URL that is to be accessed has been initialized.

Returns:

TRUE will be returned if a URL has been set. False otherwise.