de.ipcon.tools

Class L10n

java.lang.Object

de.ipcon.tools.L10n

All Implemented Interfaces:

L10nPackProviderI

public final class L10n
extends java.lang.Object
implements L10nPackProviderI

This class is just a utility collection of all static functions that are needed to perform any localization jobs without worrying about details.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	L10n.UnresolvedMessage

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.regex.Pattern	l10nTagPattern
static java.lang.String	PACK_SEPARATOR
static java.util.regex.Pattern	validBundleNamePattern
static java.util.regex.Pattern	validPackagePattern
static java.lang.String	validResourceKeyChars
static java.util.regex.Pattern	validResourceKeyPattern

Method Summary

Modifier and Type	Method and Description
static void	addLocaleChangeListener(L10nLocaleChangeListenerI _lcl)
static void	addPathCompilerForClass(java.lang.Class clazz, L10nPathCompilerI comp) Classes will create singleton instances of their special version of L10nPathCompilerI and add them with this method to the L10n list.
static void	addPreloadL10nCacheFinishedListener(PreloadL10nCacheFinishedListenerI l)
static void	appendPackProvider(L10nPackProviderI p)
static electric.xml.Document	applyL10n(electric.xml.Document _doc, java.lang.Object[] _path)
static electric.xml.Document	applyL10n(electric.xml.Document _doc, java.lang.Object[] _path, java.lang.String _localeName)
static void	applyL10n(electric.xml.Element _el, java.lang.Object[] _path)
static void	applyL10n(electric.xml.Element _el, java.lang.Object[] _path, java.lang.String _localeName)
static java.lang.String	applyL10n(java.lang.String in, java.lang.Object[] path) Replaces $R{...} in given String by appropriate texts and returns the result.
static java.lang.String	applyL10n(java.lang.String in, java.lang.Object[] path, java.lang.String localeName)
static java.lang.String	applyL10nLocale(java.lang.String in, java.lang.Object[] path, java.util.Locale locale)
static java.lang.String	canonifyPackageName(java.lang.String s) Removes '$' "sub"class parts from s.
static java.lang.String[]	compilePath(java.lang.Object[] participants) Compiles and returns a list of L10nBundle names.
static void	firePathCompilersChanged()
static void	flushCache()
static void	flushCache(java.lang.String bundle)
static void	flushCache(java.lang.String[] bundles)
static java.lang.String	formatDate(java.util.Date d) usage with locale not recommended as they are not being cached, which leads to poor performance. the locale can instead be stored in the pattern-string
static java.lang.String	formatDate(java.util.Date d, java.lang.String pattern)
static java.lang.String	formatDate(java.util.Date d, java.lang.String pattern, java.util.Locale _locale)
static java.lang.String	formatDate(java.util.Date d, java.lang.String pattern, java.util.Locale _locale, java.util.TimeZone timeZone)
static java.lang.String	formatDateNT(java.util.Date d) null safe version of formatDate with fallback if date is null
static java.lang.String	formatDateNT(java.util.Date d, java.lang.String pattern)
static java.lang.String	formatDateNT(java.util.Date d, java.lang.String pattern, java.util.Locale locale)
static java.lang.String	formatDateNT(java.util.Date d, java.lang.String pattern, java.util.Locale locale, java.lang.String fallback)
static java.lang.String	formatDateNT(java.util.Date d, java.lang.String pattern, java.lang.String fallback) null safe version of formatDate with fallback if date is null
static java.lang.String	formatDecimal(java.lang.Number n)
static java.lang.String	formatDecimal(java.lang.Number n, java.lang.String pattern)
static java.lang.String	formatDecimal(java.lang.Number n, java.lang.String pattern, java.util.Locale _locale)
static java.lang.String	formatDecimalNT(java.lang.Number n) null safe version of formatDecimal with fallback if number is null
static java.lang.String	formatDecimalNT(java.lang.Number n, java.lang.String pattern)
static java.lang.String	formatDecimalNT(java.lang.Number n, java.lang.String pattern, java.util.Locale locale)
static java.lang.String	formatDecimalNT(java.lang.Number n, java.lang.String pattern, java.util.Locale locale, java.lang.String fallback)
static java.lang.String	formatDecimalNT(java.lang.Number n, java.lang.String pattern, java.lang.String fallback) null safe version of formatDecimal with fallback if number is null
static java.lang.String	formatDuration(javax.xml.datatype.Duration _dur)
static java.lang.String	formatDuration(javax.xml.datatype.Duration _dur, java.lang.String _pattern)
static java.lang.String	formatDuration(javax.xml.datatype.Duration _dur, java.lang.String _pattern, java.util.Locale _locale)
static java.lang.String	formatISO8601(java.util.Date date) Returns the given Date in an ISO8601:2019 conformant String.
static java.lang.String	formatISO8601(java.util.Date date, boolean withLocalTimeZone)
static java.lang.String	formatISO8601NT(java.util.Date date) Not throwing version of #formatISO8601Date(Date, boolean).
static java.lang.String	formatISO8601NT(java.util.Date date, java.lang.String fallback)
static java.lang.String	formatISO8601NT(java.util.Date date, java.lang.String fallback, boolean withLocalTimeZone)
static java.lang.String	formatISODate(java.util.Date d) Formats the given Date in ISO8601 like format, with the 'T' replaced by a space.
static java.lang.String	formatISODateNT(java.util.Date d) null safe version of formatISODate with fallback if date is null
static java.lang.String	formatISODateNT(java.util.Date d, java.lang.String fallback)
static java.lang.String	formatTimespan(java.lang.Number _ts)
static java.lang.String	formatTimespan(java.lang.Number _ts, java.lang.String _pattern)
static java.lang.String	formatTimespan(java.lang.Number _ts, java.lang.String _pattern, java.util.Locale _locale)
static java.lang.String[]	getAutoPath() Returns path compiled by using info from current StackTrace.
static java.lang.String[]	getAutoPath(int _stackOffset)
static java.text.Collator	getCollator() returns a Collator for the current default locale, but makes it space sensitive
static java.text.Collator	getCollator(java.util.Locale l)
static java.text.Collator	getCollator(java.util.Locale l, java.lang.String parms)
static L10nCurrentLocaleProviderI	getCurrentLocaleProvider() Gets the locale provider for the current Thread.
static java.util.Locale	getCurrentLocaleViaProvider() Returns the current locale for the current Thread.
static L10nDateFormat	getDateFormat()
static L10nDateFormat	getDateFormat(java.lang.String _pattern)
static L10nDateFormat	getDateFormat(java.lang.String _pattern, java.util.Locale _locale)
static L10nDateFormat	getDateFormat(java.lang.String _pattern, java.util.Locale _locale, java.util.TimeZone timeZone)
static L10nDecimalFormat	getDecimalFormat() Factory-Method for DecimalFormat objects, locale sensitive.
static L10nDecimalFormat	getDecimalFormat(java.lang.String _pattern)
static L10nDecimalFormat	getDecimalFormat(java.lang.String _pattern, java.util.Locale _locale)
static java.util.Locale	getDefaultLocale()
static java.lang.String	getDefaultLocaleName()
static java.util.function.Supplier<java.lang.String>	getGetCallingClassNameImplementation()
L10nPack	getL10nPack(java.lang.String name, java.lang.String ln)
L10nPack[]	getL10nPacks(java.lang.String[] bundles, java.lang.String ln)
L10nPathEntry[]	getL10nPath()
java.lang.String	getL10nViaString()
static java.lang.String	getLanguageSeperatedByDash(java.lang.String _str, int _lang) this method takes a String where the languages are seperated by | it returns the _lang'th language of this string, beginning at 1
static java.util.Locale	getLocaleFromString(java.lang.String s)
static L10nPack	getPack(java.lang.String[] path, int index) Loading the packs is a bit complex, because incomplete packs are possible with only a small part of the keys inside.
static L10nPack	getPack(java.lang.String[] path, int index, java.lang.String ln)
static L10nTimespanFormat	getTimespanFormat()
static L10nTimespanFormat	getTimespanFormat(java.lang.String pattern)
static L10nTimespanFormat	getTimespanFormat(java.lang.String pattern, java.util.Locale locale)
static java.lang.String	getWaehrungsSymbol(java.lang.String isocode)
L10nPack	internalGetL10nPack(java.lang.String name, java.lang.String ln) Loads L10nPack from *.properties file resources via classpath and getResourceAsStream().
boolean	isOperational()
static boolean	isParentOf(java.util.Locale supposedParent, java.util.Locale supposedChild)
static java.lang.String	msg(java.lang.String key) Convenience frontend that automatically compiles the path by getting the calling class from the current StackTrace.
static java.lang.String	msg(java.lang.String key, byte arg0) Convenience frontend for #msg(String, Object[]).
static java.lang.String	msg(java.lang.String key, int arg0) Convenience frontend for #msg(String, Object[]).
static java.lang.String	msg(java.lang.String key, long arg0) Convenience frontend for #msg(String, Object[]).
static java.lang.String	msg(java.lang.String key, java.lang.Number arg0) Convenience frontend for #msg(String, Object[]).
static java.lang.String	msg(java.lang.String key, java.lang.Object[] args)
static java.lang.String	msg(java.lang.String key, java.lang.Object[] args, int stackOffset)
static java.lang.String	msg(java.lang.String key, java.lang.Object[] args, java.lang.Object[] _participants)
static java.lang.String	msg(java.lang.String key, java.lang.Object[] args, java.lang.Object[] _participants, boolean returnKeyWhenNotFound)
static java.lang.String	msg(java.lang.String key, java.lang.Object[] args, java.lang.Object[] _participants, boolean returnKeyWhenNotFound, java.util.Locale locale)
static java.lang.String	msg(java.lang.String key, java.lang.Object[] args, java.lang.Object[] _participants, boolean returnKeyWhenNotFound, java.lang.String localeName)
static java.lang.String	msg(java.lang.String key, java.lang.Object[] args, java.lang.String[] path)
static java.lang.String	msg(java.lang.String key, java.lang.Object[] args, java.lang.String[] path, boolean returnKeyWhenNotFound)
static java.lang.String	msg(java.lang.String key, java.lang.Object[] args, java.lang.String[] path, boolean returnKeyWhenNotFound, java.lang.String localeName)
static java.lang.String	msg(java.lang.String key, java.lang.Object[] args, java.lang.String[] path, boolean returnKeyWhenNotFound, java.lang.String localeName, boolean useFallbackLocale)
static java.lang.String	msg(java.lang.String key, short arg0) Convenience frontend for #msg(String, Object[]).
static java.lang.String	msg(java.lang.String key, java.lang.String arg0) Convenience frontend for #msg(String, Object[]).
static java.lang.String	msg(java.lang.String key, java.lang.String arg0, java.lang.String arg1) Convenience frontend for #msg(String, Object[]).
static java.lang.String	msg(java.lang.String key, java.lang.String arg0, java.lang.String arg1, java.lang.String arg2) Convenience frontend for #msg(String, Object[]).
static java.lang.String	msg(java.lang.String key, java.lang.String arg0, java.lang.String arg1, java.lang.String arg2, java.lang.String arg3) Convenience frontend for #msg(String, Object[]).
static java.lang.String	msgNoFormat(java.lang.String key) Convenience frontend that automatically compiles the path by getting the calling class from the current StackTrace.
static java.lang.String	msgNoFormat(java.lang.String key, int stackOffset)
static java.lang.String	msgNoFormat(java.lang.String key, java.lang.String[] path) Gets the matching message template string for key, etc.
static java.lang.String	msgNoFormat(java.lang.String key, java.lang.String[] path, java.lang.String localeName)
static java.lang.String	msgNoKey(java.lang.String key) Convenience frontend that automatically compiles the path by getting the calling class from the current StackTrace.
static java.lang.String	msgNoKey(java.lang.String key, java.lang.Object[] args)
static java.lang.String	msgNoKey(java.lang.String key, java.lang.Object[] args, int stackOffset)
static java.util.Date	parseDate(java.lang.String s) usage with locale not recommended as they are not being cached, which leads to poor performance. the locale can instead be stored in the pattern-string
static java.util.Date	parseDate(java.lang.String s, java.lang.String pattern)
static java.util.Date	parseDate(java.lang.String s, java.lang.String[] patterns) usage with locale not recommended as they are not being cached which leads to poor performance. the locale can instead be stored in the pattern-string
static java.util.Date	parseDate(java.lang.String s, java.lang.String[] patterns, java.util.Locale _locale)
static java.util.Date	parseDate(java.lang.String s, java.lang.String[] patterns, java.util.Locale _locale, java.util.TimeZone timeZone)
static java.util.Date	parseDate(java.lang.String s, java.lang.String pattern, java.util.Locale _locale)
static java.util.Date	parseDate(java.lang.String s, java.lang.String pattern, java.util.Locale _locale, java.util.TimeZone timeZone)
static java.util.Date	parseDateNT(java.lang.String s) wrapper for parseDate that throws no exception. if an exception is caught, fallback is returned, which defaults to null
static java.util.Date	parseDateNT(java.lang.String s, java.lang.String pattern)
static java.util.Date	parseDateNT(java.lang.String s, java.lang.String[] patterns) wrapper for parseDate that throws no exception. if an exception is caught, fallback is returned, which defaults to null
static java.util.Date	parseDateNT(java.lang.String s, java.lang.String[] patterns, java.util.Date fallback)
static java.util.Date	parseDateNT(java.lang.String s, java.lang.String pattern, java.util.Date fallback)
static java.math.BigDecimal	parseDecimal(java.lang.String s) Method to parse a L10n formatted Number in a String to the represented BigDecimal value.
static java.math.BigDecimal	parseDecimal(java.lang.String s, java.lang.String pattern)
static java.math.BigDecimal	parseDecimal(java.lang.String s, java.lang.String[] patterns)
static java.math.BigDecimal	parseDecimal(java.lang.String s, java.lang.String[] patterns, java.util.Locale _locale)
static java.math.BigDecimal	parseDecimal(java.lang.String s, java.lang.String pattern, java.util.Locale _locale)
static java.math.BigDecimal	parseDecimalNT(java.lang.String s) wrapper for parseDecimal that throws no exception. if an exception is caught, fallback is returned, which defaults to null
static java.math.BigDecimal	parseDecimalNT(java.lang.String s, java.lang.String pattern)
static java.math.BigDecimal	parseDecimalNT(java.lang.String s, java.lang.String[] patterns) wrapper for parseDecimal that throws no exception. if an exception is caught, fallback is returned, which defaults to null
static java.math.BigDecimal	parseDecimalNT(java.lang.String s, java.lang.String[] patterns, java.math.BigDecimal fallback)
static java.math.BigDecimal	parseDecimalNT(java.lang.String s, java.lang.String pattern, java.math.BigDecimal fallback)
static javax.xml.datatype.Duration	parseDuration(java.lang.String s)
static java.util.Date	parseISO8601(java.lang.String s) Parses an ISO8601:2019 conform Datetime text, returning the parameter as Date.
static java.util.Date	parseISO8601NT(java.lang.String s) Non-throw version of parseISO8601(String), returning the fallback if the given String is not a valid ISO date
static java.util.Date	parseISO8601NT(java.lang.String s, java.util.Date fallback)
static java.util.Date	parseISODate(java.lang.String s) Parses the given parameter as a ISO8601 like date, e.g. yyyy-MM-dd'T'HH:mm:ss.SSSX or yyyy-MM-dd, while trying to be a bit more tolerant regarding formatting errors.
static java.util.Date	parseISODateNT(java.lang.String s) wrapper for parseISODate thet throws no exception. if an exception is caught, fallback is returned, which defaults to null
static java.util.Date	parseISODateNT(java.lang.String s, java.util.Date fallback)
static java.lang.Long	parseTimespan(java.lang.String _str)
static java.lang.Long	parseTimespan(java.lang.String _str, java.lang.String _pattern)
static java.lang.Long	parseTimespan(java.lang.String _str, java.lang.String[] _patterns)
static java.lang.Long	parseTimespan(java.lang.String _str, java.lang.String[] _patterns, java.util.Locale _locale)
static java.lang.Long	parseTimespan(java.lang.String _str, java.lang.String _pattern, java.util.Locale _locale)
static void	preloadCache(L10nPackProviderI provider, L10nPack[] packsToPreload, java.lang.String ln)
static void	prependPackProvider(L10nPackProviderI p)
static void	recalcPath()
static void	releaseDateFormat(L10nDateFormat df)
static void	releaseDecimalFormat(L10nDecimalFormat df)
static void	releaseTimespanFormat(L10nTimespanFormat df)
static void	removePackProvider(L10nPackProviderI p)
static void	removePathCompilerForClass(java.lang.Class clazz, L10nPathCompilerI comp) FIXME (Currently) Not used.
static L10n.UnresolvedMessage	resolveLater(java.lang.String msg, java.lang.Object participant)
static L10n.UnresolvedMessage	resolveLater(java.lang.String msg, java.lang.Object[] participants)
static L10n.UnresolvedMessage	resolveLater(java.lang.String msg, java.lang.Object[] parameters, java.lang.Object[] participants)
static void	setCurrentLocaleProvider(L10nCurrentLocaleProviderI p) Sets the locale provider for the current Thread.
static void	setDefaultLocale(java.util.Locale l)
static void	setDefaultLocaleName(java.lang.String s)
static java.lang.String[]	splitPath(java.lang.String _path) Splits the given _path on '/' but ignoring '/' insided of $R{...} tags.
static java.lang.String	stringToKey(java.lang.String _str) Creates a usable L10n message key from a given String by removing spaces and not permitted characters and if given prepending a prefix.
static java.lang.String	stringToKey(java.lang.String _str, java.lang.String _prefix)
static L10nPack	validPack(java.lang.String key, java.lang.String[] path) A valid L10nPack is where pack.getString(key)<>null
static L10nPack	validPack(java.lang.String key, java.lang.String[] path, java.lang.String localeName)

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.ipcon.tools.L10nPackProviderI

