public class JMeterUtils extends Object implements UnitTestManager
Modifier and Type | Field and Description |
---|---|
static String |
RES_KEY_PFX |
static String |
THREAD_GROUP_DISTRIBUTED_PREFIX_PROPERTY_NAME |
Constructor and Description |
---|
JMeterUtils() |
Modifier and Type | Method and Description |
---|---|
static void |
addLocaleChangeListener(LocaleChangeListener listener) |
static void |
applyHiDPI(JTable table)
Apply HiDPI mode management to
JTable |
static void |
applyHiDPIOnFonts()
Apply HiDPI scale factor on font if HiDPI mode is enabled
|
static void |
applyScaleOnFonts(float scale)
Apply HiDPI scale factor on fonts
|
static void |
clearMatcherMemory(org.apache.oro.text.regex.Perl5Matcher matcher,
org.apache.oro.text.regex.Pattern pattern)
Hack to make matcher clean the two internal buffers it keeps in memory which size is equivalent to
the unzipped page size
|
static com.thoughtworks.xstream.XStream |
createXStream() |
static List<String> |
findClassesThatExtend(Class<?> superClass)
Convenience method for
ClassFinder.findClassesThatExtend(String[], Class[], boolean)
with the option to include inner classes in the search set to false
and the path list is derived from JMeterUtils.getSearchPaths(). |
static File |
findFile(String fileName)
Find a file in the current directory or in the JMeter bin directory.
|
static String |
formatJMeterExportedVariableName(String elementName) |
static String |
getDelimiter(String delimiterValue)
Return delimiterValue handling the TAB case
|
static boolean |
getHiDPIMode()
Provide info, whether we run in HiDPI mode
|
static double |
getHiDPIScaleFactor()
Provide info about the HiDPI scale factor
|
static ImageIcon |
getImage(String name)
This looks for the requested image in the classpath under
org.apache.jmeter.images.<name>
|
static ImageIcon |
getImage(String name,
String description)
This looks for the requested image in the classpath under
org.apache.jmeter.images.<name>, and also sets the description
of the image, which is useful if the icon is going to be placed
on the clipboard.
|
static String |
getJMeterBinDir()
Get the JMeter bin directory - does not include the trailing separator.
|
static String |
getJMeterCopyright()
Gets the JMeter copyright.
|
static String |
getJMeterHome()
Get the JMeter home directory - does not include the trailing separator.
|
static Properties |
getJMeterProperties()
This gets the currently defined appProperties.
|
static String |
getJMeterVersion()
Gets the JMeter Version.
|
static Locale |
getLocale()
Gets the current locale.
|
static String |
getLocaleString(String locale)
Get the locale name as a resource.
|
static String |
getLocalHostFullName()
Returns the cached result from calling
InetAddress.getLocalHost().getCanonicalHostName()
|
static String |
getLocalHostIP()
Returns the cached result from calling
InetAddress.getLocalHost().getHostAddress()
|
static String |
getLocalHostName()
Returns the cached result from calling
InetAddress.getLocalHost().getHostName()
|
static org.apache.oro.text.regex.Perl5Matcher |
getMatcher()
Gets Perl5Matcher for this thread.
|
static String |
getParsedLabel(String key)
To get I18N label from properties file
|
static org.apache.oro.text.regex.Pattern |
getPattern(String expression)
Get a compiled expression from the pattern cache (READ_ONLY).
|
static org.apache.oro.text.regex.Pattern |
getPattern(String expression,
int options)
Get a compiled expression from the pattern cache.
|
static org.apache.oro.text.PatternCacheLRU |
getPatternCache() |
static boolean |
getPropDefault(String propName,
boolean defaultVal)
Get a boolean value with default if not present.
|
static double |
getPropDefault(String propName,
double defaultVal)
Get a double value with default if not present.
|
static float |
getPropDefault(String propName,
float defaultVal)
Get a float value with default if not present.
|
static int |
getPropDefault(String propName,
int defaultVal)
Get a int value with default if not present.
|
static long |
getPropDefault(String propName,
long defaultVal)
Get a long value with default if not present.
|
static String |
getPropDefault(String propName,
String defaultVal)
Get a String value with default if not present.
|
static Properties |
getProperties(String file)
This method is used by the init method to load the property file that may
even reside in the user space, or in the classpath under
org.apache.jmeter.jmeter.properties.
|
static String |
getProperty(String propName)
Get the value of a JMeter property.
|
static int |
getRandomInt(int r)
Provide random numbers
|
static String |
getResourceFileAsText(String name) |
static String |
getResString(String key)
Gets the resource string for this key.
|
static String |
getResString(String key,
Locale forcedLocale)
Gets the resource string for this key in Locale.
|
static String |
getResString(String key,
String defaultValue)
Deprecated.
Only intended for use in development; use
getResString(String) normally
|
static String[] |
getSearchPaths()
Generate a list of paths to search.
|
static void |
helpGC()
Help GC by triggering GC and finalization
|
void |
initializeProperties(String file)
Your implementation will be handed the filename that was provided to
AllTests as a configuration file.
|
static void |
initLocale()
Initialise the JMeter Locale
|
static void |
initLogging()
Deprecated.
does not do anything anymore
|
static boolean |
isExpertMode()
Determine whether we are in 'expert' mode.
|
static boolean |
isTestRunning() |
static JLabel |
labelFor(Component component,
String resourceId)
|
static JLabel |
labelFor(Component component,
String labelValue,
String name)
|
static void |
loadJMeterProperties(String file)
Load the JMeter properties file; if not found, then
default to "org/apache/jmeter/jmeter.properties" from the classpath
|
static Properties |
loadProperties(String file)
This method loads a property file that may reside in the user space, or
in the classpath
|
static Properties |
loadProperties(String file,
Properties defaultProps)
This method loads a property file that may reside in the user space, or
in the classpath
|
static LinkedHashMap<String,String> |
parseHeaders(String headers)
Split line into name/value pairs and remove colon ':'
|
static void |
refreshUI()
Refresh UI after LAF change or resizing
|
static void |
removeLocaleChangeListener(LocaleChangeListener listener) |
static void |
reportErrorToUser(String errorMsg)
Report an error through a dialog box.
|
static void |
reportErrorToUser(String errorMsg,
Exception exception)
Report an error through a dialog box.
|
static void |
reportErrorToUser(String errorMsg,
String titleMsg)
Report an error through a dialog box in GUI mode
or in logs and stdout in Non GUI mode
|
static void |
reportErrorToUser(String errorMsg,
String titleMsg,
Exception exception)
Report an error through a dialog box in GUI mode
or in logs and stdout in Non GUI mode
|
static void |
reportInfoToUser(String msg,
String titleMsg)
Report an information through a dialog box in GUI mode
|
static void |
runSafe(boolean synchronous,
Runnable runnable)
Run the runnable in AWT Thread if current thread is not AWT thread
otherwise runs call
SwingUtilities.invokeAndWait(Runnable) |
static void |
runSafe(Runnable runnable)
Run the runnable in AWT Thread if current thread is not AWT thread
otherwise runs call
SwingUtilities.invokeAndWait(Runnable) |
static void |
setJMeterHome(String home) |
static void |
setLocale(Locale loc)
Changes the current locale: re-reads resource strings and notifies
listeners.
|
static Object |
setProperty(String propName,
String propValue)
Set a String value
|
static void |
setupXStreamSecurityPolicy(com.thoughtworks.xstream.XStream xstream)
Setup default security policy
|
static String |
unsplit(Object[] splittee,
Object splitChar)
Deprecated.
|
static String |
unsplit(Object[] splittee,
Object splitChar,
String def)
Takes an array of strings and a tokenizer character, and returns a string
of all the strings concatenated with the tokenizer string in between each
one.
|
public static final String THREAD_GROUP_DISTRIBUTED_PREFIX_PROPERTY_NAME
public static final String RES_KEY_PFX
public static org.apache.oro.text.regex.Perl5Matcher getMatcher()
Perl5Matcher
for this threadpublic static Properties getProperties(String file)
file
- the file to loadgetJMeterProperties()
,
loadJMeterProperties(String)
,
initLocale()
@Deprecated public static void initLogging()
public static void initLocale()
public static void loadJMeterProperties(String file)
c.f. loadProperties
file
- Name of the file from which the JMeter properties should be loadedpublic static Properties loadProperties(String file)
file
- the file to loadpublic static Properties loadProperties(String file, Properties defaultProps)
file
- the file to loaddefaultProps
- a set of default propertiespublic static org.apache.oro.text.PatternCacheLRU getPatternCache()
public static org.apache.oro.text.regex.Pattern getPattern(String expression) throws org.apache.oro.text.MalformedCachePatternException
expression
- regular expression to be looked uporg.apache.oro.text.MalformedCachePatternException
- (Runtime)
This should be caught for expressions that may vary (e.g. user input)public static org.apache.oro.text.regex.Pattern getPattern(String expression, int options) throws org.apache.oro.text.MalformedCachePatternException
expression
- REoptions
- e.g. READ_ONLY_MASK
org.apache.oro.text.MalformedCachePatternException
- (Runtime)
This should be caught for expressions that may vary (e.g. user input)public void initializeProperties(String file)
UnitTestManager
initializeProperties
in interface UnitTestManager
file
- path to the configuration filepublic static List<String> findClassesThatExtend(Class<?> superClass) throws IOException
ClassFinder.findClassesThatExtend(String[], Class[], boolean)
with the option to include inner classes in the search set to false
and the path list is derived from JMeterUtils.getSearchPaths().superClass
- - single class to search forIOException
- when the used ClassFinder
throws one while searching for the classpublic static String[] getSearchPaths()
public static int getRandomInt(int r)
r
- -
the upper bound (exclusive)int
public static void setLocale(Locale loc)
loc
- -
new localepublic static Locale getLocale()
public static void addLocaleChangeListener(LocaleChangeListener listener)
public static void removeLocaleChangeListener(LocaleChangeListener listener)
public static String getResString(String key)
key
- the key in the resource filepublic static String getResString(String key, Locale forcedLocale)
key
- the key in the resource fileforcedLocale
- Force a particular locale@Deprecated public static String getResString(String key, String defaultValue)
key
- the key in the resource filedefaultValue
- -
the default valuepublic static String getParsedLabel(String key)
key
- in messages.propertiespublic static String getLocaleString(String locale)
locale
- namepublic static Properties getJMeterProperties()
getProperties(String)
or loadJMeterProperties(String)
method has been called.loadJMeterProperties(String)
has not been calledgetProperties(String)
,
loadJMeterProperties(String)
public static ImageIcon getImage(String name)
name
- Description of Parameterpublic static ImageIcon getImage(String name, String description)
name
- the name of the imagedescription
- the description of the imagepublic static int getPropDefault(String propName, int defaultVal)
propName
- the name of the property.defaultVal
- the default value.public static boolean getPropDefault(String propName, boolean defaultVal)
propName
- the name of the property.defaultVal
- the default value.public static long getPropDefault(String propName, long defaultVal)
propName
- the name of the property.defaultVal
- the default value.public static float getPropDefault(String propName, float defaultVal)
propName
- the name of the property.defaultVal
- the default value.public static double getPropDefault(String propName, double defaultVal)
propName
- the name of the property.defaultVal
- the default value.public static String getPropDefault(String propName, String defaultVal)
propName
- the name of the property.defaultVal
- the default value.public static String getProperty(String propName)
propName
- the name of the property.null
if not definedpublic static Object setProperty(String propName, String propValue)
propName
- the name of the property.propValue
- the value of the propertypublic static void reportErrorToUser(String errorMsg)
errorMsg
- - the error message.public static void reportErrorToUser(String errorMsg, String titleMsg)
errorMsg
- - the error message.titleMsg
- - title stringpublic static void reportErrorToUser(String errorMsg, Exception exception)
errorMsg
- - the error message.exception
- Exception
public static void reportErrorToUser(String errorMsg, String titleMsg, Exception exception)
errorMsg
- - the error message.titleMsg
- - title stringexception
- Exceptionpublic static void reportInfoToUser(String msg, String titleMsg)
msg
- - the information message.titleMsg
- - title stringpublic static JLabel labelFor(Component component, String resourceId)
component
- component for the labelresourceId
- resource ID to be used for retrieving label textpublic static JLabel labelFor(Component component, String labelValue, String name)
component
- component for the labellabelValue
- label textname
- JLabel name@Deprecated public static String unsplit(Object[] splittee, Object splitChar)
JOrphanUtils.unsplit(Object[], Object)
splittee
- Array of Objects to be concatenated.splitChar
- Object to unsplit the strings with.public static String unsplit(Object[] splittee, Object splitChar, String def)
splittee
- Array of Objects to be concatenated.splitChar
- Object to unsplit the strings with.def
- Default value to replace null values in array.public static boolean isTestRunning()
public static String getJMeterHome()
public static String getJMeterBinDir()
public static void setJMeterHome(String home)
public static String getJMeterVersion()
public static String getJMeterCopyright()
public static boolean isExpertMode()
public static File findFile(String fileName)
fileName
- the name of the file to findpublic static String getLocalHostIP()
public static String getLocalHostName()
public static String getLocalHostFullName()
public static LinkedHashMap<String,String> parseHeaders(String headers)
headers
- multi-line string headerspublic static void runSafe(Runnable runnable)
SwingUtilities.invokeAndWait(Runnable)
runnable
- Runnable
public static void runSafe(boolean synchronous, Runnable runnable)
SwingUtilities.invokeAndWait(Runnable)
synchronous
- flag, whether we will wait for the AWT Thread to finish its job.runnable
- Runnable
public static void helpGC()
public static void clearMatcherMemory(org.apache.oro.text.regex.Perl5Matcher matcher, org.apache.oro.text.regex.Pattern pattern)
matcher
- Perl5Matcher
pattern
- Pattern@API(since="5.3", status=DEPRECATED) public static boolean getHiDPIMode()
true
if we run in HiDPI mode, false
otherwise@API(since="5.3", status=DEPRECATED) public static double getHiDPIScaleFactor()
@API(since="5.3", status=DEPRECATED) public static void applyHiDPI(JTable table)
JTable
table
- the JTable
which should be adapted for HiDPI modepublic static String getDelimiter(String delimiterValue)
delimiterValue
- Delimited valueJMeterError
- if delimiterValue has a length different from 1@API(since="5.3", status=DEPRECATED) public static void applyHiDPIOnFonts()
@API(since="5.3", status=DEPRECATED) public static void applyScaleOnFonts(float scale)
scale
- float scale to applypublic static void refreshUI()
public static void setupXStreamSecurityPolicy(com.thoughtworks.xstream.XStream xstream)
xstream
- XStream
public static String formatJMeterExportedVariableName(String elementName)
elementName
- String elementNamepublic static final com.thoughtworks.xstream.XStream createXStream()
XStream
XStream instance following JMeter security policyCopyright © 1998-2019 Apache Software Foundation. All Rights Reserved.