org.opennms.web
Class Util

java.lang.Object
  org.opennms.web.Util

public abstract class Util
extends Object

Provides convenience functions for web-based interfaces.

Since:

1.8.1

Version:

$Id: $

Author:

Lawrence Karnowski , OpenNMS , Lawrence Karnowski , OpenNMS

Constructor Summary

Util()

Method Summary

static String	calculateUrlBase(javax.servlet.http.HttpServletRequest request) Return a string that represents the fully qualified URL for our servlet context, suitable for use in the HTML base tag.
static String	convertToJsSafeString(String str) convertToJsSafeString
static EventProxy	createEventProxy() createEventProxy
static String	decode(String string) Encapsulate the deprecated decode method to fix it in one place.
static String	encode(String string) Encapsulate the deprecated encode method to fix it in one place.
static String	formatDateToUIString(Date date) An utility method to format a 'Date' into a string in the local specific DEFALUT DateFormat style for both the date and time.
static String	getHostHeader(javax.servlet.http.HttpServletRequest request) Obtains the host and port used by the end user.
static String	getHostname(String ipAddress, javax.servlet.ServletContext servletContext) Deprecated. Please use NetworkElementFactory.getHostname instead.
static Map<String,String>	getOrderedMap(String[][] names) getOrderedMap
static String	htmlify(String input) htmlify
static String	makeHiddenTags(javax.servlet.http.HttpServletRequest request) Creates hidden tags for all the parameters given in the request.
static String	makeHiddenTags(javax.servlet.http.HttpServletRequest request, Map additions) Creates hidden tags for all the parameters given in the request.
static String	makeHiddenTags(javax.servlet.http.HttpServletRequest request, Map additions, String[] ignores) Creates hidden tags for all the parameters given in the request plus the additions, except for the parameters and additions listed in the ignore list.
static String	makeHiddenTags(javax.servlet.http.HttpServletRequest request, Map additions, String[] ignores, Util.IgnoreType ignoreType) Creates hidden tags for all the parameters given in the request plus the additions, except for the parmeters listed in the ignore list.
static String	makeHiddenTags(javax.servlet.http.HttpServletRequest request, String[] ignores) Creates hidden tags for all the parameters given in the request.
static String	makeQueryString(javax.servlet.http.HttpServletRequest request) Creates a query string of the format "key1=value1&key2=value2" for each parameter in the given HttpServletRequest.
static String	makeQueryString(javax.servlet.http.HttpServletRequest request, Map additions) Creates a query string of the format "key1=value1&key2=value2" for each parameter in the given HttpServletRequest and key in given Map.
static String	makeQueryString(javax.servlet.http.HttpServletRequest request, Map additions, String[] ignores) Creates a query string of the format "key1=value1&key2=value2" for each parameter in the given HttpServletRequest and key in given Map that is not listed in the ignore list.
static String	makeQueryString(javax.servlet.http.HttpServletRequest request, Map additions, String[] ignores, Util.IgnoreType ignoreType) Creates a query string of the format "key1=value1&key2=value2" for each parameter in the given HttpServletRequest and key in given Map that is not listed in the ignore list.
static String	makeQueryString(javax.servlet.http.HttpServletRequest request, String[] ignores) Creates a query string of the format "key1=value1&key2=value2" for each parameter in the given HttpServletRequest that is not listed in the ignore list.
static String	resolveIpAddress(String ipAddress, javax.servlet.ServletContext servletContext) Deprecated. Please use NetworkElementFactory.getHostname instead.

Methods inherited from class java.lang.Object

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

Constructor Detail

Util

public Util()

Method Detail

calculateUrlBase

public static String calculateUrlBase(javax.servlet.http.HttpServletRequest request)

Return a string that represents the fully qualified URL for our servlet context, suitable for use in the HTML base tag.

As an example, suppose your host was www.mycompany.com, you are serving from port 80, and your web application name was "opennms," then this method would return: http://www.mycompany.com:80/opennms/

If this guess is wrong, you can override it by setting the property opennms.web.base-url in opennms.properties (for embedded Jetty) or WEB-INF/configuration.properties (for Tomcat).

Parameters:

request - the servlet request you are servicing

Returns:

a String object.

getHostHeader

public static String getHostHeader(javax.servlet.http.HttpServletRequest request)

Obtains the host and port used by the end user.

Parameters:

request - a HttpServletRequest object.

Returns:

a String object.

getHostname

public static String getHostname(String ipAddress,
                                 javax.servlet.ServletContext servletContext)

Deprecated. Please use NetworkElementFactory.getHostname instead.

Convenience method for resolving the human-readable hostname for an IP address, if at all possible. If the hostname cannot be found, this method returns the IP address parameter.

Parameters:

ipAddress - the IP address for which you want the hostname

Returns:

a String object.

encode

public static String encode(String string)

Encapsulate the deprecated encode method to fix it in one place.

Parameters:

string - string to be encoded

Returns:

encoded string

decode

public static String decode(String string)

Encapsulate the deprecated decode method to fix it in one place.

Parameters:

string - string to be decoded

Returns:

decoded string

resolveIpAddress

public static String resolveIpAddress(String ipAddress,
                                      javax.servlet.ServletContext servletContext)

Deprecated. Please use NetworkElementFactory.getHostname instead.

Convenience method for resolving the human-readable hostname for an IP address, if at all possible. If the hostname cannot be found, from the table, this method returns the IP address parameter. This method doesnt throw any exception.

Parameters:

ipAddress - the IP address for which you want the hostname

Returns:

a String object.

makeHiddenTags

