org.apache.ivy.util.url

Class URLHandlerDispatcher

java.lang.Object

org.apache.ivy.util.url.URLHandlerDispatcher

All Implemented Interfaces:

TimeoutConstrainedURLHandler, URLHandler

public class URLHandlerDispatcher
extends java.lang.Object
implements TimeoutConstrainedURLHandler

An implementation of URLHandler which uses an underlying URLHandler per protocol and a fallback default URLHandler for dealing with downloads, uploads and general reachability checks

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 and Description
URLHandlerDispatcher()

Method Summary

Modifier and Type	Method and 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
long	getContentLength(java.net.URL url) Please prefer getURLInfo when several infos are needed.
long	getContentLength(java.net.URL url, int timeout)
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.
URLHandler	getDefault()
URLHandler	getHandler(java.lang.String protocol)
long	getLastModified(java.net.URL url) Please prefer getURLInfo when several infos are needed.
long	getLastModified(java.net.URL url, int timeout) Please prefer getURLInfo when several infos are needed.
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 URLInfo extracted from the given url, or URLHandler.UNAVAILABLE when the url is not reachable.
boolean	isReachable(java.net.URL url) Please prefer getURLInfo when several infos are needed.
boolean	isReachable(java.net.URL url, int timeout) Please prefer getURLInfo when several infos are needed.
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	setDefault(URLHandler default1)
void	setDownloader(java.lang.String protocol, URLHandler downloader)
void	setRequestMethod(int requestMethod)
void	upload(java.io.File src, 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 java.lang.Object

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

Constructor Detail

URLHandlerDispatcher

public URLHandlerDispatcher()

Method Detail

isReachable

public boolean isReachable(java.net.URL url)

Description copied from interface: URLHandler

Please prefer getURLInfo when several infos are needed.

Specified by:

isReachable in interface URLHandler

Parameters:

url - the url to check

Returns:

true if the target is reachable

isReachable

public boolean isReachable(java.net.URL url,
                           int timeout)

Description copied from interface: URLHandler

Please prefer getURLInfo when several infos are needed.

Specified by:

isReachable in interface URLHandler

Parameters:

url - the url to check

timeout - the timeout in milliseconds

Returns:

true if the target is reachable

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)

Description copied from interface: URLHandler

Please prefer getURLInfo when several infos are needed.

Specified by:

getContentLength in interface URLHandler

Parameters:

url - the url to check

Returns:

the length of the target if the given url is reachable, 0 otherwise. No error code in case of http urls.

getContentLength

public long getContentLength(java.net.URL url,
                             int timeout)

Specified by:

getContentLength in interface URLHandler

Parameters:

url - the url to check

timeout - the maximum time before considering an url is not reachable a timeout of zero indicates no timeout

Returns:

the length of the target if the given url is reachable, 0 otherwise. No error code in case of http urls.

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)

Description copied from interface: URLHandler

Please prefer getURLInfo when several infos are needed.

Specified by:

getLastModified in interface URLHandler

Parameters:

url - the url to check

Returns:

last modified timestamp of the given url

getLastModified

public long getLastModified(java.net.URL url,
                            int timeout)

Description copied from interface: URLHandler

Please prefer getURLInfo when several infos are needed.

Specified by:

getLastModified in interface URLHandler

Parameters:

url - the url to check

timeout - the timeout in milliseconds

Returns:

last modified timestamp of the given url

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)

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.

getURLInfo

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

Description copied from interface: TimeoutConstrainedURLHandler

Returns the 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

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 src,
                   java.net.URL dest,
                   CopyProgressListener l)
            throws java.io.IOException

Specified by:

upload in interface URLHandler

Parameters:

src - 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

setRequestMethod

public void setRequestMethod(int requestMethod)

Specified by:

setRequestMethod in interface URLHandler

setDownloader

public void setDownloader(java.lang.String protocol,
                          URLHandler downloader)

getHandler

public URLHandler getHandler(java.lang.String protocol)

getDefault

public URLHandler getDefault()

setDefault

public void setDefault(URLHandler default1)