1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105
/* * @(#)LockInfo.java 1.6 06/02/27 * * Copyright 2006 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ package java.lang.management; import javax.management.openmbean.CompositeData; import java.util.concurrent.locks.*; import java.beans.ConstructorProperties; /** * Information about a <em>lock</em>. A lock can be a built-in object monitor, * an <em>ownable synchronizer</em>, or the {@link Condition Condition} * object associated with synchronizers. * <p> * <a name="OwnableSynchronizer">An ownable synchronizer</a> is * a synchronizer that may be exclusively owned by a thread and uses * {@link AbstractOwnableSynchronizer AbstractOwnableSynchronizer} * (or its subclass) to implement its synchronization property. * {@link ReentrantLock ReentrantLock} and * {@link ReentrantReadWriteLock ReentrantReadWriteLock} are * two examples of ownable synchronizers provided by the platform. * * <h4><a name="MappedType">MXBean Mapping</a></h4> * <tt>LockInfo</tt> is mapped to a {@link CompositeData CompositeData} * as specified in the <a href="../../../javax/management/MXBean.html#mapping-rules"> * type mapping rules</a> of {@linkplain javax.management.MXBean MXBeans}. * * @see java.util.concurrent.locks.AbstractOwnableSynchronizer * @see java.util.concurrent.locks.Condition * * @author Mandy Chung * @version 1.6, 02/27/06 * @since 1.6 */ public class LockInfo { private String className; private int identityHashCode; /** * Constructs a <tt>LockInfo</tt> 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. */ @ConstructorProperties({__JOT_PIECE_11__, __JOT_PIECE_12__}) public LockInfo(String className, int identityHashCode) { if (className == null) { throw new NullPointerException("Parameter className cannot be null"); } this.className = className; this.identityHashCode = identityHashCode; } /** * package-private constructors */ LockInfo(Object lock) { this.className = lock.getClass().getName(); this.identityHashCode = System.identityHashCode(lock); } /** * Returns the fully qualified name of the class of the lock object. * * @return the fully qualified name of the class of the lock object. */ public String getClassName() { return className; } /** * Returns the identity hash code of the lock object * returned from the {@link System#identityHashCode} method. * * @return the identity hash code of the lock object. */ public int getIdentityHashCode() { return identityHashCode; } /** * Returns a string representation of a lock. The returned * string representation consists of the name of the class of the * lock object, the at-sign character `@', and the unsigned * hexadecimal representation of the <em>identity</em> hash code * of the object. This method returns a string equals to the value of: * <blockquote> * <pre> * lock.getClass().getName() + '@' + Integer.toHexString(System.identityHashCode(lock)) * </pre></blockquote> * where <tt>lock</tt> is the lock object. * * @return the string representation of a lock. */ public String toString() { return className + '@' + Integer.toHexString(identityHashCode); } }