com.atlassian.confluence.util
Class GeneralUtil

java.lang.Object
  com.atlassian.confluence.util.GeneralUtil

public final class GeneralUtil
extends java.lang.Object

Constructor Summary

GeneralUtil()

Method Summary

static java.lang.String	alwaysMaskEmail(java.lang.String emailAddress) Masks an email address by replacing '@' with 'at' and '.' with 'dot'.
static java.lang.String	appendAmpsandOrQuestionMark(java.lang.String str)
int	arraySize(int[] array) convenience method to allow us to determine the size of an int array a velocity file
static java.lang.String	base64Decode(java.lang.String s)
static java.lang.String	base64Encode(java.lang.String s)
static java.lang.String	checkPartnerDetails(com.atlassian.license.License license, java.lang.String buildPartnerName)
static java.lang.String	completeUrlEncode(java.lang.String url) A utility method to encode the given url for protocols which the CompleteURLEncoder supports.
static java.lang.String	constrainLength(java.lang.String s, int length) Truncate a string after n characters
static java.util.Map	convertBeanToMap(java.lang.Object bean)
static java.util.Date	convertMailFormatDate(java.lang.String date)
static java.lang.Boolean	convertToBoolean(java.lang.Object obj)
static boolean	convertToBoolean(java.lang.Object bool, boolean defaultValue)
static java.lang.Character	convertToCharacter(java.lang.Object obj)
static java.lang.Integer	convertToInteger(java.lang.Object obj)
static java.lang.String	convertToString(java.lang.Object obj)
static java.io.File	createTempDirectoryInConfluenceTemp(java.lang.String prefix)
static java.io.File	createTempFile(java.lang.String directory)
static java.lang.String	customGetPageUrl(AbstractPage page) Need a special case of generalutils getpageurl that appends ? or ampersand smartly this is used to prefix url parameters that are appended after this path like: showcomments=true#addcomment
static java.lang.String	displayShortUrl(java.lang.String url)
static java.lang.String	displayShortUrl(java.lang.String url, int length)
static java.lang.String	doubleUrlEncode(java.lang.String s)
static java.lang.String	escapeCDATA(java.lang.String s)
static java.util.List	escapeCommas(java.util.List toEscape) Escape commas on each entry in the given list of strings.
static java.lang.String	escapeCommas(java.lang.String toEscape) Escapes commas and backslashes with leading backslashes.
static java.lang.String	escapeForJavascript(java.lang.String s) Escapes ', " and \ with a leading \.
static java.lang.String	escapeXml(java.lang.String stringToEscape)
static java.lang.String	escapeXMLCharacters(java.lang.String input) Take a String which may contain <, > or & and return an XML string containing entities
static java.util.List	filterNulls(java.util.Collection in) Return a List with no null entries
static java.lang.String	findAndMaskEmail(java.lang.String text, com.atlassian.user.User currentUser)
static java.lang.String	format(java.util.Date date) Deprecated. since 2.3. Provided for pre-2.3 themes and layouts only. New themes and layouts should use $dateFormatter.format(Date) in the Velocity context or ConfluenceUserPreferences.getDateFormatter(FormatSettingsManager).
static java.lang.String	format(java.lang.Number number) TODO: Replace with a NumberFormatter, similar to DateFormatter
static java.lang.String	format(java.lang.Object obj)
static java.lang.String	format(java.lang.String str)
static java.lang.String	formatBlogDate(java.util.Date date) Deprecated. since 2.3. Provided for pre-2.3 themes and layouts only. New themes and layouts should use $dateFormatter.formatBlogDate(Date) in the Velocity context or ConfluenceUserPreferences.getDateFormatter(FormatSettingsManager).
static java.lang.String	formatDateFull(java.util.Date date)
static java.lang.String	formatDateTime(java.util.Date date) Deprecated. since 2.3. Provided for pre-2.3 themes and layouts only. New themes and layouts should use $dateFormatter.formatDateTime(Date) in the Velocity context or ConfluenceUserPreferences.getDateFormatter(FormatSettingsManager).
static java.lang.String	formatLongTime(long time)
static java.lang.String	formatTime(java.util.Date date) Deprecated. since 2.3. Provided for pre-2.3 themes and layouts only. New themes and layouts should use $dateFormatter.formatTime(Date) in the Velocity context or ConfluenceUserPreferences.getDateFormatter(FormatSettingsManager).
static java.util.Date	getBuildDate()
static java.lang.String	getBuildDateString()
static java.lang.String	getBuildExcludedLocale()
static java.lang.String	getBuildNumber()
static java.lang.String	getBuildPartner()
static java.lang.String	getCharacterEncoding()
static java.lang.String	getCompactDuration(long time) Returns the duration in a compact HH:mm:ss format.
static java.io.File	getConfluenceTempDirectory()
static java.lang.String	getConfluenceTempDirectoryPath() Checks if temp directory exists before returning the path.
static java.lang.String	getCookieValue(java.lang.String key)
static java.util.ResourceBundle	getDefaultResourceBundle()
static java.lang.String	getFormatDateSimple(java.util.Date date)
static Settings	getGlobalSettings()
static I18NBean	getI18n()
static java.lang.String	getIdBasedPageUrl(AbstractPage page) Get page URL that is id based (i.e.
static com.atlassian.core.util.ImageInfo	getImageInfo(java.io.File pathToImage)
static java.lang.String	getNiceDuration(int minutes, int seconds)
static java.lang.String	getPageUrl(AbstractPage page)
static java.lang.String	getPageUrl(VersionHistorySummary summary)
long	getPercentage(long numerator, long denom) converts a fraction into a percentage
long	getPercentage(java.lang.String numeratorAsString, java.lang.String denomAsString)
static java.util.Properties	getProperties(java.lang.String resource, java.lang.Class callingClass) Deprecated. since 2.3 use PropertyUtils.getProperties(String, Class) instead
static java.util.Properties	getPropertiesFromFile(java.io.File file) Deprecated. since 2.3 use PropertyUtils.getProperties(String, Class) instead
static java.util.Properties	getPropertiesFromStream(java.io.InputStream is) Deprecated. since 2.3 use PropertyUtils.getProperties(String, Class) instead
static <T> java.util.List<T>	getRandomSubSet(java.util.List<T> list, int sizeOfSubset, java.util.Random random) Returns a randomised subset of the list provided.
static java.lang.String	getRelativeTime(java.util.Date date) Deprecated. since 2.7 use FriendlyDateFormatter
static java.lang.String	getStackTrace(java.lang.Throwable t)
static java.lang.Long	getSystemStartupTime()
static java.lang.String	getUploadFileTooLargeMessage(java.lang.String errorMessage) if this error message is of the type: "java.io.IOException: Content Length Error" convert it to something nicer
static UserAccessor	getUserAccessor()
static java.lang.String	getVersionNumber()
static java.lang.String	hackSingleQuotes(java.lang.String s) hack to make strings that contain singles compatible with javascript (which also uses single quotes denote strings)
static boolean	hasTooManyUsers() Check if the current installation has more active users than is allowed by the license
static java.lang.String	highlight(java.lang.String content, java.lang.String searchwords)
static java.lang.String	htmlEncode(java.lang.String text)
static java.lang.String	htmlEscapeQuotes(java.lang.String input) Take a string and escape the quotes in it with \" and HTML escape them afterwards.
static boolean	isAllAscii(java.lang.String s)
static boolean	isAllLettersOrNumbers(java.lang.String s)
static boolean	isDefaultUserProfilePicture(java.lang.String username) Deprecated. This method must not be used anymore, it is horribly inefficient. Rather use the ProfilePictureInfo: since it is never null, you can ask that object is the user has a default profile picture or not
static boolean	isGlobalAdministrator(java.lang.Object notUsedAnyMore, com.atlassian.user.User user) Deprecated. since 2.0 use PermissionManager directly, or use the $permissionHelper from velocity
static boolean	isInLastDays(java.util.Date date, int maxDays)
static boolean	isLicenseExpired()
static boolean	isOutgoingMailConfigured()
static boolean	isSafeTitleForFilesystem(java.lang.String title) Ensure the title is safe to be written to the file system.
static boolean	isSafeTitleForUrl(java.lang.String title) Is "title" something we can safely put in a /foo/bar/title URL? Or should we reference this thing by ID just to be safe?
static boolean	isSetupComplete()
static boolean	isSuperUser(com.atlassian.user.User user)
static void	loadDefaultProperties() Deprecated. since 3.0 because it doesn't do anything
static java.lang.String	lookupDomainName(javax.servlet.http.HttpServletRequest request) Get the default domain name.
static java.lang.String	makeFlatSummary(java.lang.String content) Create a summary of this content fragment.
static java.lang.String	makeFlatSummary(java.lang.String content, java.lang.String query) Create a summary of this content fragment given a query
static com.atlassian.bonnie.search.summary.Summary	makeSummary(java.lang.String content) Create a proper summary of this content fragment.
static com.atlassian.bonnie.search.summary.Summary	makeSummary(java.lang.String content, java.lang.String query) Create a proper summary of this content fragment given a query
static java.lang.String	maskEmail(java.lang.String emailAddress) If configured, masks an email address to defeat the most simplistic spam bots.
static ConfluenceActionSupport	newWiredConfluenceActionSupport()
static java.lang.String	personalSpaceUrl(java.lang.String contextPath, java.lang.String username)
static java.lang.String	plain2html(java.lang.String text)
static java.lang.String	populateSimpleMessage(java.lang.String template, java.util.List<java.lang.String> values) Populate the template String supplied using the given values.
static java.util.Map	prefixAllMapKeys(java.lang.String prefix, java.util.Map map) Convert the supplied Map so that all of the keys in the Map are prefixed by the supplied String followed by a full stop.
static void	profilePop(java.lang.String s)
static void	profilePush(java.lang.String s)
static java.lang.String	rdfEncode(java.lang.String s) A fairly evil hack to work around CONF-10364.
static java.lang.String	replaceConfluenceHomeConstant(java.lang.String in, java.lang.String confHome)
static java.util.List	safeSubList(java.util.List list, int max)
static javax.servlet.http.Cookie	setCookie(java.lang.String key, java.lang.String value) Sets a cookie.
static void	setSystemStartupTime(java.lang.Long systemStartupTime)
static void	setUserAccessor(UserAccessor userAcc)
static java.lang.String	shortenString(java.lang.String str, int max) Returns a substring of the specified string if it is longer than max.
static boolean	shouldUrlDecode(java.lang.String str)
static java.util.Collection	specialLowerCaseCollection(java.util.Collection collection) Takes a collection of Strings and lowercases the entries.
static java.lang.String	specialToLowerCase(java.lang.String str) the database lower() function in PostgreSQL only works for ASCII strings.
static java.lang.String[]	splitCommaDelimitedString(java.lang.String escapedNames) Method will turn a String of comma seperated entities into a String Array.
static boolean	stringSet(java.lang.String str)
long	subtract(long a, long b)
long	subtract(java.lang.String firstOperandAsString, java.lang.String secondOperandAsString)
static java.lang.String	summarise(java.lang.String content) Deprecated. since 2.0 use RendererUtil.summarise(String) instead.
static java.lang.String	trimDownStringToWord(java.lang.String s)
static java.lang.String	unescapeCDATA(java.lang.String s)
static java.lang.String	unescapeEntities(java.lang.String str)
static void	unzipFile(java.io.File zipFile, java.io.File dirToExtractTo) Unzips the zip file to a folder in temp and returns the File pointing to that expanded folder.
static void	unzipUrl(java.net.URL zipUrl, java.io.File dirToExtractTo) Unzips the zip url to a folder in temp and returns the File pointing to that expanded folder.
static java.lang.String	urlDecode(java.lang.String url)
static java.lang.String	urlEncode(java.lang.String url) A utility method to encode HTTP form parameter/values.
static java.lang.String	wordWrap(java.lang.String str, int max) For really long strings that have no spaces or line breaks, browsers such as firefox, Netscape, have difficulty wrapping them inside a table cell, and so these strings end up stretching the cell longer than its suppose to be = ugly we want to simulate IE's word-wrap/break function here

Methods inherited from class java.lang.Object

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

Constructor Detail

GeneralUtil

public GeneralUtil()

Method Detail

loadDefaultProperties

public static void loadDefaultProperties()

Deprecated. since 3.0 because it doesn't do anything

See Also:

BuildInformation

getStackTrace

public static java.lang.String getStackTrace(java.lang.Throwable t)

format

public static java.lang.String format(java.lang.Number number)

TODO: Replace with a NumberFormatter, similar to DateFormatter

Returns:

the number formatted a String, or null if an exception occurred.

format

public static java.lang.String format(java.util.Date date)

Deprecated. since 2.3. Provided for pre-2.3 themes and layouts only. New themes and layouts should use $dateFormatter.format(Date) in the Velocity context or ConfluenceUserPreferences.getDateFormatter(FormatSettingsManager).

See Also:

DateFormatter.format(Date)

format

public static java.lang.String format(java.lang.String str)

format

public static java.lang.String format(java.lang.Object obj)

formatDateTime

public static java.lang.String formatDateTime(java.util.Date date)

Deprecated. since 2.3. Provided for pre-2.3 themes and layouts only. New themes and layouts should use $dateFormatter.formatDateTime(Date) in the Velocity context or ConfluenceUserPreferences.getDateFormatter(FormatSettingsManager).

See Also:

DateFormatter.formatDateTime(Date)

formatTime

public static java.lang.String formatTime(java.util.Date date)

Deprecated. since 2.3. Provided for pre-2.3 themes and layouts only. New themes and layouts should use $dateFormatter.formatTime(Date) in the Velocity context or ConfluenceUserPreferences.getDateFormatter(FormatSettingsManager).

See Also:

DateFormatter.formatTime(Date)

formatBlogDate

public static java.lang.String formatBlogDate(java.util.Date date)

Deprecated. since 2.3. Provided for pre-2.3 themes and layouts only. New themes and layouts should use $dateFormatter.formatBlogDate(Date) in the Velocity context or ConfluenceUserPreferences.getDateFormatter(FormatSettingsManager).

See Also:

DateFormatter.formatBlogDate(Date)

convertMailFormatDate

public static java.util.Date convertMailFormatDate(java.lang.String date)
                                            throws java.text.ParseException

Throws:

java.text.ParseException

convertToCharacter

public static java.lang.Character convertToCharacter(java.lang.Object obj)

convertToInteger

public static java.lang.Integer convertToInteger(java.lang.Object obj)

convertToBoolean

public static java.lang.Boolean convertToBoolean(java.lang.Object obj)

convertToBoolean

public static boolean convertToBoolean(java.lang.Object bool,
                                       boolean defaultValue)

convertToString

public static java.lang.String convertToString(java.lang.Object obj)

completeUrlEncode

public static java.lang.String completeUrlEncode(java.lang.String url)

A utility method to encode the given url for protocols which the CompleteURLEncoder supports. To only encode HTTP form parameter/values or fragments, use urlEncode() instead.

Parameters:

url - - the entire URL to encode

Returns:

encoded url

urlEncode

public static java.lang.String urlEncode(java.lang.String url)

A utility method to encode HTTP form parameter/values. To encode entire URLs, use completeUrlEncode() instead.

Parameters:

url - - part of the url to encode

Returns:

encoded url

urlDecode

public static java.lang.String urlDecode(java.lang.String url)

shouldUrlDecode

public static boolean shouldUrlDecode(java.lang.String str)

getPageUrl

public static java.lang.String getPageUrl(VersionHistorySummary summary)

getPageUrl

public static java.lang.String getPageUrl(AbstractPage page)

getIdBasedPageUrl

public static java.lang.String getIdBasedPageUrl(AbstractPage page)

Get page URL that is id based (i.e. in the format /pages/viewpage.action?pageId=<pageId>)

Parameters:

page - the page to generate a url for

Returns:

page URL that is id based

isSafeTitleForUrl

public static boolean isSafeTitleForUrl(java.lang.String title)

Is "title" something we can safely put in a /foo/bar/title URL? Or should we reference this thing by ID just to be safe?

isSafeTitleForFilesystem

public static boolean isSafeTitleForFilesystem(java.lang.String title)

Ensure the title is safe to be written to the file system. See CONF-10741.

Parameters:

title -

Returns:

customGetPageUrl

public static java.lang.String customGetPageUrl(AbstractPage page)

Need a special case of generalutils getpageurl that appends ? or ampersand smartly this is used to prefix url parameters that are appended after this path like: showcomments=true#addcomment

appendAmpsandOrQuestionMark

public static java.lang.String appendAmpsandOrQuestionMark(java.lang.String str)

wordWrap

public static java.lang.String wordWrap(java.lang.String str,
                                        int max)

For really long strings that have no spaces or line breaks, browsers such as firefox, Netscape, have difficulty wrapping them inside a table cell, and so these strings end up stretching the cell longer than its suppose to be = ugly

we want to simulate IE's word-wrap/break function here

Parameters:

str -

max - - max length of string allowed per line

highlight

public static java.lang.String highlight(java.lang.String content,
                                         java.lang.String searchwords)

doubleUrlEncode

public static java.lang.String doubleUrlEncode(java.lang.String s)

isAllAscii

public static boolean isAllAscii(java.lang.String s)

isAllLettersOrNumbers

public static boolean isAllLettersOrNumbers(java.lang.String s)

getVersionNumber

public static java.lang.String getVersionNumber()

getBuildDate

public static java.util.Date getBuildDate()

getBuildDateString

public static java.lang.String getBuildDateString()

getBuildNumber

public static java.lang.String getBuildNumber()

getBuildPartner

public static java.lang.String getBuildPartner()

getBuildExcludedLocale

public static java.lang.String getBuildExcludedLocale()

getSystemStartupTime

public static java.lang.Long getSystemStartupTime()

setSystemStartupTime

public static void setSystemStartupTime(java.lang.Long systemStartupTime)

isLicenseExpired

public static boolean isLicenseExpired()

checkPartnerDetails

public static java.lang.String checkPartnerDetails(com.atlassian.license.License license,
                                                   java.lang.String buildPartnerName)

hasTooManyUsers

public static boolean hasTooManyUsers()

Check if the current installation has more active users than is allowed by the license

Returns:

true if the number exceeds the license, false otherwise.

stringSet

public static boolean stringSet(java.lang.String str)

formatLongTime

public static java.lang.String formatLongTime(long time)

displayShortUrl

public static java.lang.String displayShortUrl(java.lang.String url)

displayShortUrl

public static java.lang.String displayShortUrl(java.lang.String url,
                                               int length)

formatDateFull

public static java.lang.String formatDateFull(java.util.Date date)

isSuperUser

public static boolean isSuperUser(com.atlassian.user.User user)

getCharacterEncoding

public static java.lang.String getCharacterEncoding()

escapeXml

public static java.lang.String escapeXml(java.lang.String stringToEscape)

escapeForJavascript

public static java.lang.String escapeForJavascript(java.lang.String s)

Escapes ', " and \ with a leading \.

isSetupComplete

public static boolean isSetupComplete()

maskEmail

public static java.lang.String maskEmail(java.lang.String emailAddress)

If configured, masks an email address to defeat the most simplistic spam bots. If Confluence is not configured to mask email addresses, just returns the original address.

Passing in null to this method will just get you null back

Parameters:

emailAddress - the email address to mask

Returns:

the masked email address, or the original address if masking is not configured

alwaysMaskEmail

public static java.lang.String alwaysMaskEmail(java.lang.String emailAddress)

Masks an email address by replacing '@' with 'at' and '.' with 'dot'.

Parameters:

emailAddress - an email address to mask, eg dwillis@atlassian.com

Returns:

a masked version of the email, eg dwillis at atlassian dot com

findAndMaskEmail

public static java.lang.String findAndMaskEmail(java.lang.String text,
                                                com.atlassian.user.User currentUser)

escapeCDATA

public static java.lang.String escapeCDATA(java.lang.String s)

unescapeCDATA

public static java.lang.String unescapeCDATA(java.lang.String s)

createTempDirectoryInConfluenceTemp

public static java.io.File createTempDirectoryInConfluenceTemp(java.lang.String prefix)

createTempFile

public static java.io.File createTempFile(java.lang.String directory)

unescapeEntities

public static java.lang.String unescapeEntities(java.lang.String str)

base64Decode

public static java.lang.String base64Decode(java.lang.String s)

base64Encode

public static java.lang.String base64Encode(java.lang.String s)

hackSingleQuotes

public static java.lang.String hackSingleQuotes(java.lang.String s)

hack to make strings that contain singles compatible with javascript (which also uses single quotes denote strings)

Parameters:

s -

isInLastDays

public static boolean isInLastDays(java.util.Date date,
                                   int maxDays)

Parameters:

date - the date to check

maxDays - the number of days into the past the date can fall

Returns:

Whether whether the date falls within maxDays before the present.

getRelativeTime

public static java.lang.String getRelativeTime(java.util.Date date)

Deprecated. since 2.7 use FriendlyDateFormatter

Returns:

A relative time period, 'X hours, Y minutes ago'

getFormatDateSimple

public static java.lang.String getFormatDateSimple(java.util.Date date)

setCookie

public static javax.servlet.http.Cookie setCookie(java.lang.String key,
                                                  java.lang.String value)

Sets a cookie. set to use a default cookie age of one year and the context path as the default path

Parameters:

key -

value -

getCookieValue

public static java.lang.String getCookieValue(java.lang.String key)

htmlEncode

public static java.lang.String htmlEncode(java.lang.String text)

isGlobalAdministrator

public static boolean isGlobalAdministrator(java.lang.Object notUsedAnyMore,
                                            com.atlassian.user.User user)

Deprecated. since 2.0 use PermissionManager directly, or use the $permissionHelper from velocity

plain2html

public static java.lang.String plain2html(java.lang.String text)

See Also:

PlainTextToHtmlConverter

getProperties

public static java.util.Properties getProperties(java.lang.String resource,
                                                 java.lang.Class callingClass)

Deprecated. since 2.3 use PropertyUtils.getProperties(String, Class) instead

getPropertiesFromFile

public static java.util.Properties getPropertiesFromFile(java.io.File file)

Deprecated. since 2.3 use PropertyUtils.getProperties(String, Class) instead

getPropertiesFromStream

public static java.util.Properties getPropertiesFromStream(java.io.InputStream is)

Deprecated. since 2.3 use PropertyUtils.getProperties(String, Class) instead

unzipFile

public static void unzipFile(java.io.File zipFile,
                             java.io.File dirToExtractTo)
                      throws java.lang.Exception

Unzips the zip file to a folder in temp and returns the File pointing to that expanded folder.

Throws:

java.lang.Exception

unzipUrl

public static void unzipUrl(java.net.URL zipUrl,
                            java.io.File dirToExtractTo)
                     throws java.lang.Exception

Unzips the zip url to a folder in temp and returns the File pointing to that expanded folder.

Throws:

java.lang.Exception

getUploadFileTooLargeMessage

public static java.lang.String getUploadFileTooLargeMessage(java.lang.String errorMessage)

if this error message is of the type: "java.io.IOException: Content Length Error" convert it to something nicer

Parameters:

errorMessage -

getDefaultResourceBundle

public static java.util.ResourceBundle getDefaultResourceBundle()

getI18n

public static I18NBean getI18n()

Returns:

The I18NBean for the current user

arraySize

public int arraySize(int[] array)

convenience method to allow us to determine the size of an int array a velocity file

Parameters:

array -

escapeXMLCharacters

public static java.lang.String escapeXMLCharacters(java.lang.String input)

Take a String which may contain <, > or & and return an XML string containing entities

htmlEscapeQuotes

public static java.lang.String htmlEscapeQuotes(java.lang.String input)

Take a string and escape the quotes in it with \" and HTML escape them afterwards. We need this function to escape strings containing quotes passed into JavaScript functions null input will be returned as an empty String.

filterNulls

public static java.util.List filterNulls(java.util.Collection in)

Return a List with no null entries

shortenString

public static java.lang.String shortenString(java.lang.String str,
                                             int max)

Returns a substring of the specified string if it is longer than max. This method also appends "..." to the end of the string if it does truncate it.

Returns:

a substring of the specified string if it is longer than max.

specialToLowerCase

public static java.lang.String specialToLowerCase(java.lang.String str)

the database lower() function in PostgreSQL only works for ASCII strings. All other unicode and multibyte characters like capital umlaut are not properly converted. At the moment, when searching for pages we do the following comparison:

lower(page.title) = :pageTitle (Where :pageTitle is normally .toLowerCase() first before being passed in)

This special lower case function will skip the JAVA .toLowerCase() for postgres whose database lower() is ineffective.

Parameters:

str -

replaceConfluenceHomeConstant

public static java.lang.String replaceConfluenceHomeConstant(java.lang.String in,
                                                             java.lang.String confHome)

specialLowerCaseCollection

public static java.util.Collection specialLowerCaseCollection(java.util.Collection collection)

Takes a collection of Strings and lowercases the entries.

Parameters:

collection -

Returns:

lowercased collection of strings

safeSubList

public static java.util.List safeSubList(java.util.List list,
                                         int max)

summarise

public static java.lang.String summarise(java.lang.String content)

Deprecated. since 2.0 use RendererUtil.summarise(String) instead.

makeSummary

public static com.atlassian.bonnie.search.summary.Summary makeSummary(java.lang.String content)

Create a proper summary of this content fragment.

See Also:

Summarizer

makeSummary

public static com.atlassian.bonnie.search.summary.Summary makeSummary(java.lang.String content,
                                                                      java.lang.String query)

Create a proper summary of this content fragment given a query

See Also:

Summarizer

makeFlatSummary

public static java.lang.String makeFlatSummary(java.lang.String content)

Create a summary of this content fragment.

See Also:

Summarizer

makeFlatSummary

public static java.lang.String makeFlatSummary(java.lang.String content,
                                               java.lang.String query)

Create a summary of this content fragment given a query

See Also:

Summarizer

getUserAccessor

public static UserAccessor getUserAccessor()

setUserAccessor

public static void setUserAccessor(UserAccessor userAcc)

getImageInfo

public static com.atlassian.core.util.ImageInfo getImageInfo(java.io.File pathToImage)

getNiceDuration

public static java.lang.String getNiceDuration(int minutes,
                                               int seconds)

getCompactDuration

public static java.lang.String getCompactDuration(long time)

Returns the duration in a compact HH:mm:ss format.

Parameters:

time - duration in milliseconds

Returns:

the duration in a compact HH:mm:ss format.

newWiredConfluenceActionSupport

public static ConfluenceActionSupport newWiredConfluenceActionSupport()

profilePush

public static void profilePush(java.lang.String s)

profilePop

public static void profilePop(java.lang.String s)

lookupDomainName

public static java.lang.String lookupDomainName(javax.servlet.http.HttpServletRequest request)

Get the default domain name.

Parameters:

request -

Returns:

null if request is null, otherwise a base URL derived from the request.

getGlobalSettings

public static Settings getGlobalSettings()

personalSpaceUrl

public static java.lang.String personalSpaceUrl(java.lang.String contextPath,
                                                java.lang.String username)

getPercentage

public long getPercentage(long numerator,
                          long denom)

converts a fraction into a percentage

Parameters:

numerator -

denom -

subtract

public long subtract(long a,
                     long b)

getPercentage

public long getPercentage(java.lang.String numeratorAsString,
                          java.lang.String denomAsString)

subtract

public long subtract(java.lang.String firstOperandAsString,
                     java.lang.String secondOperandAsString)

getConfluenceTempDirectoryPath

public static java.lang.String getConfluenceTempDirectoryPath()

Checks if temp directory exists before returning the path. Create it if it doesn't already exist.

Returns:

path to temp directory inside Confluence home

getConfluenceTempDirectory

public static java.io.File getConfluenceTempDirectory()

splitCommaDelimitedString

public static java.lang.String[] splitCommaDelimitedString(java.lang.String escapedNames)

Method will turn a String of comma seperated entities into a String Array. Spaces before or after the comma will be cropped. Backslashes are treated as escaped characters. Eg when "backslash""comma" is encountered, the backslash is discarded and the comma is not treated as a delimiter.

Parameters:

escapedNames - Comma delimited string with original commas and backslashes escaped by backslashes

Returns:

String[] of escapedNames

escapeCommas

public static java.util.List escapeCommas(java.util.List toEscape)

Escape commas on each entry in the given list of strings.

Parameters:

toEscape - Strings to escape

Returns:

escaped Strings

escapeCommas

public static java.lang.String escapeCommas(java.lang.String toEscape)

Escapes commas and backslashes with leading backslashes.

Parameters:

toEscape - string to escape. If null, then null will be returned.

constrainLength

public static java.lang.String constrainLength(java.lang.String s,
                                               int length)

Truncate a string after n characters

Parameters:

s - The String to truncate

length - The maximum length allowed.

Returns:

The truncated String -- or the original String if no truncation was needed.

isOutgoingMailConfigured

public static boolean isOutgoingMailConfigured()

convertBeanToMap

public static java.util.Map convertBeanToMap(java.lang.Object bean)

Parameters:

bean - a bean to be converted to a Map.

Returns:

a Map where the keys are the property names from the beans, and the values are the property values. An empty Map will be returned if the bean cannot be converted.

prefixAllMapKeys

public static java.util.Map prefixAllMapKeys(java.lang.String prefix,
                                             java.util.Map map)

Convert the supplied Map so that all of the keys in the Map are prefixed by the supplied String followed by a full stop. e.g. monkey could become howler.monkey.

If any of the keys in the Map are not Strings then they will be ignored.

Parameters:

prefix - the prefix to be pre-pended to each Map key, if null then the original Map will be returned.

map - the Map to be modified. If null, then an empty Map will be returned.

Returns:

a new Map containing the modified keys and the supplied values.

isDefaultUserProfilePicture

public static boolean isDefaultUserProfilePicture(java.lang.String username)

Deprecated. This method must not be used anymore, it is horribly inefficient. Rather use the ProfilePictureInfo: since it is never null, you can ask that object is the user has a default profile picture or not

rdfEncode

public static java.lang.String rdfEncode(java.lang.String s)

A fairly evil hack to work around CONF-10364. It sucks, but is necessary.

Parameters:

s - to encode

Returns:

the input String with double hyphens replaced by --

populateSimpleMessage

public static java.lang.String populateSimpleMessage(java.lang.String template,
                                                     java.util.List<java.lang.String> values)

Populate the template String supplied using the given values. The template may contain place holders which are denoted numerically in the form {n} where n is an index into the supplied values list.

e.g. "The template called {1} will expects a colour here {0}".

This template will use value 0 and value 1 from the supplied values array. If the referenced value cannot be found then the place holder will simply be removed.

Parameters:

template - the template to be populated

values - the values used to populate the template

Returns:

a populated template with all place holder markers removed.

getRandomSubSet

public static <T> java.util.List<T> getRandomSubSet(java.util.List<T> list,
                                                    int sizeOfSubset,
                                                    java.util.Random random)

Returns a randomised subset of the list provided. If the size of the subset is larger than the list, the entire list is returned in a random order.

Parameters:

list - - the list to subset

sizeOfSubset - - the size of the subset to return

random - - the source of randomness

Returns:

a randomised subset of the list

trimDownStringToWord

public static java.lang.String trimDownStringToWord(java.lang.String s)