prefetchL10nPacks

Field Detail

validPackagePattern

public static final java.util.regex.Pattern validPackagePattern

validBundleNamePattern

public static final java.util.regex.Pattern validBundleNamePattern

validResourceKeyChars

public static final java.lang.String validResourceKeyChars

See Also:

Constant Field Values

validResourceKeyPattern

public static final java.util.regex.Pattern validResourceKeyPattern

l10nTagPattern

public static final java.util.regex.Pattern l10nTagPattern

PACK_SEPARATOR

public static final java.lang.String PACK_SEPARATOR

See Also:

Constant Field Values

Method Detail

applyL10nLocale

public static final java.lang.String applyL10nLocale(java.lang.String in,
                                                     java.lang.Object[] path,
                                                     java.util.Locale locale)

See Also:

#applyL10n(String, Object[], String), with the last parameter being the LanguageTag if locale is not null

applyL10n

public static final java.lang.String applyL10n(java.lang.String in,
                                               java.lang.Object[] path)

Replaces $R{...} in given String by appropriate texts and returns the result.

Parameters:

in - input String containing $R{...} parts which shall be translated using L10nBundles

path - an object array containing the names of the L10nBundles to use for looking up the keys

localeName - the name of the locale to use for resolving the translated String, e.g. de, en, fr or even de_DE, fr_LU, de_LU etc.

