Package org.apache.ivy.util.url

Interface URLHandler

All Known Subinterfaces:

TimeoutConstrainedURLHandler

All Known Implementing Classes:

AbstractURLHandler, BasicURLHandler, HttpClientHandler, URLHandlerDispatcher

@Deprecated
public interface URLHandler

Deprecated.

Starting 2.5.0, the TimeoutConstrainedURLHandler is preferred in favour of this interface

This interface is responsible for handling some URL manipulation (stream opening, downloading, check reachability, ...).

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	URLHandler.URLInfo	Deprecated.

Field Summary

Fields

Modifier and Type	Field	Description
static int	REQUEST_METHOD_GET	Deprecated. Using the slower REQUEST method for getting the basic URL infos.
static int	REQUEST_METHOD_HEAD	Deprecated. Using the faster HEAD method for getting the basic URL infos.
static URLHandler.URLInfo	UNAVAILABLE	Deprecated.

Method Summary

Modifier and Type	Method	Description
void	download(java.net.URL src, java.io.File dest, CopyProgressListener l)	Deprecated.
long	getContentLength(java.net.URL url)	Deprecated. Please prefer getURLInfo when several infos are needed.
long	getContentLength(java.net.URL url, int timeout)	Deprecated.
long	getLastModified(java.net.URL url)	Deprecated. Please prefer getURLInfo when several infos are needed.
long	getLastModified(java.net.URL url, int timeout)	Deprecated. Please prefer getURLInfo when several infos are needed.
URLHandler.URLInfo	getURLInfo(java.net.URL url)	Deprecated.
URLHandler.URLInfo	getURLInfo(java.net.URL url, int timeout)	Deprecated.
boolean	isReachable(java.net.URL url)	Deprecated. Please prefer getURLInfo when several infos are needed.
boolean	isReachable(java.net.URL url, int timeout)	Deprecated. Please prefer getURLInfo when several infos are needed.
java.io.InputStream	openStream(java.net.URL url)	Deprecated.
void	setRequestMethod(int requestMethod)	Deprecated.
void	upload(java.io.File src, java.net.URL dest, CopyProgressListener l)	Deprecated.

Field Detail

REQUEST_METHOD_GET

static final int REQUEST_METHOD_GET

Deprecated.

Using the slower REQUEST method for getting the basic URL infos. Use this when getting errors behind a problematic/special proxy or firewall chain.

See Also:

Constant Field Values

REQUEST_METHOD_HEAD

static final int REQUEST_METHOD_HEAD

Deprecated.

Using the faster HEAD method for getting the basic URL infos. Works for most common networks.

See Also:

Constant Field Values

UNAVAILABLE

static final URLHandler.URLInfo UNAVAILABLE

Deprecated.

Method Detail

isReachable

boolean isReachable(java.net.URL url)

Deprecated.

Please prefer getURLInfo when several infos are needed.

Parameters:

url - the url to check

Returns:

true if the target is reachable

isReachable

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

Deprecated.

Please prefer getURLInfo when several infos are needed.

Parameters:

url - the url to check

timeout - the timeout in milliseconds

Returns:

true if the target is reachable

getContentLength

long getContentLength(java.net.URL url)

Deprecated.

Please prefer getURLInfo when several infos are needed.

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

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

Deprecated.

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.

getLastModified

long getLastModified(java.net.URL url)

Deprecated.

Please prefer getURLInfo when several infos are needed.

Parameters:

url - the url to check

Returns:

last modified timestamp of the given url

getLastModified

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

Deprecated.

Please prefer getURLInfo when several infos are needed.

Parameters:

url - the url to check

timeout - the timeout in milliseconds

Returns:

last modified timestamp of the given url

getURLInfo

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

Deprecated.

Parameters:

url - The url from which information is retrieved.

Returns:

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

getURLInfo

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

Deprecated.

Parameters:

url - The url from which information is retrieved.

timeout - The timeout in milliseconds.

Returns:

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

openStream

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

Deprecated.

Parameters:

url - ditto

Returns:

InputStream

Throws:

java.io.IOException - if something goes wrong

download

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

Deprecated.

Parameters:

src - URL

dest - File

l - CopyProgressListener

Throws:

java.io.IOException - if something goes wrong

upload

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

Deprecated.

Parameters:

src - File

dest - URL

l - CopyProgressListener

Throws:

java.io.IOException - if something goes wrong

setRequestMethod

void setRequestMethod(int requestMethod)

Deprecated.