de.ipcon.tools

Class URLTools

java.lang.Object

de.ipcon.tools.URLTools

public final class URLTools
extends java.lang.Object

Utility class for URL handling, desktop browser integration, remote downloading, and query parsing.

Method Summary

Modifier and Type	Method and Description
static boolean	browse(java.net.URI uri) Launches the default system handler for the given URI.
static boolean	browse(java.net.URL url) Opens the system default browser for the given URL.
static void	downloadUrlToFile(java.net.URL sourceUrl, java.io.File destination, int connectTimeoutMs, int readTimeoutMs) Downloads content from a remote URL directly to a destination file.
static javax.swing.event.HyperlinkListener	getHyperlinkListener() Returns a shared HyperlinkListener that opens activated links in the system default browser.
static boolean	openURL(java.net.URL url) Attempts to open the URL using desktop integration, falling back to registered content handlers.
static java.lang.String	readFromURL(java.lang.String url) Drains the resource content at the given URL into a String using UTF-8.
static java.lang.String	readFromURL(java.lang.String url, java.lang.String encoding) Drains the resource content at the given URL into a String using the specified encoding.
static java.util.Map<java.lang.String,java.lang.String>	splitQuery(java.net.URL url) Parses and URL-decodes query parameters into an insertion-ordered map.

Methods inherited from class java.lang.Object

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

Method Detail

getHyperlinkListener

public static javax.swing.event.HyperlinkListener getHyperlinkListener()

Returns a shared HyperlinkListener that opens activated links in the system default browser.

browse

public static boolean browse(java.net.URL url)

Opens the system default browser for the given URL.

Parameters:

url - the URL to browse

Returns:

true if successfully launched

browse

public static boolean browse(java.net.URI uri)

Launches the default system handler for the given URI.

Parameters:

uri - the URI to browse

Returns:

true if successfully dispatched

openURL

public static boolean openURL(java.net.URL url)

Attempts to open the URL using desktop integration, falling back to registered content handlers.

Parameters:

url - the target URL

Returns:

true if opened successfully

splitQuery

public static java.util.Map<java.lang.String,java.lang.String> splitQuery(java.net.URL url)

Parses and URL-decodes query parameters into an insertion-ordered map.

Parameters without values (e.g. ?flag) map to an empty string.

Parameters:

url - URL to extract parameters from

Returns:

map of decoded query key-value pairs; empty map if no query is present

Throws:

MissingArgumentException - if url is null

readFromURL

public static java.lang.String readFromURL(java.lang.String url)
                                    throws java.net.MalformedURLException,
                                           java.io.IOException

Drains the resource content at the given URL into a String using UTF-8.

Throws:

java.net.MalformedURLException

java.io.IOException

readFromURL

public static java.lang.String readFromURL(java.lang.String url,
                                           java.lang.String encoding)
                                    throws java.net.MalformedURLException,
                                           java.io.IOException

Drains the resource content at the given URL into a String using the specified encoding.

Parameters:

url - endpoint URL string

encoding - character encoding name

Returns:

remote document payload as String

Throws:

MissingArgumentException - if url or encoding is null

java.net.MalformedURLException - if the endpoint string is invalid

java.io.IOException - on transmission failure

downloadUrlToFile

public static void downloadUrlToFile(java.net.URL sourceUrl,
                                     java.io.File destination,
                                     int connectTimeoutMs,
                                     int readTimeoutMs)
                              throws java.io.IOException

Downloads content from a remote URL directly to a destination file.

Parameters:

sourceUrl - the HTTP/HTTPS endpoint to retrieve

destination - the target file on disk

connectTimeoutMs - connection timeout in milliseconds

readTimeoutMs - read timeout in milliseconds

Throws:

MissingArgumentException - if sourceUrl or destination is null

java.io.IOException - if network transmission fails

IRuntimeException - wrapping file I/O or storage synchronization failures