Returns:

the input String with all occurences of $R{...} replaced by their appropriate Strings which were resolved from the L10nBundles in the system / in the path

applyL10n

public static final java.lang.String applyL10n(java.lang.String in,
                                               java.lang.Object[] path,
                                               java.lang.String localeName)

applyL10n

public static final electric.xml.Document applyL10n(electric.xml.Document _doc,
                                                    java.lang.Object[] _path)

applyL10n

public static final electric.xml.Document applyL10n(electric.xml.Document _doc,
                                                    java.lang.Object[] _path,
                                                    java.lang.String _localeName)

applyL10n

public static final void applyL10n(electric.xml.Element _el,
                                   java.lang.Object[] _path)

applyL10n

public static final void applyL10n(electric.xml.Element _el,
                                   java.lang.Object[] _path,
                                   java.lang.String _localeName)

msg

public static final java.lang.String msg(java.lang.String key,
                                         byte arg0)

Convenience frontend for #msg(String, Object[]).

This method provides a simplified way to generate a message string using a key and a single byte argument. It is intended for scenarios where only one byte argument is needed, thereby avoiding the need to create an array manually. *

Parameters:

key - the l10n key used to identify the l10n message template

arg0 - the byte argument to be substituted into the message template

Returns:

the l10n formatted message string based on the provided key and argument

