Package org.apache.ivy.util.url

Class BasicURLHandler

java.lang.Object

org.apache.ivy.util.url.AbstractURLHandler

org.apache.ivy.util.url.BasicURLHandler

All Implemented Interfaces:

TimeoutConstrainedURLHandler, URLHandler

public class BasicURLHandler
extends AbstractURLHandler
implements TimeoutConstrainedURLHandler

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.ivy.util.url.URLHandler

URLHandler.URLInfo

Field Summary

Fields inherited from interface org.apache.ivy.util.url.URLHandler

REQUEST_METHOD_GET, REQUEST_METHOD_HEAD, UNAVAILABLE

Constructor Summary

Constructors

Constructor	Description
BasicURLHandler()

Method Summary

Modifier and Type	Method	Description
void	download(java.net.URL src, java.io.File dest, CopyProgressListener l)
void	download(java.net.URL src, java.io.File dest, CopyProgressListener listener, TimeoutConstraint timeoutConstraint)	Downloads the resource available at src to the target dest
static java.lang.String	getCharSetFromContentType(java.lang.String contentType)	Extract the charset from the Content-Type header string, or default to ISO-8859-1 as per rfc2616-sec3.html#sec3.7.1 .
long	getContentLength(java.net.URL url, TimeoutConstraint timeoutConstraint)	Returns the number of bytes of data that's available for the resource at the passed url.
long	getLastModified(java.net.URL url, TimeoutConstraint timeoutConstraint)	Returns the last modified timestamp of the resource accessible at the passed url.
URLHandler.URLInfo	getURLInfo(java.net.URL url)
URLHandler.URLInfo	getURLInfo(java.net.URL url, int timeout)
URLHandler.URLInfo	getURLInfo(java.net.URL url, TimeoutConstraint timeoutConstraint)	Returns the URLHandler.URLInfo extracted from the given url, or URLHandler.UNAVAILABLE when the url is not reachable.
boolean	isReachable(java.net.URL url, TimeoutConstraint timeoutConstraint)	Returns true if the passed URL is reachable.
java.io.InputStream	openStream(java.net.URL url)
java.io.InputStream	openStream(java.net.URL url, TimeoutConstraint timeoutConstraint)	Opens and returns an InputStream to the passed url.
void	upload(java.io.File source, java.net.URL dest, CopyProgressListener l)
void	upload(java.io.File src, java.net.URL dest, CopyProgressListener listener, TimeoutConstraint timeoutConstraint)	Uploads the src File to the target dest URL

Methods inherited from class org.apache.ivy.util.url.AbstractURLHandler

createTimeoutConstraints, getContentLength, getContentLength, getDecodingInputStream, getLastModified, getLastModified, getRequestMethod, getUserAgent, isReachable, isReachable, normalizeToString, normalizeToURL, setRequestMethod, validatePutStatusCode

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.ivy.util.url.URLHandler

getContentLength, getContentLength, getLastModified, getLastModified, isReachable, isReachable, setRequestMethod

Constructor Detail

BasicURLHandler

public BasicURLHandler()

Method Detail

getURLInfo

public URLHandler.URLInfo getURLInfo(java.net.URL url)

Specified by:

getURLInfo in interface URLHandler

Parameters:

url - The url from which information is retrieved.

Returns:

The URLInfo extracted from the given url, or URLHandler.UNAVAILABLE instance when the url is not reachable.

getURLInfo

public URLHandler.URLInfo getURLInfo(java.net.URL url,
                                     int timeout)

Specified by:

getURLInfo in interface URLHandler

Parameters:

url - The url from which information is retrieved.

timeout - The timeout in milliseconds.

Returns:

The URLInfo extracted from the given url, or URLHandler.UNAVAILABLE when the url is not reachable, never null.

isReachable

public boolean isReachable(java.net.URL url,
                           TimeoutConstraint timeoutConstraint)

Description copied from interface: TimeoutConstrainedURLHandler

Returns true if the passed URL is reachable. Else returns false. Uses the passed timeoutConstraint for determining the connectivity to the URL.

Please use TimeoutConstrainedURLHandler.getURLInfo(URL, TimeoutConstraint) if more one information about the url is needed

Specified by:

isReachable in interface TimeoutConstrainedURLHandler

Parameters:

url - The URL to access

timeoutConstraint - The connectivity timeout constraints. Can be null, in which case the timeouts are implementation specific

Returns:

boolean

getContentLength

public long getContentLength(java.net.URL url,
                             TimeoutConstraint timeoutConstraint)

Description copied from interface: TimeoutConstrainedURLHandler

