/*
* Copyright (c) 1999, 2005, Oracle and/or its affiliates. All rights reserved.
* ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*/
package javax.management;
// java import
import java.io.
Serializable;
/**
* Represents an MBean attribute by associating its name with its value.
* The MBean server and other objects use this class to get and set attributes values.
*
* @since 1.5
*/
public class
Attribute implements
Serializable {
/* Serial version */
private static final long
serialVersionUID = 2484220110589082382L;
/**
* @serial Attribute name.
*/
private
String name;
/**
* @serial Attribute value
*/
private
Object value= null;
/**
* Constructs an Attribute object which associates the given attribute name with the given value.
*
* @param name A String containing the name of the attribute to be created. Cannot be null.
* @param value The Object which is assigned to the attribute. This object must be of the same type as the attribute.
*
*/
public
Attribute(
String name,
Object value) {
if (
name == null) {
throw new
RuntimeOperationsException(new
IllegalArgumentException("Attribute name cannot be null "));
}
this.
name =
name;
this.
value =
value;
}
/**
* Returns a String containing the name of the attribute.
*
* @return the name of the attribute.
*/
public
String getName() {
return
name;
}
/**
* Returns an Object that is the value of this attribute.
*
* @return the value of the attribute.
*/
public
Object getValue() {
return
value;
}
/**
* Compares the current Attribute Object with another Attribute Object.
*
* @param object The Attribute that the current Attribute is to be compared with.
*
* @return True if the two Attribute objects are equal, otherwise false.
*/
public boolean
equals(
Object object) {
if (!(
object instanceof
Attribute)) {
return false;
}
Attribute val = (
Attribute)
object;
if (
value == null) {
if (
val.
getValue() == null) {
return
name.
equals(
val.
getName());
} else {
return false;
}
}
return ((
name.
equals(
val.
getName())) &&
(
value.
equals(
val.
getValue())));
}
/**
* Returns a hash code value for this attribute.
*
* @return a hash code value for this attribute.
*/
public int
hashCode() {
return
name.
hashCode() ^ (
value == null ? 0 :
value.
hashCode());
}
/**
* Returns a String object representing this Attribute's value. The format of this
* string is not specified, but users can expect that two Attributes return the
* same string if and only if they are equal.
*/
public
String toString() {
return
getName() + " = " +
getValue();
}
}