msg

public static final java.lang.String msg(java.lang.String key,
                                         short arg0)

Convenience frontend for #msg(String, Object[]).

This method provides a simplified way to generate a message string using a key and a single short argument. It is intended for scenarios where only one short argument is needed, thereby avoiding the need to create an array manually. *

Parameters:

key - the l10n key used to identify the l10n message template

arg0 - the short argument to be substituted into the message template

Returns:

the l10n formatted message string based on the provided key and argument

msg

public static final java.lang.String msg(java.lang.String key,
                                         int arg0)

Convenience frontend for #msg(String, Object[]).

This method provides a simplified way to generate a message string using a key and a single int argument. It is intended for scenarios where only one int argument is needed, thereby avoiding the need to create an array manually. *

Parameters:

key - the l10n key used to identify the l10n message template

arg0 - the int argument to be substituted into the message template

Returns:

the l10n formatted message string based on the provided key and argument

msg

public static final java.lang.String msg(java.lang.String key,
                                         long arg0)

Convenience frontend for #msg(String, Object[]).

This method provides a simplified way to generate a message string using a key and a single long argument. It is intended for scenarios where only one long argument is needed, thereby avoiding the need to create an array manually. *

Parameters:

key - the l10n key used to identify the l10n message template

arg0 - the long argument to be substituted into the message template

Returns:

the l10n formatted message string based on the provided key and argument

msg

public static final java.lang.String msg(java.lang.String key,
                                         java.lang.Number arg0)

Convenience frontend for #msg(String, Object[]).

This method provides a simplified way to generate a message string using a key and a single Number argument. It is intended for scenarios where only one Number argument is needed, thereby avoiding the need to create an array manually. *

Parameters:

key - the l10n key used to identify the proper l10n entry

arg0 - the Number argument to be substituted into the message template

Returns:

the l10n formatted message string based on the provided key and argument

msg

public static final java.lang.String msg(java.lang.String key,
                                         java.lang.String arg0)

Convenience frontend for #msg(String, Object[]).

This method provides a simplified way to generate a message string using a key and a single String argument. It is intended for scenarios where only one String argument is needed, thereby avoiding the need to create an array manually. *

Parameters:

key - the l10n key used to identify the proper l10n entry

arg0 - the String argument to be substituted into the message template

Returns:

the l10n formatted message string based on the provided key and argument

msg

public static final java.lang.String msg(java.lang.String key,
                                         java.lang.String arg0,
                                         java.lang.String arg1)

Convenience frontend for #msg(String, Object[]).

This method provides a simplified way to generate a message string using a key and two String arguments. It is intended for scenarios where only two String arguments are needed, thereby avoiding the need to create an array manually. *

Parameters:

key - the l10n key used to identify the proper l10n entry

arg0 - the first String argument to be substituted into the message template

arg1 - the second String argument to be substituted into the message template

Returns:

the l10n formatted message string based on the provided key and argument

msg

public static final java.lang.String msg(java.lang.String key,
                                         java.lang.String arg0,
                                         java.lang.String arg1,
                                         java.lang.String arg2)

Convenience frontend for #msg(String, Object[]).

This method provides a simplified way to generate a message string using a key and three String arguments. It is intended for scenarios where only three String arguments are needed, thereby avoiding the need to create an array manually. *

Parameters:

key - the l10n key used to identify the proper l10n entry

arg0 - the first String argument to be substituted into the message template

arg1 - the second String argument to be substituted into the message template

arg2 - the third String argument to be substituted into the message template

Returns:

the l10n formatted message string based on the provided key and argument

msg

public static final java.lang.String msg(java.lang.String key,
                                         java.lang.String arg0,
                                         java.lang.String arg1,
                                         java.lang.String arg2,
                                         java.lang.String arg3)

Convenience frontend for #msg(String, Object[]).

This method provides a simplified way to generate a message string using a key and four String arguments. It is intended for scenarios where only four String arguments are needed, thereby avoiding the need to create an array manually. *

Parameters:

key - the l10n key used to identify the proper l10n entry

arg0 - the first String argument to be substituted into the message template

arg1 - the second String argument to be substituted into the message template

arg2 - the third String argument to be substituted into the message template

arg3 - the fourth String argument to be substituted into the message template

Returns:

the l10n formatted message string based on the provided key and argument

msg

public static final java.lang.String msg(java.lang.String key)

Convenience frontend that automatically compiles the path by getting the calling class from the current StackTrace.

Parameters:

stackOffset - not needed any more and ignored, but kept in for backwards compatibility.

msg

public static final java.lang.String msg(java.lang.String key,
                                         java.lang.Object[] args)

msg

public static final java.lang.String msg(java.lang.String key,
                                         java.lang.Object[] args,
                                         int stackOffset)

