org.mdiutil.io

Class FileUtilities2

java.lang.Object

org.mdiutil.io.FileUtilities2

public class FileUtilities2
extends Object

Various File utilities to deal with HTTP URLs.

Method Summary

Modifier and Type	Method and Description
static String	getHTTPContentAsText(URL url) Return the URL content as a String.
static String	getHTTPContentAsText(URL url, int timeout) Return the URL content as a String.
static String	getHTTPContentAsText(URL url, int timeout, boolean followRedirects) Return the URL content as a String.
static String	getHTTPContentAsText(URL url, Proxy proxy, String userAgent) Return the URL content as a String, without a timeout.
static String	getHTTPContentAsText(URL url, Proxy proxy, String userAgent, boolean followRedirects) Return the URL content as a String, without a timeout.
static String	getHTTPContentAsText(URL url, Proxy proxy, String userAgent, int timeout) Return the URL content as a String.
static String	getHTTPContentAsText(URL url, Proxy proxy, String userAgent, int timeout, boolean followRedirects) Return the URL content as a StringNote that this method will return null for a local URL Depending on the followRedirects argument, the method is able to deal with HTTP redirections (codes 301, 302, and 303) This method will return null for a local URL The complete list of http return codes can be found on wikipedia here: List_of_HTTP_status_codes.
static long	getLength(URL url) Return the length of a URL.
static long	getLength(URL url, Proxy proxy) Return the length of a URL, accessed overa Proxy.

Methods inherited from class java.lang.Object

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

Method Detail

getHTTPContentAsText

public static String getHTTPContentAsText(URL url)

Return the URL content as a String. Note that:

• The method is able to deal with HTTP redirections (codes 301, 302, and 303)
• This method will return null for a local URL

Parameters:

url - the URL

Returns:

the URL content as a String

getHTTPContentAsText

public static String getHTTPContentAsText(URL url,
                                          int timeout)

Return the URL content as a String.

• The method is able to deal with HTTP redirections (codes 301, 302, and 303)
• This method will return null for a local URL

Parameters:

url - the URL

timeout - the timeout in ms

Returns:

the URL content as a String

getHTTPContentAsText

public static String getHTTPContentAsText(URL url,
                                          int timeout,
                                          boolean followRedirects)

Return the URL content as a String.

• Depending on the followRedirects argument, the method is able to deal with HTTP redirections (codes 301, 302, and 303)
• This method will return null for a local URL

Parameters:

url - the URL

timeout - the timeout in ms

followRedirects - true to allow to follow redirects

Returns:

the URL content as a String

getHTTPContentAsText

public static String getHTTPContentAsText(URL url,
                                          Proxy proxy,
                                          String userAgent)

Return the URL content as a String, without a timeout. Note that this method will return null for a local URL.

• The method is able to deal with HTTP redirections (codes 301, 302, and 303)
• This method will return null for a local URL

The complete list of http return codes can be found on wikipedia here: List_of_HTTP_status_codes.

Use case

This class allow to use HTTP parser libraries such as JSoup without having to checking initially the validity of the URL connection, then doing this all over again with the library.

Parameters:

url - the URL

proxy - the proxy for http URLs (can be null, in that case no proxy will be used)

userAgent - the user agent. If the user agent is null, the FileUtilities.FIREFOX10_USERAGENT will be used by default

Returns:

the URL content as a String

getHTTPContentAsText

public static String getHTTPContentAsText(URL url,
                                          Proxy proxy,
                                          String userAgent,
                                          boolean followRedirects)

Return the URL content as a String, without a timeout. Note that this method will return null for a local URL.

• Depending on the followRedirects argument, the method is able to deal with HTTP redirections (codes 301, 302, and 303)
• This method will return null for a local URL

The complete list of http return codes can be found on wikipedia here: List_of_HTTP_status_codes.

Use case

This class allow to use HTTP parser libraries such as JSoup without having to checking initially the validity of the URL connection, then doing this all over again with the library.

Parameters:

url - the URL

proxy - the proxy for http URLs (can be null, in that case no proxy will be used)

userAgent - the user agent. If the user agent is null, the FileUtilities.FIREFOX10_USERAGENT will be used by default

followRedirects - true to allow to follow redirects

Returns:

the URL content as a String

getHTTPContentAsText

public static String getHTTPContentAsText(URL url,
                                          Proxy proxy,
                                          String userAgent,
                                          int timeout)

Return the URL content as a String. Note that this method will return null for a local URL.

• The method is able to deal with HTTP redirections (codes 301, 302, and 303)
• This method will return null for a local URL

The complete list of http return codes can be found on wikipedia here: List_of_HTTP_status_codes.

Use case

This class allow to use HTTP parser libraries such as JSoup without having to checking initially the validity of the URL connection, then doing this all over again with the library.

Parameters:

url - the URL

proxy - the proxy for http URLs (can be null, in that case no proxy will be used)

userAgent - the user agent. If the user agent is null, the FileUtilities.FIREFOX10_USERAGENT will be used by default

timeout - the timeout in ms (-1 for no timeOut)

Returns:

the URL content as a String

getHTTPContentAsText

public static String getHTTPContentAsText(URL url,
                                          Proxy proxy,
                                          String userAgent,
                                          int timeout,
                                          boolean followRedirects)

Return the URL content as a StringNote that this method will return null for a local URL

• Depending on the followRedirects argument, the method is able to deal with HTTP redirections (codes 301, 302, and 303)
• This method will return null for a local URL

The complete list of http return codes can be found on wikipedia here: List_of_HTTP_status_codes.

Use case

This class allow to use HTTP parser libraries such as JSoup without having to checking initially the validity of the URL connection, then doing this all over again with the library.

Parameters:

url - the URL

proxy - the proxy for http URLs (can be null, in that case no proxy will be used)

userAgent - the user agent. If the user agent is null, the FileUtilities.FIREFOX10_USERAGENT will be used by default

timeout - the timeout in ms (-1 for no timeOut)

followRedirects - true to allow to follow redirects

Returns:

the URL content as a String

getLength

public static long getLength(URL url,
                             Proxy proxy)
                      throws IOException

Return the length of a URL, accessed overa Proxy. Note that this method will work even if the URL is not a local file.

Parameters:

url - the URL

proxy - the proxy

Returns:

the URL length

Throws:

IOException

getLength

public static long getLength(URL url)
                      throws IOException

Return the length of a URL. Note that this method will work even if the URL is not a local file.

Parameters:

url - the URL

Returns:

the URL length

Throws:

IOException