com.alee.utils

Class WebUtils

java.lang.Object

com.alee.utils.WebUtils

public final class WebUtils
extends Object

This class provides a set of utilities to work with URLs and email addresses.

Author:

Mikle Garin

Method Summary

Modifier and Type	Method and Description
static void	browseSite(String address) Opens site in default system web-browser
static void	browseSiteSafely(String address) Opens site in default system web-browser safely
static String	decodeUrl(String url) Returns decoded url path.
static String	encodeUrl(String url) Returns encoded url path.
static Map<String,List<String>>	getUrlParameters(String url) Returns url query parameters.
static String	normalizeUrl(String url) Returns normalized url path.
static void	openFile(File file) Opens file in appropriate system application
static void	openFileSafely(File file) Opens file in appropriate system application safely
static void	shareOnFb(String address) Opens system default web-browser with Facebook share page.
static void	shareOnTwitter(String address) Opens system default web-browser with Twitter share page.
static void	shareOnVk(String address) Opens system default web-browser with VKontakte share page.
static void	writeEmail(String email) Opens system mail agent to compose a new letter
static void	writeEmail(String email, String subject, String body) Opens system mail agent to compose a new letter
static void	writeEmailSafely(String email) Opens system mail agent to compose a new letter safely
static void	writeEmailSafely(String email, String subject, String body) Opens system mail agent to compose a new letter safely

Methods inherited from class java.lang.Object

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

Method Detail

normalizeUrl

@NotNull
public static String normalizeUrl(@NotNull
                                           String url)

Returns normalized url path.

Parameters:

url - the url to normalize

Returns:

normalized url

getUrlParameters

@NotNull
public static Map<String,List<String>> getUrlParameters(@NotNull
                                                                 String url)

Returns url query parameters.

Parameters:

url - the url to parse

Returns:

parameters map

encodeUrl

@NotNull
public static String encodeUrl(@NotNull
                                        String url)

Returns encoded url path.

Parameters:

url - the url to encode

Returns:

encoded url

decodeUrl

@NotNull
public static String decodeUrl(@NotNull
                                        String url)

Returns decoded url path.

Parameters:

url - the url to decode

Returns:

decoded url

browseSite

public static void browseSite(@NotNull
                              String address)
                       throws URISyntaxException,
                              IOException

Opens site in default system web-browser

Parameters:

address - the address to open

Throws:

URISyntaxException - if URI cannot be created for the given address

IOException - if browser application is not found or fails to launch

browseSiteSafely

public static void browseSiteSafely(@NotNull
                                    String address)

Opens site in default system web-browser safely

Parameters:

address - the address to open

shareOnTwitter

public static void shareOnTwitter(@NotNull
                                  String address)

Opens system default web-browser with Twitter share page.

Parameters:

address - the address to share

shareOnVk

public static void shareOnVk(@NotNull
                             String address)

Opens system default web-browser with VKontakte share page.

Parameters:

address - the address to share

shareOnFb

public static void shareOnFb(@NotNull
                             String address)

Opens system default web-browser with Facebook share page.

Parameters:

address - the address to share

openFile

public static void openFile(@NotNull
                            File file)
                     throws IOException

Opens file in appropriate system application

Parameters:

file - the file to open

Throws:

IOException - if the specified file has no associated application or the associated application fails to be launched

openFileSafely

public static void openFileSafely(@NotNull
                                  File file)

Opens file in appropriate system application safely

Parameters:

file - the file to open

writeEmail

public static void writeEmail(@NotNull
                              String email)
                       throws URISyntaxException,
                              IOException

Opens system mail agent to compose a new letter

Parameters:

email - the destination email address

Throws:

URISyntaxException - if mailing URI cannot be created

IOException - if used mail client cannot be found

writeEmail

public static void writeEmail(@NotNull
                              String email,
                              @Nullable
                              String subject,
                              @Nullable
                              String body)
                       throws URISyntaxException,
                              IOException

Opens system mail agent to compose a new letter

Parameters:

email - the destination email address

subject - letter subject

body - letter text

Throws:

URISyntaxException - if mailing URI cannot be created

IOException - if used mail client cannot be found

writeEmailSafely

public static void writeEmailSafely(@NotNull
                                    String email)

Opens system mail agent to compose a new letter safely

Parameters:

email - the destination email address

writeEmailSafely

public static void writeEmailSafely(@NotNull
                                    String email,
                                    @Nullable
                                    String subject,
                                    @Nullable
                                    String body)

Opens system mail agent to compose a new letter safely

Parameters:

email - the destination email address

subject - letter subject

body - letter text