msgNoKey

public static final java.lang.String msgNoKey(java.lang.String key)

Convenience frontend that automatically compiles the path by getting the calling class from the current StackTrace.

Parameters:

stackOffset - not needed any more and ignored, but kept in for backwards compatibility.

msgNoKey

public static final java.lang.String msgNoKey(java.lang.String key,
                                              java.lang.Object[] args)

msgNoKey

public static final java.lang.String msgNoKey(java.lang.String key,
                                              java.lang.Object[] args,
                                              int stackOffset)

msg

public static final java.lang.String msg(java.lang.String key,
                                         java.lang.Object[] args,
                                         java.lang.Object[] _participants,
                                         boolean returnKeyWhenNotFound,
                                         java.util.Locale locale)

msg

public static final java.lang.String msg(java.lang.String key,
                                         java.lang.Object[] args,
                                         java.lang.Object[] _participants)

msg

public static final java.lang.String msg(java.lang.String key,
                                         java.lang.Object[] args,
                                         java.lang.Object[] _participants,
                                         boolean returnKeyWhenNotFound)

msg

public static final java.lang.String msg(java.lang.String key,
                                         java.lang.Object[] args,
                                         java.lang.Object[] _participants,
                                         boolean returnKeyWhenNotFound,
                                         java.lang.String localeName)

msg

public static final java.lang.String msg(java.lang.String key,
                                         java.lang.Object[] args,
                                         java.lang.String[] path)

Parameters:

key - the key which shall be translated using L10nBundles

args - an Object array containing the values which shall be inserted for all occurences of {i}, i = 0, 1, ... in the replacement String from the L10nBundles

path - a String array containing the names of the L10nBundles to use for looking up the keys

returnKeyWhenNotFound - a boolean determining if, as a fallback, the passed key shall be returned, if no matching Bundle containing this key can be found in the system / in the path

localeName - the name of the locale to use for resolving the translated String, e.g. de, en, fr or even de_DE, fr_LU, de_LU etc.

useFallbackLocale - determines if a fallback to a hard-coded fallback-locale should take place, if no matching Bundle containing this key can be found in the system / in the path

Returns:

the appropriate String-replacement for the key which was resolved from the L10nBundles in the system / in the path, possibly also applying MessageFormat.format(String, Object...) to the message template for the key.

msg

public static final java.lang.String msg(java.lang.String key,
                                         java.lang.Object[] args,
                                         java.lang.String[] path,
                                         boolean returnKeyWhenNotFound)

msg

public static final java.lang.String msg(java.lang.String key,
                                         java.lang.Object[] args,
                                         java.lang.String[] path,
                                         boolean returnKeyWhenNotFound,
                                         java.lang.String localeName)

msg

public static final java.lang.String msg(java.lang.String key,
                                         java.lang.Object[] args,
                                         java.lang.String[] path,
                                         boolean returnKeyWhenNotFound,
                                         java.lang.String localeName,
                                         boolean useFallbackLocale)

msgNoFormat

public static final java.lang.String msgNoFormat(java.lang.String key)

Convenience frontend that automatically compiles the path by getting the calling class from the current StackTrace. FIXME is this used anywhere? at least not in this class...

Parameters:

stackOffset - not needed any more and ignored, but kept in for backwards compatibility.

msgNoFormat

public static final java.lang.String msgNoFormat(java.lang.String key,
                                                 int stackOffset)

msgNoFormat

public static final java.lang.String msgNoFormat(java.lang.String key,
                                                 java.lang.String[] path)

Gets the matching message template string for key, etc.

Parameters:

key - the key (name) of the L10nResource to find

path - the names of the L10nBundles in which the matching resource should be searched

localeName - name of a locale (optional); if null the current one will be used

msgNoFormat

public static final java.lang.String msgNoFormat(java.lang.String key,
                                                 java.lang.String[] path,
                                                 java.lang.String localeName)

resolveLater

public static final L10n.UnresolvedMessage resolveLater(java.lang.String msg,
                                                        java.lang.Object[] parameters,
                                                        java.lang.Object[] participants)

resolveLater

public static final L10n.UnresolvedMessage resolveLater(java.lang.String msg,
                                                        java.lang.Object[] participants)

resolveLater

public static final L10n.UnresolvedMessage resolveLater(java.lang.String msg,
                                                        java.lang.Object participant)

validPack

public static final L10nPack validPack(java.lang.String key,
                                       java.lang.String[] path)

A valid L10nPack is where pack.getString(key)<>null

validPack

public static final L10nPack validPack(java.lang.String key,
                                       java.lang.String[] path,
                                       java.lang.String localeName)

getAutoPath

public static final java.lang.String[] getAutoPath()

Returns path compiled by using info from current StackTrace.

Parameters:

_stackOffset - not needed any more and ignored, but kept in for backwards compatibility.

getAutoPath

public static final java.lang.String[] getAutoPath(int _stackOffset)

getGetCallingClassNameImplementation

public static java.util.function.Supplier<java.lang.String> getGetCallingClassNameImplementation()

stringToKey

public static final java.lang.String stringToKey(java.lang.String _str)

Creates a usable L10n message key from a given String by removing spaces and not permitted characters and if given prepending a prefix.

stringToKey

public static final java.lang.String stringToKey(java.lang.String _str,
                                                 java.lang.String _prefix)

compilePath

public static final java.lang.String[] compilePath(java.lang.Object[] participants)

Compiles and returns a list of L10nBundle names. Die uebergebene Liste ist eine rohe Sammlung aller Objekte, die beteiligt sind an der Bundlesuche. Das koennen BOT's, BOs, Entitaeten, Objekte oder auch null sein. Die Rueckgabe ist eine konkrete Liste von Namen von Bundles, die auf keys durchsucht werden.

canonifyPackageName

public static final java.lang.String canonifyPackageName(java.lang.String s)

Removes '$' "sub"class parts from s.

addPathCompilerForClass

public static final void addPathCompilerForClass(java.lang.Class clazz,
                                                 L10nPathCompilerI comp)

Classes will create singleton instances of their special version of L10nPathCompilerI and add them with this method to the L10n list. A class may have multiple L10nPathCompilerIs assigned

removePathCompilerForClass

public static final void removePathCompilerForClass(java.lang.Class clazz,
                                                    L10nPathCompilerI comp)

FIXME (Currently) Not used. Deregisters the passed L10nPathCompilerI for the passed class. If the PathCompiler is not associated with the class, nothing is done.

