de.ipcon.tools

Class URLTools

java.lang.Object

de.ipcon.tools.URLTools

All Implemented Interfaces:

java.util.EventListener, javax.swing.event.HyperlinkListener

public class URLTools
extends java.lang.Object
implements javax.swing.event.HyperlinkListener

Method Summary

Modifier and Type	Method and Description
static boolean	browse(java.net.URI uri) Throws the given URI at the OS and returns the result.
static boolean	browse(java.net.URL url) Opens the default browser with the given URL (if supported)
static javax.swing.event.HyperlinkListener	getHyperlinkListener()
void	hyperlinkUpdate(javax.swing.event.HyperlinkEvent he)
static boolean	openURL(java.net.URL url) Tries to open the given _url trying various methods.
static java.lang.String	readFromURL(java.lang.String url) Opens a connection to a given url and returns the resource content as a string.
static java.lang.String	readFromURL(java.lang.String url, java.lang.String encoding)
static java.util.Map	splitQuery(java.net.URL url) Parses and decodes the query-parameters from a given URL and returns them in a map e.g.

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()

hyperlinkUpdate

public void hyperlinkUpdate(javax.swing.event.HyperlinkEvent he)

Specified by:

hyperlinkUpdate in interface javax.swing.event.HyperlinkListener

browse

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

Opens the default browser with the given URL (if supported)

Parameters:

url - The URL to browse to

Returns:

true if the passed URL could successfully be browsed to

browse

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

Throws the given URI at the OS and returns the result.

Returns:

true if uri could be opened, false otherwise

openURL

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

Tries to open the given _url trying various methods.

Returns:

true if _url could be opened, false otherwise

splitQuery

public static java.util.Map splitQuery(java.net.URL url)

Parses and decodes the query-parameters from a given URL and returns them in a map e.g. "https://maps.google.de/maps?ll = 49.753337, 6.638103&spn = 0.012366, 0.033023&sll = 51.151786, 10.415039&sspn = 12.306537, 33.815918&z = 16" will return ["ll":"49.753337, 6.638103", "spn":"0.012366, 0.033023", "sll":"51.151786, 10.415039", "sspn":"12.306537, 33.815918", "z":"16"]

readFromURL

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

Opens a connection to a given url and returns the resource content as a string. This might throw either a MalformedURLException or an IOException (as java.net.URL.openStream() is documented to do); the caller should handle these. If the resource is found but the scanner can't for some reason tokenize it (e. g. empty resource content), an empty string is returned.

Parameters:

url - the url to read.

encoding - the encoding to interpret the document't content as (default: "UTF-8")

Returns:

the document at url as a string.

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

Throws:

java.net.MalformedURLException

java.io.IOException