util

Class UtilGlobals

java.lang.Object

util.UtilGlobals

public class UtilGlobals
extends java.lang.Object

Utilities that may be used whole-system-wide

Version:

2.1

Author:

SB-Yan, nicklien

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	UtilGlobals.GUI

Field Summary

Fields

Modifier and Type	Field and Description
static AFDateFormat	c_afDateFormat
static java.text.DecimalFormat	c_decimalFormat
static java.text.NumberFormat	c_defaultCurrencyFormat
static java.text.NumberFormat	c_defaultDecimalFormat
static java.util.Locale	c_defaultLocale
static java.text.DateFormat	c_defaultTWDateFormat
static java.text.DateFormatSymbols	c_localizedDateFormatSymbols
static AFDateFormat.TaiwanDateFormat	c_twDateFormat
static boolean	DEBUG
static int	LOG_MODE_DEFAULT
static int	LOG_MODE_NONE
static java.util.Locale	m_currentLocale
static java.util.ResourceBundle	m_formLabels

Constructor Summary

Constructors

Constructor and Description
UtilGlobals()

Method Summary

Modifier and Type	Method and Description
static void	applyComponentOrientation(java.awt.Component jcmp)
static void	changeFont(java.awt.Container container, java.awt.Font font)
static void	changeFont(javax.swing.JDialog dlg, java.awt.Font font)
static void	changeMenuFont(javax.swing.MenuElement menuElement, java.awt.Font font)
static java.util.ResourceBundle	getBundle(java.lang.String bundleNamePrefix)
static java.lang.String	getCurrentTime()
static java.util.Locale	getLocale()
static java.util.PropertyResourceBundle	getPropertyResourceBundle(java.lang.String name)
static java.lang.String	getString(java.lang.String key)
static boolean	isLeftToRight()
static java.util.Locale	parseLocale(java.lang.String localeString)
static void	setEnabledRecursively(java.awt.Component comp, boolean b) other UI updating utilities (Functions to set...
static void	setLanguage(java.lang.String lang)
static void	setLocale(java.util.Locale locale)
static byte[]	simpleCipherDecrypt(byte[] b)
static java.lang.String	simpleCipherDecryptWithBase64(java.lang.String s, java.lang.String nameOfTheItem) Gets the the original string from the string result of simpleCipherEncryptWithBase64(..)
static java.lang.String	simpleCipherDecryptWithBase64(java.lang.String s, java.lang.String messageForException, int logMode, boolean isToReturnInputIfBase64NotDecoded) Gets the the original string from the result of simpleCipherEncryptWithBase64(..)
static byte[]	simpleCipherEncrypt(byte[] b)
static java.lang.String	simpleCipherEncryptWithBase64(java.lang.String s) Encrypts a string by a specific simple way, and then return it encoded with Base64.

Methods inherited from class java.lang.Object

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

Field Detail

DEBUG

public static final boolean DEBUG

See Also:

Constant Field Values

c_defaultLocale

public static final java.util.Locale c_defaultLocale

m_currentLocale

public static java.util.Locale m_currentLocale

m_formLabels

public static java.util.ResourceBundle m_formLabels

c_decimalFormat

public static java.text.DecimalFormat c_decimalFormat

c_defaultDecimalFormat

public static java.text.NumberFormat c_defaultDecimalFormat

c_defaultCurrencyFormat

public static java.text.NumberFormat c_defaultCurrencyFormat

c_localizedDateFormatSymbols

public static java.text.DateFormatSymbols c_localizedDateFormatSymbols

c_afDateFormat

public static AFDateFormat c_afDateFormat

c_twDateFormat

public static AFDateFormat.TaiwanDateFormat c_twDateFormat

c_defaultTWDateFormat

public static java.text.DateFormat c_defaultTWDateFormat

LOG_MODE_NONE

public static final int LOG_MODE_NONE

See Also:

Constant Field Values

LOG_MODE_DEFAULT

public static final int LOG_MODE_DEFAULT

See Also:

Constant Field Values

Constructor Detail

UtilGlobals

public UtilGlobals()

Method Detail

setLanguage

public static void setLanguage(java.lang.String lang)

Parameters:

lang - String - locale name; null will be interpretted as the JVM default locale

parseLocale

public static java.util.Locale parseLocale(java.lang.String localeString)

getLocale

public static java.util.Locale getLocale()

setLocale

public static void setLocale(java.util.Locale locale)

getBundle

public static java.util.ResourceBundle getBundle(java.lang.String bundleNamePrefix)

getPropertyResourceBundle

public static java.util.PropertyResourceBundle getPropertyResourceBundle(java.lang.String name)

getString

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

changeFont

public static void changeFont(java.awt.Container container,
                              java.awt.Font font)

changeFont

public static void changeFont(javax.swing.JDialog dlg,
                              java.awt.Font font)

changeMenuFont

public static void changeMenuFont(javax.swing.MenuElement menuElement,
                                  java.awt.Font font)

setEnabledRecursively

public static void setEnabledRecursively(java.awt.Component comp,
                                         boolean b)

other UI updating utilities (Functions to set...(related to UI related object types))

getCurrentTime

public static java.lang.String getCurrentTime()

simpleCipherEncrypt

public static final byte[] simpleCipherEncrypt(byte[] b)
                                        throws java.lang.Exception

Throws:

java.lang.Exception

simpleCipherDecrypt

public static final byte[] simpleCipherDecrypt(byte[] b)
                                        throws java.lang.Exception

Throws:

java.lang.Exception

simpleCipherEncryptWithBase64

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

Encrypts a string by a specific simple way, and then return it encoded with Base64.

Parameters:

s - String the original string. (s.length >= 0) must be true.

Returns:

String the original string encrypted by a specific simple way, and then encoded with Base64. (s.length > 0) must be true, if the parameter is valid and no unexpected exception happens during the ciphering process; "" otherwise.

simpleCipherDecryptWithBase64

public static java.lang.String simpleCipherDecryptWithBase64(java.lang.String s,
                                                             java.lang.String nameOfTheItem)

Gets the the original string from the string result of simpleCipherEncryptWithBase64(..), with some exception handling/reporting extensions. It's a specific usage of simpleCipherDecryptWithBase64(String, String), suitable for most cases for a password property stored in a .properties file; In this usage the backward-compatibility for a password property (stored as plain text in older versions and as Encypted/Encoded string in newer ones) is achieved for it will return the exact string as the input if it's not Base64-encoded.

See Also:

simpleCipherDecryptWithBase64(String, String, int, boolean)

simpleCipherDecryptWithBase64

public static java.lang.String simpleCipherDecryptWithBase64(java.lang.String s,
                                                             java.lang.String messageForException,
                                                             int logMode,
                                                             boolean isToReturnInputIfBase64NotDecoded)

Gets the the original string from the result of simpleCipherEncryptWithBase64(..), with some exception handling/reporting extensions.

Examples:

 simpleCipherDecryptWithBase64(anUserPasswordStoredWhichIsNotEncryptedAndEncoded,
                              "Oh My God!\nThe property 'UserPassword'",
                              LOG_MODE_DEFAULT, true);
   will produce a message reporting exception as follows:
   Oh My God!
   The property 'userPasswordStored' can't be decoded by Base64, use its original value
 

Parameters:

s - String (A) the result of the original string encrypted by simpleCipherEncrypt, and then encoded with Base64; (s.length > 0) must be true. (B) ""(empty string) (C) a string which is not encrypted in simpleCipherEncrypt, and then encoded with Base64; (s.length > 0) must be true. (D) none of above (non-empty and not encoded with Base64)

nameOfTheItem - the name of the item being decrypted, it's to be inserted in the front of the exception warning message to aware the user which string is unable to be decrypted - if it's not null...; "The-string-being-decrypted" is used if it's null.

logMode - LOG_MODE_NONE to cause it to produce no warning message; LOG_MODE_DEFAULT to cause it to warn about (B),(C),(D) cases, and print the stack trace for any exception during the Cipher invocation.

Returns:

String (A) the original string, and (its length >= 0) must be true, if no unexpected exception happens during the deciphering process; ""(empty string) otherwise. (B) "" (empty string). (D) the exact string as the input if isToReturnInputIfBase64NotDecoded is true... In this option the backward-compatibility for a password property (stored as plain text in older versions and as Encypted/Encoded string in newer ones) is achieved for it will return the exact string as the input if it's not Base64-encoded. same as (B) otherwise; (C) same as (D) (sometimes the un-encoded plain text can be decoded by Base64, so we probably need (C) be the same as (D))

isLeftToRight

public static boolean isLeftToRight()

applyComponentOrientation

public static void applyComponentOrientation(java.awt.Component jcmp)