Parameters:

clazz - The class for which the L10nPathCompilerI should be deregistered

comp - The L10nPathCompiler which should be deregistered.

firePathCompilersChanged

public static final void firePathCompilersChanged()

isOperational

public boolean isOperational()

Specified by:

isOperational in interface L10nPackProviderI

getPack

public static final L10nPack getPack(java.lang.String[] path,
                                     int index)

Loading the packs is a bit complex, because incomplete packs are possible with only a small part of the keys inside. These are then filled with the remaining keys by other L10n providers of lower priority. Therefore we always have to ask *all* providers for their packs and add their entries with fillInMissing. The strange algorithm is a trick to keep the roundtrips to the loading mechanism as small as possible: We don't go directly to the server for every single pack, but request the path and an index, so that on the first miss the whole chain can be loaded, because it is possible anyway that the next resources yield another miss.

getPack

public static final L10nPack getPack(java.lang.String[] path,
                                     int index,
                                     java.lang.String ln)

addPreloadL10nCacheFinishedListener

public static final void addPreloadL10nCacheFinishedListener(PreloadL10nCacheFinishedListenerI l)

preloadCache

public static final void preloadCache(L10nPackProviderI provider,
                                      L10nPack[] packsToPreload,
                                      java.lang.String ln)

recalcPath

public static final void recalcPath()

flushCache

public static final void flushCache()

flushCache

public static final void flushCache(java.lang.String[] bundles)

flushCache

public static final void flushCache(java.lang.String bundle)

getL10nViaString

public java.lang.String getL10nViaString()

Specified by:

getL10nViaString in interface L10nPackProviderI

getL10nPacks

public L10nPack[] getL10nPacks(java.lang.String[] bundles,
                               java.lang.String ln)

Specified by:

getL10nPacks in interface L10nPackProviderI

getL10nPack

public L10nPack getL10nPack(java.lang.String name,
                            java.lang.String ln)

Specified by:

getL10nPack in interface L10nPackProviderI

getL10nPath

public L10nPathEntry[] getL10nPath()

Specified by:

getL10nPath in interface L10nPackProviderI

internalGetL10nPack

public L10nPack internalGetL10nPack(java.lang.String name,
                                    java.lang.String ln)

Loads L10nPack from *.properties file resources via classpath and getResourceAsStream().

prependPackProvider

public static final void prependPackProvider(L10nPackProviderI p)

appendPackProvider

public static final void appendPackProvider(L10nPackProviderI p)

removePackProvider

public static final void removePackProvider(L10nPackProviderI p)

addLocaleChangeListener

public static final void addLocaleChangeListener(L10nLocaleChangeListenerI _lcl)

setDefaultLocale

public static final void setDefaultLocale(java.util.Locale l)

setCurrentLocaleProvider

public static final void setCurrentLocaleProvider(L10nCurrentLocaleProviderI p)

Sets the locale provider for the current Thread.

getCurrentLocaleProvider

public static final L10nCurrentLocaleProviderI getCurrentLocaleProvider()

Gets the locale provider for the current Thread.

getCurrentLocaleViaProvider

public static final java.util.Locale getCurrentLocaleViaProvider()

Returns the current locale for the current Thread.

getDefaultLocale

public static final java.util.Locale getDefaultLocale()

setDefaultLocaleName

public static final void setDefaultLocaleName(java.lang.String s)

getDefaultLocaleName

public static final java.lang.String getDefaultLocaleName()

isParentOf

public static final boolean isParentOf(java.util.Locale supposedParent,
                                       java.util.Locale supposedChild)

getLocaleFromString

public static final java.util.Locale getLocaleFromString(java.lang.String s)

getDecimalFormat

public static final L10nDecimalFormat getDecimalFormat()

Factory-Method for DecimalFormat objects, locale sensitive. If pattern is null, a standard pattern is build which matches locale settings, but stays lookalike the no-format setting on EN_US platforms (so no grouping etc) Note that if you give explicit Locale different from current, then caching does not apply.

Parameters:

_pattern - The DecimalFormat pattern to use (see JDK API Docs)

_locale - The designated Locale for this pattern

getDecimalFormat

public static final L10nDecimalFormat getDecimalFormat(java.lang.String _pattern)

getDecimalFormat

public static final L10nDecimalFormat getDecimalFormat(java.lang.String _pattern,
                                                       java.util.Locale _locale)

releaseDecimalFormat

public static final void releaseDecimalFormat(L10nDecimalFormat df)

formatDecimal

public static final java.lang.String formatDecimal(java.lang.Number n)

formatDecimal

public static final java.lang.String formatDecimal(java.lang.Number n,
                                                   java.lang.String pattern)

formatDecimal

public static final java.lang.String formatDecimal(java.lang.Number n,
                                                   java.lang.String pattern,
                                                   java.util.Locale _locale)

formatDecimalNT

public static final java.lang.String formatDecimalNT(java.lang.Number n,
                                                     java.lang.String pattern,
                                                     java.lang.String fallback)

null safe version of formatDecimal with fallback if number is null

formatDecimalNT

public static final java.lang.String formatDecimalNT(java.lang.Number n)

null safe version of formatDecimal with fallback if number is null

formatDecimalNT

public static final java.lang.String formatDecimalNT(java.lang.Number n,
                                                     java.lang.String pattern)

formatDecimalNT

public static final java.lang.String formatDecimalNT(java.lang.Number n,
                                                     java.lang.String pattern,
                                                     java.util.Locale locale)

formatDecimalNT

public static final java.lang.String formatDecimalNT(java.lang.Number n,
                                                     java.lang.String pattern,
                                                     java.util.Locale locale,
                                                     java.lang.String fallback)

parseDecimal

public static final java.math.BigDecimal parseDecimal(java.lang.String s)
                                               throws java.text.ParseException

Method to parse a L10n formatted Number in a String to the represented BigDecimal value.

Parameters:

s - the input string to parse

pattern - FIXME link to pattern description

_local - the locale of the source string, e.g. GERMAN for 12,3 or US for 12.3

Returns:

a bigdecimal with the value provided in the string s

Throws:

java.text.ParseException

parseDecimal

public static final java.math.BigDecimal parseDecimal(java.lang.String s,
                                                      java.lang.String pattern)
                                               throws java.text.ParseException

Throws:

java.text.ParseException

parseDecimal

