Class UrlUtil

java.lang.Object

com.itextpdf.io.util.UrlUtil

public final class UrlUtil
extends Object

This file is a helper class for internal usage only. Be aware that its API and functionality may be changed in future.

Field Summary

Fields

Modifier and Type	Field	Description
private static final int	DEFAULT_CONNECT_TIMEOUT
private static final int	DEFAULT_READ_TIMEOUT

Constructor Summary

Constructors

Modifier	Constructor	Description
private	UrlUtil()

Method Summary

Modifier and Type	Method	Description
static String	getFileUriString(String filename)	This method gets uri string from a file.
(package private) static URLConnection	getFinalConnection(URL initialUrl, int connectTimeout, int readTimeout)	Gets the connection related to the last redirected url.
static InputStream	getInputStreamOfFinalConnection(URL initialUrl)	Gets the input stream of connection related to last redirected url.
static InputStream	getInputStreamOfFinalConnection(URL initialUrl, int connectTimeout, int readTimeout)	Gets the input stream of connection related to last redirected url.
static String	getNormalizedFileUriString(String filename)	This method gets normalized uri string from a file.
static InputStream	openStream(URL url)
static String	toAbsoluteURI(URI uri)	Get the entire URI string which is properly encoded.
static URI	toNormalizedURI(File file)	This method makes a normalized URI from a given file.
static URI	toNormalizedURI(String filename)	This method makes a normalized URI from a given filename.
static URL	toURL(String filename)	This method makes a valid URL from a given filename.

Methods inherited from class Object

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

Field Details

DEFAULT_CONNECT_TIMEOUT

private static final int DEFAULT_CONNECT_TIMEOUT

See Also:

• Constant Field Values

DEFAULT_READ_TIMEOUT

private static final int DEFAULT_READ_TIMEOUT

See Also:

• Constant Field Values

Constructor Details

UrlUtil

private UrlUtil()

Method Details

toURL

public static URL toURL(String filename)
                 throws MalformedURLException

This method makes a valid URL from a given filename.

This method makes the conversion of this library from the JAVA 2 platform to a JDK1.1.x-version easier.

Parameters:

filename - a given filename

Returns:

a valid URL

Throws:

MalformedURLException - If a protocol handler for the URL could not be found, or if some other error occurred while constructing the URL

toNormalizedURI

public static URI toNormalizedURI(String filename)

This method makes a normalized URI from a given filename.

Parameters:

filename - a given filename

Returns:

a valid URI

toNormalizedURI

public static URI toNormalizedURI(File file)

This method makes a normalized URI from a given file.

Parameters:

file - a given filename

Returns:

a valid URI

toAbsoluteURI

public static String toAbsoluteURI(URI uri)

Get the entire URI string which is properly encoded.

Parameters:

uri - URI which convert to string

Returns:

URI string representation

openStream

public static InputStream openStream(URL url)
                              throws IOException

Throws:

IOException

getFileUriString

public static String getFileUriString(String filename)
                               throws MalformedURLException

This method gets uri string from a file.

Parameters:

filename - a given filename

Returns:

a uri string

Throws:

MalformedURLException - If a protocol handler for the URL could not be found, or if some other error occurred while constructing the URL

getNormalizedFileUriString

public static String getNormalizedFileUriString(String filename)

This method gets normalized uri string from a file.

Parameters:

filename - a given filename

Returns:

a normalized uri string

getInputStreamOfFinalConnection

public static InputStream getInputStreamOfFinalConnection(URL initialUrl)
                                                   throws IOException

Gets the input stream of connection related to last redirected url. You should manually close input stream after calling this method to not hold any open resources.

Parameters:

initialUrl - an initial URL.

Returns:

an input stream of connection related to the last redirected url.

Throws:

IOException - signals that an I/O exception has occurred.

getInputStreamOfFinalConnection

public static InputStream getInputStreamOfFinalConnection(URL initialUrl,
 int connectTimeout,
 int readTimeout)
                                                   throws IOException

Gets the input stream of connection related to last redirected url. You should manually close input stream after calling this method to not hold any open resources.

Parameters:

initialUrl - an initial URL.

connectTimeout - a connect timeout in milliseconds.

readTimeout - a read timeout in milliseconds.

Returns:

an input stream of connection related to the last redirected url.

Throws:

IOException - signals that an I/O exception has occurred.

getFinalConnection

static URLConnection getFinalConnection(URL initialUrl,
 int connectTimeout,
 int readTimeout)
                                 throws IOException

Gets the connection related to the last redirected url. You should close connection manually after calling this method, to not hold any open resources.

Parameters:

initialUrl - an initial URL.

connectTimeout - a connect timeout in milliseconds.

readTimeout - a read timeout in milliseconds.

Returns:

connection related to the last redirected url.

Throws:

IOException - signals that an I/O exception has occurred.