/* * Copyright (c) 2016, 2018, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ package jdk.management.jfr; import java.util.Collection; import java.util.Collections; import java.util.HashMap; import java.util.Map; import javax.management.openmbean.CompositeData; import javax.management.openmbean.TabularData; import jdk.jfr.Configuration; /** * Management representation of a {@code Configuration}. * * @see Configuration * * @since 9 */ public final class ConfigurationInfo { private final Map settings; private final String name; private final String label; private final String description; private final String provider; private final String contents; ConfigurationInfo(Configuration config) { this.settings = config.getSettings(); this.name = config.getName(); this.label = config.getLabel(); this.description = config.getDescription(); this.provider = config.getProvider(); this.contents = config.getContents(); } private ConfigurationInfo(CompositeData cd) { this.settings = createMap(cd.get("settings")); this.name = (String) cd.get("name"); this.label = (String) cd.get("label"); this.description = (String) cd.get("description"); this.provider = (String) cd.get("provider"); this.contents = (String) cd.get("contents"); } private static Map createMap(Object o) { if (o instanceof TabularData) { TabularData td = (TabularData) o; Collection values = td.values(); Map map = new HashMap<>(values.size()); for (Object value : td.values()) { if (value instanceof CompositeData) { CompositeData cdRow = (CompositeData) value; Object k = cdRow.get("key"); Object v = cdRow.get("value"); if (k instanceof String && v instanceof String) { map.put((String) k, (String) v); } } } return Collections.unmodifiableMap(map); } return Collections.emptyMap(); } /** * Returns the configuration provider, for example {@code "Oracle"}. * * @return the provider, or {@code null} if not available * * @see Configuration#getProvider() */ public String getProvider() { return provider; } /** * Returns the textual representation of the configuration associated with * this {@code ConfigurationInfo}, typically the contents of the * configuration file that was used to create the configuration. * * @return contents, or {@code null} if not available * * @see Configuration#getContents() */ public String getContents() { return contents; } /** * Returns the settings for the configuration associated with this * {@code ConfigurationInfo}. * * @return map with settings, not {@code null} * * @see Configuration#getSettings() */ public Map getSettings() { return settings; } /** * Returns the human-readable name, for example {@code "Continuous"}. for * the configuration associated with this {@code ConfigurationInfo} * * @return the label, or {@code null} if not available * * @see Configuration#getLabel() */ public String getLabel() { return label; } /** * Returns the name of the configuration associated with this * {@code ConfigurationInfo}, for example {@code "default"}. * * @return the name, or {@code null} if not available * * @see Configuration#getLabel() */ public String getName() { return name; } /** * Returns a sentence or two, describing the configuration associated with * this {@code ConfigurationInfo}, for example {@code "Low * overhead configuration safe for continuous use in production * environments"}. * * @return the description, or {@code null} if not available */ public String getDescription() { return description; } /** * Returns a {@code ConfigurationInfo} object represented by the specified * {@code CompositeData}. *

* The following table shows the required attributes that the specified {@code CompositeData} must contain. *

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
Required names and types for CompositeData
NameType
name{@code String}
label{@code String}
description{@code String}
provider{@code String}
contents{@code String}
settings{@code javax.management.openmbean.TabularData} with a * {@code TabularType} with the keys {@code "key"} and {@code "value"}, both * of the {@code String} type
*
* * @param cd {@code CompositeData} representing a {@code ConfigurationInfo} * * @throws IllegalArgumentException if {@code cd} does not represent a * {@code ConfigurationInfo} with the required attributes * * @return a {@code ConfigurationInfo} object represented by {@code cd} if * {@code cd} is not {@code null}, {@code null} otherwise */ public static ConfigurationInfo from(CompositeData cd) { if (cd == null) { return null; } return new ConfigurationInfo(cd); } /** * Returns a description of the configuration that is associated with this * {@code ConfigurationInfo} instance.s * * @return the description of the configuration, not {@code null} */ @Override public String toString() { Stringifier s = new Stringifier(); s.add("name", name); s.add("label", label); s.add("description", description); s.add("provider", provider); return s.toString(); } }