public static final java.math.BigDecimal parseDecimal(java.lang.String s,
                                                      java.lang.String pattern,
                                                      java.util.Locale _locale)
                                               throws java.text.ParseException

Throws:

java.text.ParseException

parseDecimal

public static final java.math.BigDecimal parseDecimal(java.lang.String s,
                                                      java.lang.String[] patterns)
                                               throws MultipleParseException

Throws:

MultipleParseException

parseDecimal

public static final java.math.BigDecimal parseDecimal(java.lang.String s,
                                                      java.lang.String[] patterns,
                                                      java.util.Locale _locale)
                                               throws MultipleParseException

Throws:

MultipleParseException

parseDecimalNT

public static final java.math.BigDecimal parseDecimalNT(java.lang.String s)

wrapper for parseDecimal that throws no exception. if an exception is caught, fallback is returned, which defaults to null

parseDecimalNT

public static final java.math.BigDecimal parseDecimalNT(java.lang.String s,
                                                        java.lang.String pattern)

parseDecimalNT

public static final java.math.BigDecimal parseDecimalNT(java.lang.String s,
                                                        java.lang.String pattern,
                                                        java.math.BigDecimal fallback)

parseDecimalNT

public static final java.math.BigDecimal parseDecimalNT(java.lang.String s,
                                                        java.lang.String[] patterns)

wrapper for parseDecimal that throws no exception. if an exception is caught, fallback is returned, which defaults to null

parseDecimalNT

public static final java.math.BigDecimal parseDecimalNT(java.lang.String s,
                                                        java.lang.String[] patterns,
                                                        java.math.BigDecimal fallback)

getDateFormat

public static final L10nDateFormat getDateFormat()

getDateFormat

public static final L10nDateFormat getDateFormat(java.lang.String _pattern)

getDateFormat

public static final L10nDateFormat getDateFormat(java.lang.String _pattern,
                                                 java.util.Locale _locale)

getDateFormat

public static final L10nDateFormat getDateFormat(java.lang.String _pattern,
                                                 java.util.Locale _locale,
                                                 java.util.TimeZone timeZone)

releaseDateFormat

public static final void releaseDateFormat(L10nDateFormat df)

formatDate

public static final java.lang.String formatDate(java.util.Date d)

usage with locale not recommended as they are not being cached, which leads to poor performance. the locale can instead be stored in the pattern-string

formatDate

public static final java.lang.String formatDate(java.util.Date d,
                                                java.lang.String pattern)

formatDate

public static final java.lang.String formatDate(java.util.Date d,
                                                java.lang.String pattern,
                                                java.util.Locale _locale)

formatDate

public static final java.lang.String formatDate(java.util.Date d,
                                                java.lang.String pattern,
                                                java.util.Locale _locale,
                                                java.util.TimeZone timeZone)

formatDateNT

public static final java.lang.String formatDateNT(java.util.Date d,
                                                  java.lang.String pattern,
                                                  java.lang.String fallback)

null safe version of formatDate with fallback if date is null

formatDateNT

public static final java.lang.String formatDateNT(java.util.Date d)

null safe version of formatDate with fallback if date is null

formatDateNT

public static final java.lang.String formatDateNT(java.util.Date d,
                                                  java.lang.String pattern)

formatDateNT

public static final java.lang.String formatDateNT(java.util.Date d,
                                                  java.lang.String pattern,
                                                  java.util.Locale locale)

formatDateNT

public static final java.lang.String formatDateNT(java.util.Date d,
                                                  java.lang.String pattern,
                                                  java.util.Locale locale,
                                                  java.lang.String fallback)

parseDate

public static final java.util.Date parseDate(java.lang.String s)
                                      throws java.text.ParseException

usage with locale not recommended as they are not being cached, which leads to poor performance. the locale can instead be stored in the pattern-string

Throws:

java.text.ParseException

parseDate

public static final java.util.Date parseDate(java.lang.String s,
                                             java.lang.String pattern)
                                      throws java.text.ParseException

Throws:

java.text.ParseException

parseDate

public static final java.util.Date parseDate(java.lang.String s,
                                             java.lang.String pattern,
                                             java.util.Locale _locale)
                                      throws java.text.ParseException

Throws:

java.text.ParseException

parseDate

public static final java.util.Date parseDate(java.lang.String s,
                                             java.lang.String pattern,
                                             java.util.Locale _locale,
                                             java.util.TimeZone timeZone)
                                      throws java.text.ParseException

Throws:

java.text.ParseException

parseDateNT

public static final java.util.Date parseDateNT(java.lang.String s)

wrapper for parseDate that throws no exception. if an exception is caught, fallback is returned, which defaults to null

parseDateNT

public static final java.util.Date parseDateNT(java.lang.String s,
                                               java.lang.String pattern)

parseDateNT

public static final java.util.Date parseDateNT(java.lang.String s,
                                               java.lang.String pattern,
                                               java.util.Date fallback)

parseDateNT

public static final java.util.Date parseDateNT(java.lang.String s,
                                               java.lang.String[] patterns)

wrapper for parseDate that throws no exception. if an exception is caught, fallback is returned, which defaults to null

parseDateNT

public static final java.util.Date parseDateNT(java.lang.String s,
                                               java.lang.String[] patterns,
                                               java.util.Date fallback)

parseDate

public static final java.util.Date parseDate(java.lang.String s,
                                             java.lang.String[] patterns)
                                      throws MultipleParseException

usage with locale not recommended as they are not being cached which leads to poor performance. the locale can instead be stored in the pattern-string

Throws:

MultipleParseException

parseDate

public static final java.util.Date parseDate(java.lang.String s,
                                             java.lang.String[] patterns,
                                             java.util.Locale _locale)
                                      throws MultipleParseException

Throws:

MultipleParseException

parseDate

public static final java.util.Date parseDate(java.lang.String s,
                                             java.lang.String[] patterns,
                                             java.util.Locale _locale,
                                             java.util.TimeZone timeZone)
                                      throws MultipleParseException

Throws:

MultipleParseException

parseISO8601

public static final java.util.Date parseISO8601(java.lang.String s)
                                         throws java.time.format.DateTimeParseException

Parses an ISO8601:2019 conform Datetime text, returning the parameter as Date. See java.time.OffsetDateTime#parse(String). Expected formats are yyyy-MM-dd'T'HH:mm:ss.SSSX or yyyy-MM-dd'T'HH:mm:ssX The resolution of the result will be limited by the maximum resolution possible of Date, i.e. milliseconds. Nanosecond information of the input will be ignored.

