Package org.ametys.core.util

Class HttpUrlUtils

java.lang.Object

org.ametys.core.util.HttpUrlUtils

All Implemented Interfaces:

Component

public class HttpUrlUtils
extends Object
implements Component

Utility class for HTTP urls.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	HttpUrlUtils.HttpCheck	The status of HTTP check
static final record	HttpUrlUtils.HttpCheckReport	Represent the result of a check and a potential message

Field Summary

Fields

Modifier and Type	Field	Description
static final int	HTTP_REDIRECT_PERM	HTTP Status-Code 308: Temporay Redirect
static final int	HTTP_REDIRECT_TEMP	HTTP Status-Code 307: Temporay Redirect
static final Pattern	HTTP_URL_VALIDATOR	Regexp for HTTP url
static final String	ROLE	The Avalon role

Constructor Summary

Constructors

Constructor	Description
HttpUrlUtils()

Method Summary

Modifier and Type	Method	Description
Map<String,Object>	checkHttpUrl(String httpUrl)	Method to check a HTTP url from client side.
static HttpUrlUtils.HttpCheckReport	checkHttpUrl(String httpUrl, String userAgent, String method, int timeout, int readTimeOut, boolean followRedirects)	Check the HTTP url
static HttpUrlUtils.HttpCheckReport	checkHttpUrl(String httpUrl, String userAgent, String method, int timeout, int readTimeOut, boolean followRedirects, Map<String,String> requestHeaders)	Check the HTTP url
static HttpUrlUtils.HttpCheckReport	checkHttpUrl(URL url, String userAgent, String method, int timeout, int readTimeOut, boolean followRedirects, Map<String,String> requestHeaders)	Check the HTTP url
static HttpURLConnection	prepareConnection(String url, String userAgent, String method, int timeout, int readTimeOut, boolean followRedirects)	Prepare the connection to the remote url
static HttpURLConnection	prepareConnection(String httpUrl, String userAgent, String method, int timeout, int readTimeOut, boolean followRedirects, Map<String,String> requestHeaders)	Prepare the connection to the remote url
static HttpURLConnection	prepareConnection(URL url, String userAgent, String method, int timeout, int readTimeOut, boolean followRedirects, Map<String,String> requestHeaders)	Prepare the connection to the remote url

Methods inherited from class java.lang.Object

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

Field Details

ROLE

public static final String ROLE

The Avalon role

HTTP_URL_VALIDATOR

public static final Pattern HTTP_URL_VALIDATOR

Regexp for HTTP url

HTTP_REDIRECT_TEMP

public static final int HTTP_REDIRECT_TEMP

HTTP Status-Code 307: Temporay Redirect

See Also:

• Constant Field Values

HTTP_REDIRECT_PERM

public static final int HTTP_REDIRECT_PERM

HTTP Status-Code 308: Temporay Redirect

See Also:

• Constant Field Values

Constructor Details

HttpUrlUtils

public HttpUrlUtils()

Method Details

prepareConnection

public static HttpURLConnection prepareConnection(String url,
 String userAgent,
 String method,
 int timeout,
 int readTimeOut,
 boolean followRedirects)
                                           throws MalformedURLException,
IOException

Prepare the connection to the remote url

Parameters:

url - The url

userAgent - The user agent. Can be null.

method - The method for teh URL request. Can be null.

timeout - The connection timeout in milliseconds. Set to -1 to not set a timeout.

readTimeOut - The read timeout in milliseconds. Set to -1 to not set a timeout.

followRedirects - Sets to true to follow HTTP redirects

Returns:

The URL connection

Throws:

MalformedURLException - If the given url is a malformed URL

IOException - if an I/O exception occurs

prepareConnection

public static HttpURLConnection prepareConnection(String httpUrl,
 String userAgent,
 String method,
 int timeout,
 int readTimeOut,
 boolean followRedirects,
 Map<String,String> requestHeaders)
                                           throws MalformedURLException,
IOException

Prepare the connection to the remote url

Parameters:

httpUrl - The HTTP url

userAgent - The user agent. Can be null.

method - The method for teh URL request. Can be null.

timeout - The connection timeout in milliseconds. Set to -1 to not set a timeout.

readTimeOut - The read timeout in milliseconds. Set to -1 to not set a timeout.

followRedirects - Sets to true to follow HTTP redirects

requestHeaders - The request headers.

Returns:

The URL connection

Throws:

MalformedURLException - If the given url is a malformed URL

IOException - if an I/O exception occurs

prepareConnection

public static HttpURLConnection prepareConnection(URL url,
 String userAgent,
 String method,
 int timeout,
 int readTimeOut,
 boolean followRedirects,
 Map<String,String> requestHeaders)
                                           throws MalformedURLException,
IOException

Prepare the connection to the remote url

Parameters:

url - The url

userAgent - The user agent. Can be null.

method - The method for teh URL request. Can be null.

timeout - The connection timeout in milliseconds. Set to -1 to not set a timeout.

readTimeOut - The read timeout in milliseconds. Set to -1 to not set a timeout.

followRedirects - Sets to true to follow HTTP redirects

requestHeaders - The request headers.

Returns:

The URL connection

Throws:

MalformedURLException - If the given url is a malformed URL

IOException - if an I/O exception occurs

checkHttpUrl

public static HttpUrlUtils.HttpCheckReport checkHttpUrl(String httpUrl,
 String userAgent,
 String method,
 int timeout,
 int readTimeOut,
 boolean followRedirects)

Check the HTTP url

Parameters:

httpUrl - The HTTP url to test

userAgent - The user agent. Can be null.

method - The method for teh URL request. Can be null.

timeout - The connection timeout in milliseconds. Set to -1 to not set a timeout.

readTimeOut - The read timeout in milliseconds. Set to -1 to not set a timeout.

followRedirects - Sets to true to follow HTTP redirects

Returns:

The URL connection

checkHttpUrl

public static HttpUrlUtils.HttpCheckReport checkHttpUrl(String httpUrl,
 String userAgent,
 String method,
 int timeout,
 int readTimeOut,
 boolean followRedirects,
 Map<String,String> requestHeaders)

Check the HTTP url

Parameters:

httpUrl - The url to test

userAgent - The user agent. Can be null.

method - The method for teh URL request. Can be null.

timeout - The connection timeout in milliseconds. Set to -1 to not set a timeout.

readTimeOut - The read timeout in milliseconds. Set to -1 to not set a timeout.

followRedirects - Sets to true to follow HTTP redirects

requestHeaders - The request headers.

Returns:

The URL connection

checkHttpUrl

public static HttpUrlUtils.HttpCheckReport checkHttpUrl(URL url,
 String userAgent,
 String method,
 int timeout,
 int readTimeOut,
 boolean followRedirects,
 Map<String,String> requestHeaders)

Check the HTTP url

Parameters:

url - The url to test

userAgent - The user agent. Can be null.

method - The method for teh URL request. Can be null.

timeout - The connection timeout in milliseconds. Set to -1 to not set a timeout.

readTimeOut - The read timeout in milliseconds. Set to -1 to not set a timeout.

followRedirects - Sets to true to follow HTTP redirects

requestHeaders - The request headers.

Returns:

The URL connection

checkHttpUrl

public Map<String,Object> checkHttpUrl(String httpUrl)

Method to check a HTTP url from client side. The HTTP redirects will be followed.

Parameters:

httpUrl - the http url to check

Returns:

the result of the check