|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectschmitzm.lang.LangUtil
public class LangUtil
Diese Klasse stellt Hilfsfunktionen fuer Basisoperationen bereit.
Field Summary | |
---|---|
static ResourceProvider |
RESOURCE
ResourceProvider , der die Lokalisation fuer Komponenten
des Package schmitzm.lang zur Verfuegung stellt. |
Constructor Summary | |
---|---|
LangUtil()
|
Method Summary | ||
---|---|---|
static Vector |
addObjectsToVector(Object[] obj,
Vector vec)
Fuegt alle Elemente eines Arrays in einen Vector ein. |
|
static boolean |
checkEnumValue(Class<? extends Enum> enumClass,
String fieldName)
Prueft, ob ein Enum ein spezielles Feld besitzt. |
|
static boolean |
checkIdentifier(String identifier)
Prueft einen Identifier auf Korrektheit. |
|
static void |
checkIdentifierAndError(String identifier)
Prueft einen Identifier auf Korrektheit. |
|
static boolean[] |
cloneArray(boolean[] source,
boolean... replElem)
Kopiert einen Array und belegt (einige) Elemente direkt neu. |
|
static byte[] |
cloneArray(byte[] source,
byte... replElem)
Kopiert einen Array und belegt (einige) Elemente direkt neu. |
|
static char[] |
cloneArray(char[] source,
char... replElem)
Kopiert einen Array und belegt (einige) Elemente direkt neu. |
|
static double[] |
cloneArray(double[] source,
double... replElem)
Kopiert einen Array und belegt (einige) Elemente direkt neu. |
|
static float[] |
cloneArray(float[] source,
float... replElem)
Kopiert einen Array und belegt (einige) Elemente direkt neu. |
|
static int[] |
cloneArray(int[] source,
int... replElem)
Kopiert einen Array und belegt (einige) Elemente direkt neu. |
|
static long[] |
cloneArray(long[] source,
long... replElem)
Kopiert einen Array und belegt (einige) Elemente direkt neu. |
|
static short[] |
cloneArray(short[] source,
short... replElem)
Kopiert einen Array und belegt (einige) Elemente direkt neu. |
|
static
|
cloneArray(T[] source,
boolean replNull,
T... replElem)
Kopiert einen Array (aber nicht dessen Elemente). |
|
static
|
cloneArray(T[] source,
T... replElem)
Kopiert einen Array (aber nicht dessen Elemente). |
|
static Object |
createArray(int... size)
Erzeugt einen mehr-dimensionalen Object -Array. |
|
static double[] |
createArray(int count,
double value)
Erzeugt einen vorbelegten Array. |
|
static float[] |
createArray(int count,
float value)
Erzeugt einen vorbelegten Array. |
|
static int[] |
createArray(int count,
int value)
Erzeugt einen vorbelegten Array. |
|
static long[] |
createArray(int count,
long value)
Erzeugt einen vorbelegten Array. |
|
static String[] |
createArray(int count,
String value)
Erzeugt einen vorbelegten Array. |
|
static ClassLoader |
createClassLoader(URL searchPath)
Erzeugt einen neuen URLClassLoader , der vom
System-ClassLoaders
abgeleitet ist. |
|
static ClassLoader |
createClassLoader(URL[] searchPath)
Erzeugt einen neuen URLClassLoader , der vom
System-ClassLoaders
abgeleitet ist. |
|
static Logger |
createLogger(Object object)
Erzeugt einen Log4j-Logger fuer ein Objekt. |
|
static boolean[] |
extendArray(boolean[] source,
boolean... newElem)
Erweitert einen Array. |
|
static byte[] |
extendArray(byte[] source,
byte... newElem)
Erweitert einen Array. |
|
static char[] |
extendArray(char[] source,
char... newElem)
Erweitert einen Array. |
|
static double[] |
extendArray(double[] source,
double... newElem)
Erweitert einen Array. |
|
static float[] |
extendArray(float[] source,
float... newElem)
Erweitert einen Array. |
|
static int[] |
extendArray(int[] source,
int... newElem)
Erweitert einen Array. |
|
static long[] |
extendArray(long[] source,
long... newElem)
Erweitert einen Array. |
|
static short[] |
extendArray(short[] source,
short... newElem)
Erweitert einen Array. |
|
static
|
extendArray(T[] source,
T... newElem)
Erweitert einen Array. |
|
static String |
extendPackagePath(Class clazz,
String pathExt)
Liefert das Package einer Klasse erweitert um einen relativen Pfad in Punkt-Notation. |
|
static long |
gc()
Ruft die Java Garbage Collection auf. |
|
static long |
gcTotal()
Ruft die Java Garbage Collection solange auf, bis kein Speicher mehr freigegeben werden kann. |
|
static int |
getArrayDimension(Object array)
Liefert die Dimension eines multi-dimensionalen Object -Array. |
|
static int[] |
getArrayLength(Object array)
Liefert die Groessen der einzelnen Dimensionen eines multi-dimensionalen Object -Array. |
|
static Object |
getArrayValue(Object array,
int... coord)
Liefert einen Wert aus einem multi-dimensionalen Object -Array. |
|
static String[] |
getClassNames(Class[] clazz,
boolean simple)
Liefert die Klassen-Namen zu einem Array von Klassen. |
|
static String |
getSimpleClassName(Object object)
Liefert den einfachen Namen einer Klasse (ohne Package) oder den String "null", falls das Objekt null ist |
|
static Class |
loadClass(String clazz,
URL searchPath)
Laed eine Klasse. |
|
static Class |
loadClass(String clazz,
URL[] searchPath)
Laed eine Klasse. |
|
static Class |
loadPreferredClass(String classname,
URL searchPath)
Laed eine Klasse derart das Klassen im Cache ignoriert werden. |
|
static Object |
loadPreferredObject(String classname,
Object... param)
Laed eine Klasse neu und erzeugt eine Objekt-Instanz. |
|
static Object |
loadPreferredObject(String classname,
URL searchPath,
Object... param)
Laed eine Klasse neu und erzeugt eine Objekt-Instanz. |
|
static void |
logDebugError(Category logger,
Object mess,
Throwable err)
Erzeugt einen Error- und einen Debug-Eintrag in einem Logger. |
|
static void |
logDebugError(Category logger,
Throwable err)
Erzeugt einen Error- und einen Debug-Eintrag in einem Logger. |
|
static void |
logDebugWarn(Category logger,
Object mess,
Throwable err)
Erzeugt einen Warn- und einen Debug-Eintrag in einem Logger. |
|
static void |
logDebugWarn(Category logger,
Throwable err)
Erzeugt einen Warn- und einen Debug-Eintrag in einem Logger. |
|
static int |
max(Collection<Integer>... collections)
Returns the maximum value of some integer collections. |
|
static int |
max(int defMaxValue,
Collection<Integer>... collections)
Returns the maximum value of some integer collections. |
|
static int |
min(Collection<Integer>... collections)
Returns the minimum value of some integer collections. |
|
static int |
min(int defMinValue,
Collection<Integer>... collections)
Returns the minimum value of some integer collections. |
|
static String |
replaceTabulators(String source,
int tabLen)
Ersetzt alle Tabulator-Vorkommen in einem String durch Leerzeichen. |
|
static Collection<Number> |
round(Collection<Number> values,
int digits,
int... mode)
Rundet alle Werte einer Collection auf Nach- oder Vorkommastellen. |
|
static double |
round(double value,
int digits,
int... mode)
Rundet einen Wert auf Nach- oder Vorkommastellen. |
|
static void |
setArrayValue(Object array,
Object value,
int... coord)
Setzt einen Wert aus einem multi-dimensionalen Object -Array. |
|
static void |
sort(Object[] objects)
Sortiert einen Array aus beliebigen Objekten nach der natuerlichen Sortierung ihrer toString() -Werte. |
|
static String |
stringConcat(String... str)
Haengt eine beliebige Anzahl von Strings hintereinander. |
|
static String |
stringConcatWithSep(String sep,
String... str)
Haengt eine beliebige Anzahl von Strings hintereinander und fuegt zwischen den Strings einen Trenner ein. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static ResourceProvider RESOURCE
ResourceProvider
, der die Lokalisation fuer Komponenten
des Package schmitzm.lang
zur Verfuegung stellt. Diese sind
in properties-Dateien unter schmitzm.lang.resource.locales
hinterlegt.
Constructor Detail |
---|
public LangUtil()
Method Detail |
---|
public static String getSimpleClassName(Object object)
null
ist
object
- ein Objektniemals
- null
public static boolean checkEnumValue(Class<? extends Enum> enumClass, String fieldName)
Enum
ein spezielles Feld besitzt.
enumClass
- enum typfieldName
- feld namepublic static Vector addObjectsToVector(Object[] obj, Vector vec)
Vector
ein. Wird als Vector
null
angegeben, wird ein neuer Vector erzeugt.
obj
- einzufuegende Objektevec
- Vector in den die Elemente eingefuegt werden (kann null
sein)
vec
oder eine neue Vector
-Instanzpublic static String replaceTabulators(String source, int tabLen)
source
- Quell-StringtabLen
- Anzahl an Zeichen die ein Tabulator darstelltpublic static String stringConcat(String... str)
str
- aneinanderzuhaengende Stingspublic static String stringConcatWithSep(String sep, String... str)
sep
- Trennerstr
- aneinanderzuhaengende Stingspublic static int[] createArray(int count, int value)
count
- Groesse des Arraysvalue
- Wert mit dem die Elemente vorbelegt werdenpublic static long[] createArray(int count, long value)
count
- Groesse des Arraysvalue
- Wert mit dem die Elemente vorbelegt werdenpublic static float[] createArray(int count, float value)
count
- Groesse des Arraysvalue
- Wert mit dem die Elemente vorbelegt werdenpublic static double[] createArray(int count, double value)
count
- Groesse des Arraysvalue
- Wert mit dem die Elemente vorbelegt werdenpublic static String[] createArray(int count, String value)
count
- Groesse des Arraysvalue
- Wert mit dem die Elemente vorbelegt werdenpublic static Object createArray(int... size)
Object
-Array.
size
- Groesse der Array-Dimensionen
Object[]..[]
public static int getArrayDimension(Object array)
Object
-Array.
array
- multi-dim. Array (Instanz von Object[]..[]
)
ArrayIndexOutOfBoundsException
- wenn das 0te Element in einer
Dimension mit null
belegt istpublic static int[] getArrayLength(Object array)
Object
-Array.
array
- multi-dim. Array (Instanz von Object[]..[]
)
ArrayIndexOutOfBoundsException
- wenn das 0te Element in einer
Dimension mit null
belegt istpublic static Object getArrayValue(Object array, int... coord)
Object
-Array.
array
- multi-dim. Array (Instanz von Object[]..[]
)coord
- Koordinaten des Arrays
ArrayIndexOutOfBoundsException
- wenn eine fehlerhafte Koordinate
angegeben wirdpublic static void setArrayValue(Object array, Object value, int... coord)
Object
-Array.
array
- multi-dim. Array (Instanz von Object[]..[]
)value
- zu setzender Wert (Instanz von Object[]..[]
)coord
- Koordinaten des Arrays
ArrayIndexOutOfBoundsException
- wenn eine fehlerhafte Koordinate
angegeben wirdpublic static <T> T[] cloneArray(T[] source, boolean replNull, T... replElem)
replNull
auf false
gesetzt, werden null
-Werte in replElem
ignoriert. So ist es z.B. moeglich, nur das 4. und 5. Element im neuen
Array neu zu belegen und die davor liegenden Elemente unangetastet zu lassen.
source
- zu kopierender ArrayreplNull
- Bestimmt, ob null
-Elemente von replElem
im neuen Array gesetzt werden (true
) oder nichtreplElem
- Elemente (beginnend bei Index 0), die nach dem Kopieren
im Array neu gesetzt werden
max(source.length, replElem.length)
public static <T> T[] cloneArray(T[] source, T... replElem)
source
- zu kopierender ArrayreplElem
- Elemente (beginnend bei Index 0), die nach dem Kopieren
im Array neu gesetzt werden
max(source.length, replElem.length)
public static long[] cloneArray(long[] source, long... replElem)
source
- zu kopierender ArrayreplElem
- Elemente (beginnend bei Index 0), die nach dem Kopieren
im Array neu gesetzt werden
max(source.length, replElem.length)
public static int[] cloneArray(int[] source, int... replElem)
source
- zu kopierender ArrayreplElem
- Elemente (beginnend bei Index 0), die nach dem Kopieren
im Array neu gesetzt werden
max(source.length, replElem.length)
public static short[] cloneArray(short[] source, short... replElem)
source
- zu kopierender ArrayreplElem
- Elemente (beginnend bei Index 0), die nach dem Kopieren
im Array neu gesetzt werden
max(source.length, replElem.length)
public static byte[] cloneArray(byte[] source, byte... replElem)
source
- zu kopierender ArrayreplElem
- Elemente (beginnend bei Index 0), die nach dem Kopieren
im Array neu gesetzt werden
max(source.length, replElem.length)
public static double[] cloneArray(double[] source, double... replElem)
source
- zu kopierender ArrayreplElem
- Elemente (beginnend bei Index 0), die nach dem Kopieren
im Array neu gesetzt werden
max(source.length, replElem.length)
public static float[] cloneArray(float[] source, float... replElem)
source
- zu kopierender ArrayreplElem
- Elemente (beginnend bei Index 0), die nach dem Kopieren
im Array neu gesetzt werden
max(source.length, replElem.length)
public static boolean[] cloneArray(boolean[] source, boolean... replElem)
source
- zu kopierender ArrayreplElem
- Elemente (beginnend bei Index 0), die nach dem Kopieren
im Array neu gesetzt werden
max(source.length, replElem.length)
public static char[] cloneArray(char[] source, char... replElem)
source
- zu kopierender ArrayreplElem
- Elemente (beginnend bei Index 0), die nach dem Kopieren
im Array neu gesetzt werden
max(source.length, replElem.length)
public static <T> T[] extendArray(T[] source, T... newElem)
source
- zu kopierender ArraynewElem
- Elemente, die an das Ende des Arrays angehaengt werden
source.length + newElem.length
public static long[] extendArray(long[] source, long... newElem)
source
- zu kopierender ArraynewElem
- Elemente, die an das Ende des Arrays angehaengt werden
source.length + newElem.length
public static int[] extendArray(int[] source, int... newElem)
source
- zu kopierender ArraynewElem
- Elemente, die an das Ende des Arrays angehaengt werden
source.length + newElem.length
public static short[] extendArray(short[] source, short... newElem)
source
- zu kopierender ArraynewElem
- Elemente, die an das Ende des Arrays angehaengt werden
source.length + newElem.length
public static byte[] extendArray(byte[] source, byte... newElem)
source
- zu kopierender ArraynewElem
- Elemente, die an das Ende des Arrays angehaengt werden
source.length + newElem.length
public static double[] extendArray(double[] source, double... newElem)
source
- zu kopierender ArraynewElem
- Elemente, die an das Ende des Arrays angehaengt werden
source.length + newElem.length
public static float[] extendArray(float[] source, float... newElem)
source
- zu kopierender ArraynewElem
- Elemente, die an das Ende des Arrays angehaengt werden
source.length + newElem.length
public static boolean[] extendArray(boolean[] source, boolean... newElem)
source
- zu kopierender ArraynewElem
- Elemente, die an das Ende des Arrays angehaengt werden
source.length + newElem.length
public static char[] extendArray(char[] source, char... newElem)
source
- zu kopierender ArraynewElem
- Elemente, die an das Ende des Arrays angehaengt werden
source.length + newElem.length
public static String[] getClassNames(Class[] clazz, boolean simple)
clazz
- Klassensimple
- gibt an, ob der einfache Klassenname (true
) oder der
komplette Klassenname inkl. Paketname (false
)
zurueckgegeben wird.public static long gc()
Runtime.gc()
,
Runtime.freeMemory()
public static long gcTotal()
gc()
public static ClassLoader createClassLoader(URL[] searchPath)
URLClassLoader
, der vom
System-ClassLoaders
abgeleitet ist.
searchPath
- Pfade, in denen der ClassLoader nach Klassen suchtpublic static ClassLoader createClassLoader(URL searchPath)
URLClassLoader
, der vom
System-ClassLoaders
abgeleitet ist.
searchPath
- Pfad, in denm der ClassLoader nach Klassen suchtpublic static Class loadClass(String clazz, URL[] searchPath) throws ClassNotFoundException
ClassLoader
erzeugt.
clazz
- Klassenname (inkl. Paket)searchPath
- Pfade, in denen der ClassLoader nach Klassen sucht
(wenn null
, wird der
System-ClassLoader
zum Laden der Klasse verwendet)
ClassNotFoundException
public static Class loadClass(String clazz, URL searchPath) throws ClassNotFoundException
ClassLoader
erzeugt.
clazz
- Klassenname (inkl. Paket)searchPath
- Pfad, in dem der ClassLoader nach Klassen sucht
(wenn null
, wird der
System-ClassLoader
zum Laden der Klasse verwendet)
ClassNotFoundException
public static Class loadPreferredClass(String classname, URL searchPath) throws ClassNotFoundException
searchPath
eine Verzeichnis "META-INF" vorhanden ist.
Darin muss eine Datei "PREFERRED.LIST" sein. Wie genau diese Datei aufgebaut sein muss, lässt
sich in der Dokumentation des PreferredClassLoaders
nachlesen.
classname
- Klassenname (inkl. Paket)searchPath
- Pfad, in dem der ClassLoader nach Klassen sucht
(wenn null
, wird der System-Klassenpfad
ClassLoader.getSystemResource("")
zum Laden der Klasse verwendet)
ClassNotFoundException
PreferredClassLoader
public static Object loadPreferredObject(String classname, Object... param)
classname
- Klassenname (inkl. Paket)param
- Parameter fuer den Konstruktor-Aufruf
RuntimeException
- falls irgendein Fehler auftrittpublic static Object loadPreferredObject(String classname, URL searchPath, Object... param)
classname
- Klassenname (inkl. Paket)searchPath
- Pfad, in dem der ClassLoader nach Klassen sucht
(wenn null
, wird der System-Klassenpfad
ClassLoader.getSystemResource("")
zum Laden der Klasse verwendet)param
- Parameter fuer den Konstruktor-Aufruf
RuntimeException
- falls irgendein Fehler auftrittpublic static String extendPackagePath(Class clazz, String pathExt)
clazz
- eine KlassepathExt
- Erweiterung des Pfadspublic static void checkIdentifierAndError(String identifier)
identifier
- Identifier
IllegalArgumentException
- falls der Identifier nicht-erlaubte
Zeichen enthaeltCharacter.isJavaIdentifierStart(char)
,
Character.isJavaIdentifierPart(char)
public static boolean checkIdentifier(String identifier)
identifier
- IdentifiercheckIdentifierAndError(String)
public static void sort(Object[] objects)
toString()
-Werte.
objects
- Objektepublic static int max(int defMaxValue, Collection<Integer>... collections)
defMaxValue
- value taken as maximum if a collection is emptycollections
- some collectionspublic static int max(Collection<Integer>... collections)
collections
- some collectionspublic static int min(int defMinValue, Collection<Integer>... collections)
defMinValue
- value taken as minimum if a collection is emptycollections
- some collectionspublic static int min(Collection<Integer>... collections)
collections
- some collectionspublic static double round(double value, int digits, int... mode)
value
- Wertdigits
- Anzahl an Nachkommastellen (negative Werte runden auf
Vorkommastellen, also 10er-, 100er-, usw. Stelle)mode
- Modus für das Runden (0 = normal Runden, 1 = Aufrunden, -1 = Abrunden;
wenn nicht angegeben, wird normal gerundet)public static Collection<Number> round(Collection<Number> values, int digits, int... mode)
Collection
auf Nach- oder Vorkommastellen.Collection
des gleichen Typs erzeugt und die
gerundeten Werte darin in der Reihenfolge eingefuegt, wie sie von
Collection.iterator()
geliefert werden! Unter umstaenden kann
die urspruengliche Sortierung verloren gehen! Diese Methode sollte also
im Zweifelsfall nur auf automatisch sortierte Collections
angewandt werden (z.B. TreeSet
).
values
- Wertedigits
- Anzahl an Nachkommastellen (negative Werte runden auf
Vorkommastellen, also 10er-, 100er-, usw. Stelle)mode
- Modus für das Runden (0 = normal Runden, 1 = Aufrunden, -1 = Abrunden;
wenn nicht angegeben, wird normal gerundet)public static Logger createLogger(Object object)
object
- ein Objekt
null
istpublic static void logDebugError(Category logger, Object mess, Throwable err)
logger
- ein Loggermess
- Fehlermeldung (wenn null
wird die Message des Fehlers ausgegeben)err
- ein Fehlerpublic static void logDebugError(Category logger, Throwable err)
logger
- ein Loggererr
- ein Fehlerpublic static void logDebugWarn(Category logger, Object mess, Throwable err)
logger
- ein Loggermess
- Fehlermeldung (wenn null
wird die Message des Fehlers ausgegeben)err
- ein Fehlerpublic static void logDebugWarn(Category logger, Throwable err)
logger
- ein Loggererr
- ein Fehler
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |