jdk.jfr.internal.jfc.JFC Java Examples

/**
 * Returns an immutable list of predefined configurations for this JVM.
 *
 * @return the list of predefined configurations, not {@code null}
 */
public static List<Configuration> getConfigurations() {
    if (JVMSupport.isNotAvailable()) {
        return new ArrayList<>();
    }
    return Collections.unmodifiableList(JFC.getConfigurations());
}
 

/**
 * Returns an immutable list of predefined configurations for this Java Virtual Machine (JVM).
 *
 * @return the list of predefined configurations, not {@code null}
 */
public static List<Configuration> getConfigurations() {
    if (JVMSupport.isNotAvailable()) {
        return new ArrayList<>();
    }
    return Collections.unmodifiableList(JFC.getConfigurations());
}
 

/**
 * Returns an immutable list of predefined configurations for this Java Virtual Machine (JVM).
 *
 * @return the list of predefined configurations, not {@code null}
 */
public static List<Configuration> getConfigurations() {
    if (JVMSupport.isNotAvailable()) {
        return new ArrayList<>();
    }
    return Collections.unmodifiableList(JFC.getConfigurations());
}
 

/**
 * Reads a configuration from a file.
 *
 * @param path the file that contains the configuration, not {@code null}
 * @return the read {@link Configuration}, not {@code null}
 * @throws ParseException if the file can't be parsed
 * @throws IOException if the file can't be read
 * @throws SecurityException if a security manager exists and its
 *         {@code checkRead} method denies read access to the file.
 *
 * @see java.io.File#getPath()
 * @see java.lang.SecurityManager#checkRead(java.lang.String)
 */
public static Configuration create(Path path) throws IOException, ParseException {
    Objects.requireNonNull(path);
    JVMSupport.ensureWithIOException();
    try (Reader reader = Files.newBufferedReader(path)) {
        return JFC.create(JFC.nameFromPath(path), reader);
    }
}
 

/**
 * Reads a configuration from a file.
 *
 * @param path the file that contains the configuration, not {@code null}
 * @return the read {@link Configuration}, not {@code null}
 * @throws ParseException if the file can't be parsed
 * @throws IOException if the file can't be read
 * @throws SecurityException if a security manager exists and its
 *         {@code checkRead} method denies read access to the file.
 *
 * @see java.io.File#getPath()
 * @see java.lang.SecurityManager#checkRead(java.lang.String)
 */
public static Configuration create(Path path) throws IOException, ParseException {
    Objects.requireNonNull(path);
    JVMSupport.ensureWithIOException();
    try (Reader reader = Files.newBufferedReader(path)) {
        return JFC.create(JFC.nameFromPath(path), reader);
    }
}
 

/**
 * Reads a configuration from a file.
 *
 * @param path the file that contains the configuration, not {@code null}
 * @return the read {@link Configuration}, not {@code null}
 * @throws ParseException if the file can't be parsed
 * @throws IOException if the file can't be read
 * @throws SecurityException if a security manager exists and its
 *         {@code checkRead} method denies read access to the file.
 *
 * @see java.io.File#getPath()
 * @see java.lang.SecurityManager#checkRead(java.lang.String)
 */
public static Configuration create(Path path) throws IOException, ParseException {
    Objects.requireNonNull(path);
    JVMSupport.ensureWithIOException();
    try (Reader reader = Files.newBufferedReader(path)) {
        return JFC.create(JFC.nameFromPath(path), reader);
    }
}
 

/**
 * Reads a configuration from a reader.
 *
 * @param reader a reader that contains the configuration contents, not
 *        {@code null}
 * @return a configuration, not {@code null}
 * @throws IOException if an I/O error occurs while trying to read contents
 *         from the reader
 * @throws ParseException if the file can't be parsed
 */
public static Configuration create(Reader reader) throws IOException, ParseException {
    Objects.requireNonNull(reader);
    JVMSupport.ensureWithIOException();
    return JFC.create(null, reader);
}
 

/**
 * Returns a predefined configuration.
 * <p>
 * See {@link Configuration#getConfigurations()} for available configuration
 * names.
 *
 * @param name the name of the configuration (for example, "default" or
 *        "profile")
 * @return a configuration, not {@code null}
 *
 * @throws IOException if a configuration with the given name does not
 *         exist, or if an I/O error occurs while reading the
 *         configuration file
 * @throws ParseException if the configuration file can't be parsed
 */
public static Configuration getConfiguration(String name) throws IOException, ParseException {
    JVMSupport.ensureWithIOException();
    return JFC.getPredefined(name);
}
 

/**
 * Reads a configuration from a character stream.
 *
 * @param reader a {@code Reader} that provides the configuration contents, not
 *        {@code null}
 * @return a configuration, not {@code null}
 * @throws IOException if an I/O error occurs while trying to read contents
 *         from the {@code Reader}
 * @throws ParseException if the file can't be parsed
 */
public static Configuration create(Reader reader) throws IOException, ParseException {
    Objects.requireNonNull(reader);
    JVMSupport.ensureWithIOException();
    return JFC.create(null, reader);
}
 

/**
 * Returns a predefined configuration.
 * <p>
 * See {@link Configuration#getConfigurations()} for available configuration
 * names.
 *
 * @param name the name of the configuration (for example, {@code "default"} or
 *        {@code "profile"})
 * @return a configuration, not {@code null}
 *
 * @throws IOException if a configuration with the given name does not
 *         exist, or if an I/O error occurs while reading the
 *         configuration file
 * @throws ParseException if the configuration file can't be parsed
 */
public static Configuration getConfiguration(String name) throws IOException, ParseException {
    JVMSupport.ensureWithIOException();
    return JFC.getPredefined(name);
}
 

/**
 * Reads a configuration from a character stream.
 *
 * @param reader a {@code Reader} that provides the configuration contents, not
 *        {@code null}
 * @return a configuration, not {@code null}
 * @throws IOException if an I/O error occurs while trying to read contents
 *         from the {@code Reader}
 * @throws ParseException if the file can't be parsed
 */
public static Configuration create(Reader reader) throws IOException, ParseException {
    Objects.requireNonNull(reader);
    JVMSupport.ensureWithIOException();
    return JFC.create(null, reader);
}
 

/**
 * Returns a predefined configuration.
 * <p>
 * See {@link Configuration#getConfigurations()} for available configuration
 * names.
 *
 * @param name the name of the configuration (for example, {@code "default"} or
 *        {@code "profile"})
 * @return a configuration, not {@code null}
 *
 * @throws IOException if a configuration with the given name does not
 *         exist, or if an I/O error occurs while reading the
 *         configuration file
 * @throws ParseException if the configuration file can't be parsed
 */
public static Configuration getConfiguration(String name) throws IOException, ParseException {
    JVMSupport.ensureWithIOException();
    return JFC.getPredefined(name);
}