- java.lang.Object
-
- jdk.jfr.Configuration
-
public final class Configuration extends Object
A collection of settings and metadata describing the configuration.- Since:
- 9
-
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static Configuration
create(Reader reader)
Reads a configuration from a character stream.static Configuration
create(Path path)
Reads a configuration from a file.static Configuration
getConfiguration(String name)
Returns a predefined configuration.static List<Configuration>
getConfigurations()
Returns an immutable list of predefined configurations for this Java Virtual Machine (JVM).String
getContents()
Returns a textual representation of the configuration (for example, the contents of a JFC file).String
getDescription()
Returns a short sentence that describes the configuration (for example"Low overhead configuration safe for continuous use in production environments"
)String
getLabel()
Returns a human-readable name (for example,"Continuous" or "Profiling"
}.String
getName()
Returns an identifying name (for example,"default" or "profile")
.String
getProvider()
Returns who created the configuration (for example"OpenJDK"
).Map<String,String>
getSettings()
Returns the settings that specifies how a recording is configured.
-
-
-
Method Detail
getSettings
public Map<String,String> getSettings()
Returns the settings that specifies how a recording is configured.Modifying the returned
Map
object doesn't change the configuration.- Returns:
-
settings, not
null
getName
public String getName()
Returns an identifying name (for example,"default" or "profile")
.- Returns:
-
the name, or
null
if it doesn't exist
getLabel
public String getLabel()
Returns a human-readable name (for example,"Continuous" or "Profiling"
}.- Returns:
-
the label, or
null
if it doesn't exist
getDescription
public String getDescription()
Returns a short sentence that describes the configuration (for example"Low overhead configuration safe for continuous use in production environments"
)- Returns:
-
the description, or
null
if it doesn't exist
getProvider
public String getProvider()
Returns who created the configuration (for example"OpenJDK"
).- Returns:
-
the provider, or
null
if it doesn't exist
getContents
public String getContents()
Returns a textual representation of the configuration (for example, the contents of a JFC file).- Returns:
-
contents, or
null
if it doesn't exist - See Also:
getContents()
create
public static Configuration create(Path path) throws IOException, ParseException
Reads a configuration from a file.- Parameters:
path
- the file that contains the configuration, notnull
- Returns:
-
the read
Configuration
, notnull
- Throws:
ParseException
- if the file can't be parsedIOException
- if the file can't be readSecurityException
- if a security manager exists and itscheckRead
method denies read access to the file.- See Also:
File.getPath()
,SecurityManager.checkRead(java.lang.String)
create
public static Configuration create(Reader reader) throws IOException, ParseException
Reads a configuration from a character stream.- Parameters:
reader
- aReader
that provides the configuration contents, notnull
- Returns:
-
a configuration, not
null
- Throws:
IOException
- if an I/O error occurs while trying to read contents from theReader
ParseException
- if the file can't be parsed
getConfiguration
public static Configuration getConfiguration(String name) throws IOException, ParseException
Returns a predefined configuration.See
getConfigurations()
for available configuration names.- Parameters:
name
- the name of the configuration (for example,"default"
or"profile"
)- Returns:
-
a configuration, not
null
- Throws:
IOException
- if a configuration with the given name does not exist, or if an I/O error occurs while reading the configuration fileParseException
- if the configuration file can't be parsed
getConfigurations
public static List<Configuration> getConfigurations()
Returns an immutable list of predefined configurations for this Java Virtual Machine (JVM).- Returns:
-
the list of predefined configurations, not
null
-