- * Each VM option has a default value. A VM option can - * be set at VM creation time typically as a command line - * argument to the launcher or an argument passed to the - * VM created using the JNI invocation interface. - * In addition, a VM option may be set via an environment - * variable or a configuration file. A VM option can also - * be set dynamically via a management interface after - * the VM was started. - * - * A VMOption contains the value of a VM option - * and the origin of that value at the time this VMOption - * object was constructed. The value of the VM option - * may be changed after the VMOption object was constructed, - * - * @see - * Java Virtual Machine - * @author Mandy Chung - * @since 1.6 - */ -@jdk.Exported -public class VMOption { - private String name; - private String value; - private boolean writeable; - private Origin origin; - - /** - * Origin of the value of a VM option. It tells where the - * value of a VM option came from. - * - * @since 1.6 - */ - @jdk.Exported - public enum Origin { - /** - * The VM option has not been set and its value - * is the default value. - */ - DEFAULT, - /** - * The VM option was set at VM creation time typically - * as a command line argument to the launcher or - * an argument passed to the VM created using the - * JNI invocation interface. - */ - VM_CREATION, - /** - * The VM option was set via an environment variable. - */ - ENVIRON_VAR, - /** - * The VM option was set via a configuration file. - */ - CONFIG_FILE, - /** - * The VM option was set via the management interface after the VM - * was started. - */ - MANAGEMENT, - /** - * The VM option was set via the VM ergonomic support. - */ - ERGONOMIC, - /** - * The VM option was set using the attach framework. - * @since 1.9 - */ - ATTACH_ON_DEMAND, - /** - * The VM option was set via some other mechanism. - */ - OTHER - } - - /** - * Constructs a VMOption. - * - * @param name Name of a VM option. - * @param value Value of a VM option. - * @param writeable true if a VM option can be set dynamically, - * or false otherwise. - * @param origin where the value of a VM option came from. - * - * @throws NullPointerException if the name or value is null - */ - public VMOption(String name, String value, boolean writeable, Origin origin) { - this.name = name; - this.value = value; - this.writeable = writeable; - this.origin = origin; - } - - /** - * Constructs a VMOption object from a - * {@link CompositeData CompositeData}. - */ - private VMOption(CompositeData cd) { - // validate the input composite data - VMOptionCompositeData.validateCompositeData(cd); - - this.name = VMOptionCompositeData.getName(cd); - this.value = VMOptionCompositeData.getValue(cd); - this.writeable = VMOptionCompositeData.isWriteable(cd); - this.origin = VMOptionCompositeData.getOrigin(cd); - } - - /** - * Returns the name of this VM option. - * - * @return the name of this VM option. - */ - public String getName() { - return name; - } - - /** - * Returns the value of this VM option at the time when - * this VMOption was created. The value could have been changed. - * - * @return the value of the VM option at the time when - * this VMOption was created. - */ - public String getValue() { - return value; - } - - /** - * Returns the origin of the value of this VM option. That is, - * where the value of this VM option came from. - * - * @return where the value of this VM option came from. - */ - public Origin getOrigin() { - return origin; - } - - /** - * Tests if this VM option is writeable. If this VM option is writeable, - * it can be set by the {@link HotSpotDiagnosticMXBean#setVMOption - * HotSpotDiagnosticMXBean.setVMOption} method. - * - * @return true if this VM option is writeable; false - * otherwise. - */ - public boolean isWriteable() { - return writeable; - } - - public String toString() { - return "VM option: " + getName() + - " value: " + value + " " + - " origin: " + origin + " " + - (writeable ? "(read-write)" : "(read-only)"); - } - - /** - * Returns a VMOption object represented by the - * given CompositeData. The given CompositeData - * must contain the following attributes: - *
- *
- *- * - * @param cd CompositeData representing a VMOption - * - * @throws IllegalArgumentException if cd does not - * represent a VMOption with the attributes described - * above. - * - * @return a VMOption object represented by cd - * if cd is not null; - * null otherwise. - */ - public static VMOption from(CompositeData cd) { - if (cd == null) { - return null; - } - - if (cd instanceof VMOptionCompositeData) { - return ((VMOptionCompositeData) cd).getVMOption(); - } else { - return new VMOption(cd); - } - - } - - -} --- /dev/null 2015-04-02 17:37:00.000000000 +0200 +++ new/jdk/src/jdk.management/share/classes/com/sun/management/VMOption.java 2015-04-02 17:36:59.000000000 +0200 @@ -0,0 +1,248 @@ +/* + * Copyright (c) 2005, 2015, 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 com.sun.management; + +import com.sun.management.internal.VMOptionCompositeData; +import javax.management.openmbean.CompositeData; + +/** + * Information about a VM option including its value and + * where the value came from which is referred as its + * {@link VMOption.Origin origin}. + *- *
- *- * - *Attribute Name - *Type - *- * - *name - *java.lang.String - *- * - *value - *java.lang.String - *- * - *origin - *java.lang.String - *- * - *writeable - *java.lang.Boolean - *
+ * Each VM option has a default value. A VM option can + * be set at VM creation time typically as a command line + * argument to the launcher or an argument passed to the + * VM created using the JNI invocation interface. + * In addition, a VM option may be set via an environment + * variable or a configuration file. A VM option can also + * be set dynamically via a management interface after + * the VM was started. + * + * A VMOption contains the value of a VM option + * and the origin of that value at the time this VMOption + * object was constructed. The value of the VM option + * may be changed after the VMOption object was constructed, + * + * @see + * Java Virtual Machine + * @author Mandy Chung + * @since 1.6 + */ +@jdk.Exported +public class VMOption { + private String name; + private String value; + private boolean writeable; + private Origin origin; + + /** + * Origin of the value of a VM option. It tells where the + * value of a VM option came from. + * + * @since 1.6 + */ + @jdk.Exported + public enum Origin { + /** + * The VM option has not been set and its value + * is the default value. + */ + DEFAULT, + /** + * The VM option was set at VM creation time typically + * as a command line argument to the launcher or + * an argument passed to the VM created using the + * JNI invocation interface. + */ + VM_CREATION, + /** + * The VM option was set via an environment variable. + */ + ENVIRON_VAR, + /** + * The VM option was set via a configuration file. + */ + CONFIG_FILE, + /** + * The VM option was set via the management interface after the VM + * was started. + */ + MANAGEMENT, + /** + * The VM option was set via the VM ergonomic support. + */ + ERGONOMIC, + /** + * The VM option was set using the attach framework. + * @since 1.9 + */ + ATTACH_ON_DEMAND, + /** + * The VM option was set via some other mechanism. + */ + OTHER + } + + /** + * Constructs a VMOption. + * + * @param name Name of a VM option. + * @param value Value of a VM option. + * @param writeable true if a VM option can be set dynamically, + * or false otherwise. + * @param origin where the value of a VM option came from. + * + * @throws NullPointerException if the name or value is null + */ + public VMOption(String name, String value, boolean writeable, Origin origin) { + this.name = name; + this.value = value; + this.writeable = writeable; + this.origin = origin; + } + + /** + * Constructs a VMOption object from a + * {@link CompositeData CompositeData}. + */ + private VMOption(CompositeData cd) { + // validate the input composite data + VMOptionCompositeData.validateCompositeData(cd); + + this.name = VMOptionCompositeData.getName(cd); + this.value = VMOptionCompositeData.getValue(cd); + this.writeable = VMOptionCompositeData.isWriteable(cd); + this.origin = VMOptionCompositeData.getOrigin(cd); + } + + /** + * Returns the name of this VM option. + * + * @return the name of this VM option. + */ + public String getName() { + return name; + } + + /** + * Returns the value of this VM option at the time when + * this VMOption was created. The value could have been changed. + * + * @return the value of the VM option at the time when + * this VMOption was created. + */ + public String getValue() { + return value; + } + + /** + * Returns the origin of the value of this VM option. That is, + * where the value of this VM option came from. + * + * @return where the value of this VM option came from. + */ + public Origin getOrigin() { + return origin; + } + + /** + * Tests if this VM option is writeable. If this VM option is writeable, + * it can be set by the {@link HotSpotDiagnosticMXBean#setVMOption + * HotSpotDiagnosticMXBean.setVMOption} method. + * + * @return true if this VM option is writeable; false + * otherwise. + */ + public boolean isWriteable() { + return writeable; + } + + public String toString() { + return "VM option: " + getName() + + " value: " + value + " " + + " origin: " + origin + " " + + (writeable ? "(read-write)" : "(read-only)"); + } + + /** + * Returns a VMOption object represented by the + * given CompositeData. The given CompositeData + * must contain the following attributes: + *
+ *
+ *+ * + * @param cd CompositeData representing a VMOption + * + * @throws IllegalArgumentException if cd does not + * represent a VMOption with the attributes described + * above. + * + * @return a VMOption object represented by cd + * if cd is not null; + * null otherwise. + */ + public static VMOption from(CompositeData cd) { + if (cd == null) { + return null; + } + + if (cd instanceof VMOptionCompositeData) { + return ((VMOptionCompositeData) cd).getVMOption(); + } else { + return new VMOption(cd); + } + + } + + // for sun.management.MappedMXBeanType + static CompositeData toCompositeData(VMOption option) { + return VMOptionCompositeData.toCompositeData(option); + } +}+ *
+ *+ * + *Attribute Name + *Type + *+ * + *name + *java.lang.String + *+ * + *value + *java.lang.String + *+ * + *origin + *java.lang.String + *+ * + *writeable + *java.lang.Boolean + *