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, theTimeoutConstrainedURLHandler
is preferred in favour of this interfaceThis 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
All Methods Instance Methods Abstract Methods Deprecated Methods 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 checktimeout
- 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 checktimeout
- 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 checktimeout
- 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
- URLdest
- Filel
- 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
- Filedest
- URLl
- CopyProgressListener- Throws:
java.io.IOException
- if something goes wrong
-
setRequestMethod
void setRequestMethod(int requestMethod)
Deprecated.
-
-