https://openjdk.java.net/ 
/*
 * Copyright (c) 1999, 2004, 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 javax.management;

// java import
import java.io.Serializable;

// RI import
import javax.management.ObjectName;



Used to represent the object name of an MBean and its class name.
If the MBean is a Dynamic MBean the class name should be retrieved from
the MBeanInfo it provides.

Since:1.5
/**
 * Used to represent the object name of an MBean and its class name.
 * If the MBean is a Dynamic MBean the class name should be retrieved from
 * the <CODE>MBeanInfo</CODE> it provides.
 *
 * @since 1.5
 */
public class ObjectInstance implements Serializable   {


    /* Serial version */
    private static final long serialVersionUID = -4099952623687795850L;

    
@serialObject name.
/**
     * @serial Object name.
     */
    private ObjectName name;

    
@serialClass name.
/**
     * @serial Class name.
     */
    private String className;

    
Allows an object instance to be created given a string representation of
an object name and the full class name, including the package name.

Params:
  • objectName –  A string representation of the object name.
  • className – The full class name, including the package name, of the object instance. If the MBean is a Dynamic MBean the class name corresponds to its 
getMBeanInfo().getClassName().
Throws:
/**
     * Allows an object instance to be created given a string representation of
     * an object name and the full class name, including the package name.
     *
     * @param objectName  A string representation of the object name.
     * @param className The full class name, including the package
     * name, of the object instance.  If the MBean is a Dynamic MBean
     * the class name corresponds to its {@link
     * DynamicMBean#getMBeanInfo()
     * getMBeanInfo()}<code>.getClassName()</code>.
     *
     * @exception MalformedObjectNameException The string passed as a
     * parameter does not have the right format.
     *
     */
    public ObjectInstance(String objectName, String className)
            throws MalformedObjectNameException {
        this(new ObjectName(objectName), className);
    }

    
Allows an object instance to be created given an object name and
the full class name, including the package name.

Params:
  • objectName –  The object name.
  • className –  The full class name, including the package name, of the object instance. If the MBean is a Dynamic MBean the class name corresponds to its 
getMBeanInfo().getClassName().
If the MBean is a Dynamic MBean the class name should be retrieved
from the MBeanInfo it provides.
/**
     * Allows an object instance to be created given an object name and
     * the full class name, including the package name.
     *
     * @param objectName  The object name.
     * @param className  The full class name, including the package
     * name, of the object instance.  If the MBean is a Dynamic MBean
     * the class name corresponds to its {@link
     * DynamicMBean#getMBeanInfo()
     * getMBeanInfo()}<code>.getClassName()</code>.
     * If the MBean is a Dynamic MBean the class name should be retrieved
     * from the <CODE>MBeanInfo</CODE> it provides.
     *
     */
    public ObjectInstance(ObjectName objectName, String className) {
        if (objectName.isPattern()) {
            final IllegalArgumentException iae =
                new IllegalArgumentException("Invalid name->"+
                                             objectName.toString());
            throw new RuntimeOperationsException(iae);
        }
        this.name= objectName;
        this.className= className;
    }


    
Compares the current object instance with another object instance.

Params:
  • object –  The object instance that the current object instance is
    to be compared with.
Returns: True if the two object instances are equal, otherwise false.
/**
     * Compares the current object instance with another object instance.
     *
     * @param object  The object instance that the current object instance is
     *     to be compared with.
     *
     * @return  True if the two object instances are equal, otherwise false.
     */
    public boolean equals(Object object)  {
        if (!(object instanceof ObjectInstance)) {
            return false;
        }
        ObjectInstance val = (ObjectInstance) object;
        if (! name.equals(val.getObjectName())) return false;
        if (className == null)
            return (val.getClassName() == null);
        return className.equals(val.getClassName());
    }

    public int hashCode() {
        final int classHash = ((className==null)?0:className.hashCode());
        return name.hashCode() ^ classHash;
    }

    
Returns the object name part.

Returns:the object name.
/**
     * Returns the object name part.
     *
     * @return the object name.
     */
    public ObjectName getObjectName()  {
        return name;
    }

    
Returns the class part.

Returns:the class name.
/**
     * Returns the class part.
     *
     * @return the class name.
     */
    public String getClassName()  {
        return className;
    }

    
Returns a string representing this ObjectInstance object. The format of this string
is not specified, but users can expect that two ObjectInstances return the same
string if and only if they are equal.

/**
     * Returns a string representing this ObjectInstance object. The format of this string
     * is not specified, but users can expect that two ObjectInstances return the same
     * string if and only if they are equal.
     */
    public String toString() {
        return getClassName() + "[" + getObjectName() + "]";
    }
 }