diff -r fd16c54261b3 -r 90ce3da70b43 jdk/src/share/classes/java/lang/management/MonitorInfo.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/jdk/src/share/classes/java/lang/management/MonitorInfo.java Sat Dec 01 00:00:00 2007 +0000 @@ -0,0 +1,159 @@ +/* + * Copyright 2005-2006 Sun Microsystems, Inc. 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. Sun designates this + * particular file as subject to the "Classpath" exception as provided + * by Sun 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 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, + * CA 95054 USA or visit www.sun.com if you need additional information or + * have any questions. + */ + +package java.lang.management; + +import javax.management.openmbean.CompositeData; +import sun.management.MonitorInfoCompositeData; + +/** + * Information about an object monitor lock. An object monitor is locked + * when entering a synchronization block or method on that object. + * + *

MXBean Mapping

+ * MonitorInfo is mapped to a {@link CompositeData CompositeData} + * with attributes as specified in + * the {@link #from from} method. + * + * @author Mandy Chung + * @since 1.6 + */ +public class MonitorInfo extends LockInfo { + + private int stackDepth; + private StackTraceElement stackFrame; + + /** + * Construct a MonitorInfo object. + * + * @param className the fully qualified name of the class of the lock object. + * @param identityHashCode the {@link System#identityHashCode + * identity hash code} of the lock object. + * @param stackDepth the depth in the stack trace where the object monitor + * was locked. + * @param stackFrame the stack frame that locked the object monitor. + * @throws IllegalArgumentException if + * stackDepth ≥ 0 but stackFrame is null, + * or stackDepth < 0 but stackFrame is not + * null. + */ + public MonitorInfo(String className, + int identityHashCode, + int stackDepth, + StackTraceElement stackFrame) { + super(className, identityHashCode); + if (stackDepth >= 0 && stackFrame == null) { + throw new IllegalArgumentException("Parameter stackDepth is " + + stackDepth + " but stackFrame is null"); + } + if (stackDepth < 0 && stackFrame != null) { + throw new IllegalArgumentException("Parameter stackDepth is " + + stackDepth + " but stackFrame is not null"); + } + this.stackDepth = stackDepth; + this.stackFrame = stackFrame; + } + + /** + * Returns the depth in the stack trace where the object monitor + * was locked. The depth is the index to the StackTraceElement + * array returned in the {@link ThreadInfo#getStackTrace} method. + * + * @return the depth in the stack trace where the object monitor + * was locked, or a negative number if not available. + */ + public int getLockedStackDepth() { + return stackDepth; + } + + /** + * Returns the stack frame that locked the object monitor. + * + * @return StackTraceElement that locked the object monitor, + * or null if not available. + */ + public StackTraceElement getLockedStackFrame() { + return stackFrame; + } + + /** + * Returns a MonitorInfo object represented by the + * given CompositeData. + * The given CompositeData must contain the following attributes + * as well as the attributes specified in the + * + * mapped type for the {@link LockInfo} class: + *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + *
Attribute NameType
lockedStackFrameCompositeData as specified in the + * stackTrace + * attribute defined in the {@link ThreadInfo#from + * ThreadInfo.from} method. + *
lockedStackDepthjava.lang.Integer
+ *
+ * + * @param cd CompositeData representing a MonitorInfo + * + * @throws IllegalArgumentException if cd does not + * represent a MonitorInfo with the attributes described + * above. + + * @return a MonitorInfo object represented + * by cd if cd is not null; + * null otherwise. + */ + public static MonitorInfo from(CompositeData cd) { + if (cd == null) { + return null; + } + + if (cd instanceof MonitorInfoCompositeData) { + return ((MonitorInfoCompositeData) cd).getMonitorInfo(); + } else { + MonitorInfoCompositeData.validateCompositeData(cd); + String className = MonitorInfoCompositeData.getClassName(cd); + int identityHashCode = MonitorInfoCompositeData.getIdentityHashCode(cd); + int stackDepth = MonitorInfoCompositeData.getLockedStackDepth(cd); + StackTraceElement stackFrame = MonitorInfoCompositeData.getLockedStackFrame(cd); + return new MonitorInfo(className, + identityHashCode, + stackDepth, + stackFrame); + } + } + +}