public static String makeHiddenTags(javax.servlet.http.HttpServletRequest request)

Creates hidden tags for all the parameters given in the request.

Parameters:

request - the HttpServletRequest to read the parameters from

Returns:

A string containing an HTML <input type="hidden" name=" paramName" value=" paramValue" /> tag for each parameter.

makeHiddenTags

public static String makeHiddenTags(javax.servlet.http.HttpServletRequest request,
                                    Map additions)

Creates hidden tags for all the parameters given in the request.

Parameters:

request - the HttpServletRequest to read the parameters from

additions - a map of extra parameters to create hidden tags for

Returns:

A string containing an HTML <input type="hidden" name=" paramName" value=" paramValue" /> tag for each parameter.

makeHiddenTags

public static String makeHiddenTags(javax.servlet.http.HttpServletRequest request,
                                    String[] ignores)

Creates hidden tags for all the parameters given in the request.

Parameters:

request - the HttpServletRequest to read the parameters from

ignores - A string array containing request parameters to ignore

Returns:

A string containing an HTML <input type="hidden" name=" paramName" value=" paramValue" /> tag for each parameter.

makeHiddenTags

public static String makeHiddenTags(javax.servlet.http.HttpServletRequest request,
                                    Map additions,
                                    String[] ignores)

Creates hidden tags for all the parameters given in the request plus the additions, except for the parameters and additions listed in the ignore list.

Parameters:

request - the HttpServletRequest to read the parameters from

additions - a map of extra parameters to create hidden tags for

ignores - the list of parameters not to create a hidden tag for

Returns:

A string containing an HTML <input type="hidden" name=" paramName" value=" paramValue" /> tag for each parameter not in the ignore list.

makeHiddenTags

public static String makeHiddenTags(javax.servlet.http.HttpServletRequest request,
                                    Map additions,
                                    String[] ignores,
                                    Util.IgnoreType ignoreType)

Creates hidden tags for all the parameters given in the request plus the additions, except for the parmeters listed in the ignore list.

Parameters:

request - the HttpServletRequest to read the parameters from

additions - a map of extra parameters to create hidden tags for

ignores - the list of parameters not to create a hidden tag for

ignoreType - whether the ignore list applies to the request parameters, values in the additions map, or both

Returns:

A string containing an HTML <input type="hidden" name=" paramName" value=" paramValue" /> tag for each parameter not in the ignore list.

makeQueryString

public static String makeQueryString(javax.servlet.http.HttpServletRequest request)

Creates a query string of the format "key1=value1&key2=value2" for each parameter in the given HttpServletRequest.

Parameters:

request - a HttpServletRequest object.

Returns:

a String object.

See Also:

makeQueryString( HttpServletRequest, Map, String[] )

makeQueryString

public static String makeQueryString(javax.servlet.http.HttpServletRequest request,
                                     Map additions)

Creates a query string of the format "key1=value1&key2=value2" for each parameter in the given HttpServletRequest and key in given Map.

Parameters:

request - a HttpServletRequest object.

additions - a Map object.

Returns:

a String object.

See Also:

makeQueryString( HttpServletRequest, Map, String[] )

makeQueryString

public static String makeQueryString(javax.servlet.http.HttpServletRequest request,
                                     String[] ignores)

Creates a query string of the format "key1=value1&key2=value2" for each parameter in the given HttpServletRequest that is not listed in the ignore list.

Parameters:

request - a HttpServletRequest object.

ignores - an array of String objects.

Returns:

a String object.

See Also:

makeQueryString( HttpServletRequest, Map, String[] )

makeQueryString

public static String makeQueryString(javax.servlet.http.HttpServletRequest request,
                                     Map additions,
                                     String[] ignores)

Creates a query string of the format "key1=value1&key2=value2" for each parameter in the given HttpServletRequest and key in given Map that is not listed in the ignore list.

Parameters:

request - the HttpServletRequest to read the parameters from

additions - a mapping of strings to strings or string arrays to be included in the query string

ignores - the list of parameters and map entries not to include

Returns:

A string in the x-www-form-urlencoded format that is suitable for adding to a URL as a query string.

makeQueryString

public static String makeQueryString(javax.servlet.http.HttpServletRequest request,
                                     Map additions,
                                     String[] ignores,
                                     Util.IgnoreType ignoreType)

Creates a query string of the format "key1=value1&key2=value2" for each parameter in the given HttpServletRequest and key in given Map that is not listed in the ignore list.

Parameters:

request - the HttpServletRequest to read the parameters from

additions - a mapping of strings to strings or string arrays to be included in the query string

ignores - the list of parameters and map entries not to include

ignoreType - a Util.IgnoreType object.

Returns:

A string in the x-www-form-urlencoded format that is suitable for adding to a URL as a query string.

getOrderedMap

public static Map<String,String> getOrderedMap(String[][] names)

getOrderedMap

Parameters:

names - an array of String objects.

Returns:

a Map object.

htmlify

public static String htmlify(String input)

htmlify

Parameters:

input - a String object.

Returns:

a String object.

createEventProxy

public static EventProxy createEventProxy()

createEventProxy

Returns:

a EventProxy object.

formatDateToUIString

public static final String formatDateToUIString(Date date)

An utility method to format a 'Date' into a string in the local specific DEFALUT DateFormat style for both the date and time. This is used by the webui and a change here should get all time display in the webui changed.

Parameters:

date - a Date object.

Returns:

a String object.

See Also:

DateFormat

convertToJsSafeString

public static String convertToJsSafeString(String str)

convertToJsSafeString

Parameters:

str - a String object.

Returns:

a String object.