Returns the number of bytes of data that's available for the resource at the passed url. Returns 0 if the passed url isn't reachable

Specified by:

getContentLength in interface TimeoutConstrainedURLHandler

Parameters:

url - The URL to access

timeoutConstraint - The connectivity timeout constraints. Can be null, in which case the timeouts are implementation specific

Returns:

long

getLastModified

public long getLastModified(java.net.URL url,
                            TimeoutConstraint timeoutConstraint)

Description copied from interface: TimeoutConstrainedURLHandler

Returns the last modified timestamp of the resource accessible at the passed url.

Please use TimeoutConstrainedURLHandler.getURLInfo(URL, TimeoutConstraint) if more one information about the url is needed

Specified by:

getLastModified in interface TimeoutConstrainedURLHandler

Parameters:

url - The URL to access

timeoutConstraint - The connectivity timeout constraints. Can be null, in which case the timeouts are implementation specific

Returns:

long

getURLInfo

public URLHandler.URLInfo getURLInfo(java.net.URL url,
                                     TimeoutConstraint timeoutConstraint)

Description copied from interface: TimeoutConstrainedURLHandler

Returns the URLHandler.URLInfo extracted from the given url, or URLHandler.UNAVAILABLE when the url is not reachable. Never returns null.

Specified by:

getURLInfo in interface TimeoutConstrainedURLHandler

Parameters:

url - The URL for which the information is to be retrieved

timeoutConstraint - The connectivity timeout constraints. Can be null, in which case the timeouts are implementation specific

Returns:

URLInfo

getCharSetFromContentType

public static java.lang.String getCharSetFromContentType(java.lang.String contentType)

Extract the charset from the Content-Type header string, or default to ISO-8859-1 as per rfc2616-sec3.html#sec3.7.1 .

Parameters:

contentType - the Content-Type header string

Returns:

the charset as specified in the content type, or ISO-8859-1 if unspecified.

openStream

public java.io.InputStream openStream(java.net.URL url)
                               throws java.io.IOException

Specified by:

openStream in interface URLHandler

Parameters:

url - ditto

Returns:

InputStream

Throws:

java.io.IOException - if something goes wrong

openStream

public java.io.InputStream openStream(java.net.URL url,
                                      TimeoutConstraint timeoutConstraint)
                               throws java.io.IOException

Description copied from interface: TimeoutConstrainedURLHandler

Opens and returns an InputStream to the passed url.

Specified by:

openStream in interface TimeoutConstrainedURLHandler

Parameters:

url - The URL to which an InputStream has to be opened

timeoutConstraint - The connectivity timeout constraints. Can be null, in which case the timeouts are implementation specific

Returns:

InputStream

Throws:

java.io.IOException - if something goes wrong

download

public void download(java.net.URL src,
                     java.io.File dest,
                     CopyProgressListener l)
              throws java.io.IOException

Specified by:

download in interface URLHandler

Parameters:

src - URL

dest - File

l - CopyProgressListener

Throws:

java.io.IOException - if something goes wrong

download

public void download(java.net.URL src,
                     java.io.File dest,
                     CopyProgressListener listener,
                     TimeoutConstraint timeoutConstraint)
              throws java.io.IOException

Description copied from interface: TimeoutConstrainedURLHandler

Downloads the resource available at src to the target dest

Specified by:

download in interface TimeoutConstrainedURLHandler

Parameters:

src - The source URL to download the resource from

dest - The destination File to download the resource to

listener - The listener that will be notified of the download progress

timeoutConstraint - The connectivity timeout constraints. Can be null, in which case the timeouts are implementation specific

Throws:

java.io.IOException - if something goes wrong

upload

public void upload(java.io.File source,
                   java.net.URL dest,
                   CopyProgressListener l)
            throws java.io.IOException

Specified by:

upload in interface URLHandler

Parameters:

source - File

dest - URL

l - CopyProgressListener

Throws:

java.io.IOException - if something goes wrong

upload

public void upload(java.io.File src,
                   java.net.URL dest,
                   CopyProgressListener listener,
                   TimeoutConstraint timeoutConstraint)
            throws java.io.IOException

Description copied from interface: TimeoutConstrainedURLHandler

Uploads the src File to the target dest URL

Specified by:

upload in interface TimeoutConstrainedURLHandler

Parameters:

src - The source File to upload

dest - The target URL where the File has to be uploaded

listener - The listener that will be notified of the upload progress

timeoutConstraint - The connectivity timeout constraints. Can be null, in which case the timeouts are implementation specific

Throws:

java.io.IOException - if something goes wrong