org.owasp.dependencycheck.utils

Class HttpResourceConnection

java.lang.Object

org.owasp.dependencycheck.utils.HttpResourceConnection

All Implemented Interfaces:

AutoCloseable

public class HttpResourceConnection
extends Object
implements AutoCloseable

A utility to download files from the Internet.

Version:

$Id: $Id

Author:

Jeremy Long

Constructor Summary

Constructors

Constructor and Description
HttpResourceConnection(Settings settings) Constructs a new HttpResourceConnection object.
HttpResourceConnection(Settings settings, boolean usesProxy) Constructs a new HttpResourceConnection object.
HttpResourceConnection(Settings settings, boolean usesProxy, String userKey, String passwordKey) Constructs a new HttpResourceConnection object.

Method Summary

Modifier and Type	Method and Description
void	checkForCommonExceptionTypes(IOException ex) Analyzes the IOException, logs the appropriate information for debugging purposes, and then throws a DownloadFailedException that wraps the IO Exception for common IO Exceptions.
void	close()
InputStream	fetch(URL url) Retrieves the resource identified by the given URL and returns the InputStream.
long	getLastModified(URL url) Deprecated. this method is no longer used to check the last modified date of the NVD. This method will be removed in a future release.
boolean	isClosed() Returns whether or not the connection has been closed.

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpResourceConnection

public HttpResourceConnection(Settings settings)

Constructs a new HttpResourceConnection object.

Parameters:

settings - the configured settings

HttpResourceConnection

public HttpResourceConnection(Settings settings,
                              boolean usesProxy)

Constructs a new HttpResourceConnection object.

Parameters:

settings - the configured settings

usesProxy - control whether this conn will use the defined proxy.

HttpResourceConnection

public HttpResourceConnection(Settings settings,
                              boolean usesProxy,
                              String userKey,
                              String passwordKey)

Constructs a new HttpResourceConnection object.

Parameters:

settings - the configured settings

usesProxy - control whether this conn will use the defined proxy

userKey - the settings key for the username to be used

passwordKey - the settings key for the password to be used

Method Detail

fetch

public InputStream fetch(URL url)
                  throws DownloadFailedException,
                         TooManyRequestsException,
                         ResourceNotFoundException

Retrieves the resource identified by the given URL and returns the InputStream.

Parameters:

url - the URL of the resource to download

Returns:

the stream to read the retrieved content from

Throws:

DownloadFailedException - is thrown if there is an error downloading the resource

TooManyRequestsException - thrown when a 429 is received

ResourceNotFoundException - thrown when a 404 is received

getLastModified

@Deprecated
public long getLastModified(URL url)
                                 throws DownloadFailedException

Deprecated. this method is no longer used to check the last modified date of the NVD. This method will be removed in a future release.

Makes an HTTP Head request to retrieve the last modified date of the given URL. If the file:// protocol is specified, then the lastTimestamp of the file is returned.

Parameters:

url - the URL to retrieve the timestamp from

Returns:

an epoch timestamp

Throws:

DownloadFailedException - is thrown if an exception occurs making the HTTP request

close

public void close()

Releases the underlying HTTP URL Connection.

Specified by:

close in interface AutoCloseable

isClosed

public boolean isClosed()

Returns whether or not the connection has been closed.

Returns:

whether or not the connection has been closed

checkForCommonExceptionTypes

public void checkForCommonExceptionTypes(IOException ex)
                                  throws DownloadFailedException

Analyzes the IOException, logs the appropriate information for debugging purposes, and then throws a DownloadFailedException that wraps the IO Exception for common IO Exceptions. This is to provide additional details to assist in resolution of the exception.

Parameters:

ex - the original exception

Throws:

DownloadFailedException - a wrapper exception that contains the original exception as the cause