Parameters:

s - an ISO conformant String, not null.

Returns:

a nonnull Date that represents the same point in time as the parameter.

Throws:

java.time.format.DateTimeParseException

parseISO8601NT

public static final java.util.Date parseISO8601NT(java.lang.String s)

Non-throw version of parseISO8601(String), returning the fallback if the given String is not a valid ISO date

parseISO8601NT

public static final java.util.Date parseISO8601NT(java.lang.String s,
                                                  java.util.Date fallback)

parseISODate

public static final java.util.Date parseISODate(java.lang.String s)
                                         throws MultipleParseException

Parses the given parameter as a ISO8601 like date, e.g. yyyy-MM-dd'T'HH:mm:ss.SSSX or yyyy-MM-dd, while trying to be a bit more tolerant regarding formatting errors. Please note that this might cause unexpected results. If the input does not declare a timezone, then the default timezone of the running JVM is used. This can cause the same input to represent a different points in time for different clients/servers. The resolution of the parseable string is limited to milliseconds. Nanosecond information of the input will interpreted as milliseconds.

Parameters:

s - the date(time) to parse, nonnull.

Returns:

the parsed input as Date, nonnull.

Throws:

MultipleParseException

parseISODateNT

public static final java.util.Date parseISODateNT(java.lang.String s)

wrapper for parseISODate thet throws no exception. if an exception is caught, fallback is returned, which defaults to null

parseISODateNT

public static final java.util.Date parseISODateNT(java.lang.String s,
                                                  java.util.Date fallback)

formatISODate

public static final java.lang.String formatISODate(java.util.Date d)

Formats the given Date in ISO8601 like format, with the 'T' replaced by a space.

formatISODateNT

public static final java.lang.String formatISODateNT(java.util.Date d)

null safe version of formatISODate with fallback if date is null

formatISODateNT

public static final java.lang.String formatISODateNT(java.util.Date d,
                                                     java.lang.String fallback)

formatISO8601

public static final java.lang.String formatISO8601(java.util.Date date)

Returns the given Date in an ISO8601:2019 conformant String. Can be parsed by parseISO8601(String). e.g. 2021-02-25T14:15:00.001Z or 2021-02-25T15:15:00.001+01:00

Parameters:

date - the date to format, not null.

withLocalTimeZone - defaults to false, which will return the date in Zulu time, aka GMT+0. If true, the current default timezone is used to format the date. The represented point in time will be identical in either case.

Returns:

the provided Date in an ISO8601 conform string including timezone.

See Also:

OffsetDateTime.ofInstant(Instant, ZoneId)

formatISO8601

public static final java.lang.String formatISO8601(java.util.Date date,
                                                   boolean withLocalTimeZone)

formatISO8601NT

public static final java.lang.String formatISO8601NT(java.util.Date date)

Not throwing version of #formatISO8601Date(Date, boolean). Defaults to the empty String on error.

formatISO8601NT

public static final java.lang.String formatISO8601NT(java.util.Date date,
                                                     java.lang.String fallback)

formatISO8601NT

public static final java.lang.String formatISO8601NT(java.util.Date date,
                                                     java.lang.String fallback,
                                                     boolean withLocalTimeZone)

getTimespanFormat

public static final L10nTimespanFormat getTimespanFormat()

getTimespanFormat

public static final L10nTimespanFormat getTimespanFormat(java.lang.String pattern)

getTimespanFormat

public static final L10nTimespanFormat getTimespanFormat(java.lang.String pattern,
                                                         java.util.Locale locale)

releaseTimespanFormat

public static final void releaseTimespanFormat(L10nTimespanFormat df)

formatTimespan

public static final java.lang.String formatTimespan(java.lang.Number _ts)

Parameters:

_ts - timespan in milliseconds

formatTimespan

public static final java.lang.String formatTimespan(java.lang.Number _ts,
                                                    java.lang.String _pattern)

formatTimespan

public static final java.lang.String formatTimespan(java.lang.Number _ts,
                                                    java.lang.String _pattern,
                                                    java.util.Locale _locale)

parseTimespan

public static final java.lang.Long parseTimespan(java.lang.String _str)
                                          throws java.text.ParseException

Throws:

java.text.ParseException

parseTimespan

public static final java.lang.Long parseTimespan(java.lang.String _str,
                                                 java.lang.String _pattern)
                                          throws java.text.ParseException

Throws:

java.text.ParseException

parseTimespan

public static final java.lang.Long parseTimespan(java.lang.String _str,
                                                 java.lang.String _pattern,
                                                 java.util.Locale _locale)
                                          throws java.text.ParseException

Throws:

java.text.ParseException

parseTimespan

public static final java.lang.Long parseTimespan(java.lang.String _str,
                                                 java.lang.String[] _patterns)
                                          throws MultipleParseException

Throws:

MultipleParseException

parseTimespan

public static final java.lang.Long parseTimespan(java.lang.String _str,
                                                 java.lang.String[] _patterns,
                                                 java.util.Locale _locale)
                                          throws MultipleParseException

Throws:

MultipleParseException

formatDuration

public static final java.lang.String formatDuration(javax.xml.datatype.Duration _dur)

formatDuration

public static final java.lang.String formatDuration(javax.xml.datatype.Duration _dur,
                                                    java.lang.String _pattern)

formatDuration

public static final java.lang.String formatDuration(javax.xml.datatype.Duration _dur,
                                                    java.lang.String _pattern,
                                                    java.util.Locale _locale)

parseDuration

public static final javax.xml.datatype.Duration parseDuration(java.lang.String s)

getWaehrungsSymbol

public static final java.lang.String getWaehrungsSymbol(java.lang.String isocode)

getCollator

public static final java.text.Collator getCollator()

returns a Collator for the current default locale, but makes it space sensitive

getCollator

public static final java.text.Collator getCollator(java.util.Locale l)

getCollator

public static final java.text.Collator getCollator(java.util.Locale l,
                                                   java.lang.String parms)

splitPath

public static final java.lang.String[] splitPath(java.lang.String _path)

Splits the given _path on '/' but ignoring '/' insided of $R{...} tags.

getLanguageSeperatedByDash

public static final java.lang.String getLanguageSeperatedByDash(java.lang.String _str,
                                                                int _lang)

this method takes a String where the languages are seperated by | it returns the _lang'th language of this string, beginning at 1