Package org.apache.ivy.util.url

Class URLHandlerDispatcher

java.lang.Object

org.apache.ivy.util.url.URLHandlerDispatcher

All Implemented Interfaces:

URLHandler

public class URLHandlerDispatcher
extends java.lang.Object
implements URLHandler

This class is used to dispatch downloading requests

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

Method Summary

Modifier and Type	Method	Description
void	download(java.net.URL src, java.io.File dest, CopyProgressListener l)
long	getContentLength(java.net.URL url)	Returns the length of the target if the given url is reachable, and without error code in case of http urls.
long	getContentLength(java.net.URL url, int timeout)	Returns the length of the target if the given url is reachable, and without error code in case of http urls.
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.
URLHandler.URLInfo	getURLInfo(java.net.URL url)	Returns the URLInfo of the given url or a URLHandler.UNAVAILABLE instance, if the url is not reachable.
URLHandler.URLInfo	getURLInfo(java.net.URL url, int timeout)	never returns null, return UNAVAILABLE when 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.
java.io.InputStream	openStream(java.net.URL 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)

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

Returns:

true if the target is reachable

getContentLength

public long getContentLength(java.net.URL url)

Description copied from interface: URLHandler

Returns the length of the target if the given url is reachable, and without error code in case of http urls. 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 available, 0 if not reachable

getContentLength

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

Description copied from interface: URLHandler

Returns the length of the target if the given url is reachable, and without error code in case of http urls.

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 available, 0 if not reachable

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

Returns:

last modified timestamp of the given url

getURLInfo

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

Description copied from interface: URLHandler

Returns the URLInfo of the given url or a URLHandler.UNAVAILABLE instance, if the url is not reachable.

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 when the url is not available.

getURLInfo

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

Description copied from interface: URLHandler

never returns null, return UNAVAILABLE when url is not reachable

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 available.

openStream

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

Specified by:

openStream in interface URLHandler

Throws:

java.io.IOException

download

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

Specified by:

download in interface URLHandler

Throws:

java.io.IOException

upload

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

Specified by:

upload in interface URLHandler

Throws:

java.io.IOException

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)