Class Util
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final String
static final String
static final String
static final char
static final String
static final String
static final String
static final String
static final String
static final String
static final String
static final String
static final String
static final String
static final String
static final String
static final String
static final String
static final String
static final String
static final String
static final String
static final char
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic void
addGridBagComponent
(JComponent container, JComponent comp, GridBagLayout g, GridBagConstraints c, int gx, int gy, int a) convenience method for adding a component to a container layed out by a GridBagLayoutstatic void
addGridBagComponent
(JComponent container, JComponent comp, GridBagLayout g, GridBagConstraints c, int gx, int gy, int a, int gw, int gh) convenience method for adding a component to a container layed out by a GridBagLayoutstatic void
addGridBagComponent
(JComponent container, JComponent comp, GridBagLayout g, GridBagConstraints c, int gx, int gy, int a, int gw, int gh, int f) convenience method for adding a component to a container layed out by a GridBagLayoutstatic void
addGridBagComponent
(JComponent container, JComponent comp, GridBagLayout g, GridBagConstraints c, int gx, int gy, int a, int gw, int gh, int f, double wx, double wy) convenience method for adding a component to a container layed out by a GridBagLayoutstatic void
center aComponent
relative to anotherComponent
.static void
copies a single file.static void
delete a directory with all its contentsstatic void
show an error message and print a stack trace to the console if in development mode (DEV_MODE = true)static Element
findElementDown
(String name, Element parent) find the first occurrence of anElement
in the element tree below a givenElement
static Element
findElementUp
(String name1, String name2, Element start) find the first occurrence of anElement
in the element tree above a givenElement
static Element
findElementUp
(String name, Element start) find the first occurrence of anElement
in the element tree above a givenElement
static Object
findLinkUp
(Element elem) find the next link attribute from a given element upwards through the element hierarchystatic float
getAbsoluteAttrVal
(Object attr) get the absolute value of an attributestatic float
getAttrValue
(Object attr) get the numerical value for an attribute objectstatic String
getClassFilePath
(Class cls) Get the path of the class file for a given class.static int
getElementIndex
(Element elem) get the index of a given element in the list of its parents elements.static String
get the unit string from the last attribute object which was converted to a numerical valuestatic String
getPreference
(String key, String defaultValue) static float
getPtValue
(String valStr) quick hack for getting the point value from an attribute value string (needs to be refined and consolidated with length value)static String
getRelativePath
(File fromDir, File toFile) get the path to a given file relative to a given directorystatic String
getResourceString
(UIResources resources, String nm) get a string from the resources filestatic String
static int
getRowIndex
(Element cell) get the row index for a given table cellstatic Vector
getStyleNames
(StyleSheet styles) get the names of all styles found in a given StyleSheetstatic Vector
getStyleNamesForTag
(AttributeSet styles, String tag) get names of all styles for a given tagstatic Vector
getStyleNamesForTag
(StyleSheet styles, String tag) get names of all styles for a given tagstatic boolean
Show a message with options to choose fromstatic int
Show a message with options to choose fromstatic void
write a message with a time stamp to System.out and remember the time stamp in a LIFO Vectorstatic String
get a name by asking from the userstatic String
removeChar
(String src, char c) remove all occurrences of a given char from a given stringstatic String
removeExtension
(String fileName) remove the extension from a file namestatic File
renameFile
(File from, String newExt) rename a file to have a given extensionstatic AttributeSet
resolveAttributes
(AttributeSet style) resolve sets of attributes that are recursively stored in each otherstatic String
resolveRelativePath
(String relPath, String absPath) resolve a relative URL string against an absolute URL string.static StyleSheet
get a StyleSheet object for using its utility methodsstatic String[]
Get an arry of strings from a given string having several entries delimited by blanks.
-
Field Details
-
JAR_PREFIX
- See Also:
-
JAR_EXTENSION
- See Also:
-
FILE_PREFIX
- See Also:
-
CLASS_EXT
- See Also:
-
JAR_SEPARATOR
- See Also:
-
URL_SEPARATOR
- See Also:
-
URL_SEPARATOR_CHAR
public static final char URL_SEPARATOR_CHAR- See Also:
-
CLASS_SEPARATOR
- See Also:
-
CLASS_SEPARATOR_CHAR
public static final char CLASS_SEPARATOR_CHAR- See Also:
-
DIR_UP_INDICATOR
- See Also:
-
RELATIVE_PREFIX
- See Also:
-
PROTOCOL_SEPARATOR
- See Also:
-
ANCHOR_SEPARATOR
- See Also:
-
pct
- See Also:
-
pt
- See Also:
-
px
- See Also:
-
CSS_ATTRIBUTE_NORMAL
- See Also:
-
CSS_ATTRIBUTE_UNDERLINE
- See Also:
-
CSS_ATTRIBUTE_LINE_THROUGH
- See Also:
-
CSS_ATTRIBUTE_NONE
- See Also:
-
CSS_ATTRIBUTE_ALIGN_LEFT
- See Also:
-
CSS_ATTRIBUTE_ALIGN_CENTER
- See Also:
-
CSS_ATTRIBUTE_ALIGN_RIGHT
- See Also:
-
-
Constructor Details
-
Util
public Util()
-
-
Method Details
-
renameFile
rename a file to have a given extension- Parameters:
from
- the file to renamenewExt
- the new extension the file shall have- Returns:
- the renamed file
-
findLinkUp
find the next link attribute from a given element upwards through the element hierarchy- Parameters:
elem
- the element to start looking at- Returns:
- the link attribute found, or null, if none was found
-
removeExtension
remove the extension from a file name- Parameters:
fileName
- the file name to remove the extension from- Returns:
- the file name without extension
-
resolveAttributes
resolve sets of attributes that are recursively stored in each other- Parameters:
style
- the set of attributes containing other sets of attributes
-
nameInput
public static String nameInput(Frame parent, String initialName, String regex, String title, String text) get a name by asking from the userWrapper for JOptionPane with I18N support
- Parameters:
initialName
- the name initially shown in option panetitle
- the title to be shown in the option panetext
- the text to be shown in the option pane- Returns:
- the entered name or null if action was cancelled
-
msgChoice
Show a message with options to choose fromWrapper for JOptionPane with I18N support
- Parameters:
options
- the options to be shown in the dialogtitle
- the title to be shown in the dialogmsg
- the message to be shown in the dialogitem
- a variable part to be shown before msgsep
- a separator for msg and item (return or blank etc.)- Returns:
- the choice
-
msg
Show a message with options to choose fromWrapper for JOptionPane with I18N support
- Parameters:
options
- the options to be shown in the dialogtitle
- the title to be shown in the dialogmsg
- the message to be shown in the dialogitem
- a variable part to be shown before msgsep
- a separator for msg and item (return or blank etc.)- Returns:
- true, if YES was chosen, false if not
-
getStyleNamesForTag
get names of all styles for a given tag- Parameters:
styles
- the style sheet to look for style namestag
- the tag to find style names for- Returns:
- a Vector with all style names found
-
getStyleNamesForTag
get names of all styles for a given tag- Parameters:
styles
- the style sheet to look for style namestag
- the tag to find style names for- Returns:
- a Vector with all style names found
-
getStyleNames
get the names of all styles found in a given StyleSheet- Parameters:
styles
- the StyleSheet to look for style names- Returns:
- a Vector with all names found
-
deleteDir
delete a directory with all its contentsCAUTION: This method deletes all content of the given directory including all subdirectories and their conent
- Parameters:
dir
- the directory to delete
-
copyFile
copies a single file.If destFile already exists or if both files are the same the method does nothing. The complete destination path will be created before copying, if necessary.
- Parameters:
srcFile
- the file to copy fromdestFile
- the file to copy to- Throws:
FileNotFoundException
IOException
-
getElementIndex
get the index of a given element in the list of its parents elements.- Parameters:
elem
- the element to get the index number for- Returns:
- the index of the given element
-
getClassFilePath
Get the path of the class file for a given class.This is either a directory of a class file or a directory of a JAR file. Thus, this class must reside in the same place as the application in question, not in a separate library for instance.
- Parameters:
cls
- the class to get the path for- Returns:
- the path of this class file or the path of the JAR file this class file resides in, whatever applies
-
getPtValue
quick hack for getting the point value from an attribute value string (needs to be refined and consolidated with length value)- Parameters:
valStr
- the attribute value string to get the point size for- Returns:
- the point size from the given attribute value
-
getLastAttrUnit
get the unit string from the last attribute object which was converted to a numerical value- Returns:
- the unit string from the last attribute object
-
getAttrValue
get the numerical value for an attribute object- Parameters:
attr
- the attribute to get the value from- Returns:
- the numerical value
-
getAbsoluteAttrVal
get the absolute value of an attribute- Parameters:
attr
- the attribute to get the value from- Returns:
- the absolute numerical value
-
getRowIndex
get the row index for a given table cell- Parameters:
cell
- the cell element to get the row index for- Returns:
- the row index of the given cell element
-
tokenize
Get an arry of strings from a given string having several entries delimited by blanks.In the resource file of SimplyHTML for instance menu bar and menu definitions are contained as strings having a key for each item. The keys are delimited with blanks.
A string "file edit help" from the resource file for instance would be broken into an array of strings looking as follows
String[0]="file"
String[1]="edit"
String[2]="help"- Parameters:
input
- the string to transform into a string array- Returns:
- the resulting string array
-
msgStart
write a message with a time stamp to System.out and remember the time stamp in a LIFO Vector -
findElementUp
find the first occurrence of anElement
in the element tree above a givenElement
- Parameters:
name
- the name of theElement
to search forstart
- theElement
to start looking- Returns:
- the found
Element
or null if none is found
-
findElementUp
find the first occurrence of anElement
in the element tree above a givenElement
- Parameters:
name1
- the primary name of theElement
to search forname2
- an alternative name for theElement
to search forstart
- theElement
to start looking- Returns:
- the found
Element
or null if none is found
-
findElementDown
find the first occurrence of anElement
in the element tree below a givenElement
- Parameters:
name
- the name of theElement
to search forparent
- theElement
to start looking- Returns:
- the found
Element
or null if none is found
-
addGridBagComponent
public static void addGridBagComponent(JComponent container, JComponent comp, GridBagLayout g, GridBagConstraints c, int gx, int gy, int a) convenience method for adding a component to a container layed out by a GridBagLayout- Parameters:
container
- the container to add a component tocomp
- the component to add to containerg
- the GridBagLayout associated with containerc
- the GridBagConstraints to usegx
- the value to use for GridBagConstraints.gridxgy
- the value to use for GridBagConstraints.gridya
- the value to use for GridBagConstraints.anchor
-
addGridBagComponent
public static void addGridBagComponent(JComponent container, JComponent comp, GridBagLayout g, GridBagConstraints c, int gx, int gy, int a, int gw, int gh) convenience method for adding a component to a container layed out by a GridBagLayout- Parameters:
container
- the container to add a component tocomp
- the component to add to containerg
- the GridBagLayout associated with containerc
- the GridBagConstraints to usegx
- the value to use for GridBagConstraints.gridxgy
- the value to use for GridBagConstraints.gridya
- the value to use for GridBagConstraints.anchorgw
- the value to use for GridBagConstraints.gridwidthgh
- teh value to use for GridBagConstraints.gridheight
-
addGridBagComponent
public static void addGridBagComponent(JComponent container, JComponent comp, GridBagLayout g, GridBagConstraints c, int gx, int gy, int a, int gw, int gh, int f) convenience method for adding a component to a container layed out by a GridBagLayout- Parameters:
container
- the container to add a component tocomp
- the component to add to containerg
- the GridBagLayout associated with containerc
- the GridBagConstraints to usegx
- the value to use for GridBagConstraints.gridxgy
- the value to use for GridBagConstraints.gridya
- the value to use for GridBagConstraints.anchorgw
- the value to use for GridBagConstraints.gridwidthgh
- teh value to use for GridBagConstraints.gridheightf
- the value to use for GridBagConstraints.fill
-
addGridBagComponent
public static void addGridBagComponent(JComponent container, JComponent comp, GridBagLayout g, GridBagConstraints c, int gx, int gy, int a, int gw, int gh, int f, double wx, double wy) convenience method for adding a component to a container layed out by a GridBagLayout- Parameters:
container
- the container to add a component tocomp
- the component to add to containerg
- the GridBagLayout associated with containerc
- the GridBagConstraints to usegx
- the value to use for GridBagConstraints.gridxgy
- the value to use for GridBagConstraints.gridya
- the value to use for GridBagConstraints.anchorgw
- the value to use for GridBagConstraints.gridwidthgh
- teh value to use for GridBagConstraints.gridheightf
- the value to use for GridBagConstraints.fillwx
- the value to use for GridBagConstraints.weightxwy
- the value to use for GridBagConstraints.weighty
-
resolveRelativePath
resolve a relative URL string against an absolute URL string.the absolute URL string is the start point for the relative path.
Example:
absolute path: file:/d:/eigene dateien/eigene bilder/ relative path: ../images/test.jpg result: file:/d:/eigene dateien/images/test.jpg
- Parameters:
relPath
- the relative URL string to resolveabsPath
- the absolute URL string to start at- Returns:
- the absolute URL string resulting from resolving relPath against absPath
-
getRelativePath
get the path to a given file relative to a given directory- Parameters:
fromDir
- the directory having the file from which the link referstoFile
- the file to which a link refers- Returns:
- the relative path
-
errMsg
show an error message and print a stack trace to the console if in development mode (DEV_MODE = true)- Parameters:
owner
- the owner of the message, or nullmsg
- the message to display, or nulle
- the exception object describing the error, or null
-
center
center aComponent
relative to anotherComponent
.- Parameters:
parent
- theComponent
to be used as the basis for centeringcomp
- theComponent
to be centered within parent
-
styleSheet
get a StyleSheet object for using its utility methods -
removeChar
remove all occurrences of a given char from a given string- Parameters:
src
- the string to remove fromc
- the char to remove- Returns:
- a string copy of src with all occurrences of c removed
-
getResourceString
get a string from the resources file- Parameters:
resources
- the TextResources to get the string fromnm
- the key of the string- Returns:
- the string for the given key or null if not found
-
getResourceString
-
getPreference
-