/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* 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.
*/
/**
* Represents an unresolved role: a role not retrieved from a relation due
* to a problem. It provides the role name, value (if problem when trying to
* set the role) and an integer defining the problem (constants defined in
* RoleStatus).
*
* <p>The <b>serialVersionUID</b> of this class is <code>-48350262537070138L</code>.
*
* @since 1.5
*/
// Serialization compatibility stuff:
// Two serial forms are supported in this class. The selected form depends
// on system property "jmx.serial.form":
// - "1.0" for JMX 1.0
// - any other value for JMX 1.1 and higher
//
// Serial version for old serial form
//
// Serial version for new serial form
//
// Serializable fields in old serial form
{
new ObjectStreamField("myPbType", int.class)
};
//
// Serializable fields in new serial form
{
new ObjectStreamField("problemType", int.class)
};
//
// Actual serial version and serial form
private static final long serialVersionUID;
/** @serialField roleName String Role name
* @serialField roleValue List Role value ({@link List} of {@link ObjectName} objects)
* @serialField problemType int Problem type
*/
private static boolean compat = false;
static {
try {
} catch (Exception e) {
// OK : Too bad, no compat with 1.0
}
if (compat) {
} else {
}
}
//
// END Serialization compatibility stuff
//
// Private members
//
/**
* @serial Role name
*/
/**
* @serial Role value ({@link List} of {@link ObjectName} objects)
*/
/**
* @serial Problem type
*/
private int problemType;
//
// Constructor
//
/**
* Constructor.
*
* @param name name of the role
* @param value value of the role (if problem when setting the
* role)
* @param pbType type of problem (according to known problem types,
* listed as static final members).
*
* @exception IllegalArgumentException if null parameter or incorrect
* problem type
*/
int pbType)
throws IllegalArgumentException {
throw new IllegalArgumentException(excMsg);
}
// Can throw IllegalArgumentException
return;
}
//
// Accessors
//
/**
* Retrieves role name.
*
* @return the role name.
*
* @see #setRoleName
*/
return roleName;
}
/**
* Retrieves role value.
*
* @return an ArrayList of ObjectName objects, the one provided to be set
* in given role. Null if the unresolved role is returned for a read
* access.
*
* @see #setRoleValue
*/
return roleValue;
}
/**
* Retrieves problem type.
*
* @return an integer corresponding to a problem, those being described as
* static final members of current class.
*
* @see #setProblemType
*/
public int getProblemType() {
return problemType;
}
/**
* Sets role name.
*
* @param name the new role name.
*
* @exception IllegalArgumentException if null parameter
*
* @see #getRoleName
*/
throws IllegalArgumentException {
throw new IllegalArgumentException(excMsg);
}
return;
}
/**
* Sets role value.
*
* @param value List of ObjectName objects for referenced
* MBeans not set in role.
*
* @see #getRoleValue
*/
} else {
}
return;
}
/**
* Sets problem type.
*
* @param pbType integer corresponding to a problem. Must be one of
* those described as static final members of current class.
*
* @exception IllegalArgumentException if incorrect problem type
*
* @see #getProblemType
*/
throws IllegalArgumentException {
throw new IllegalArgumentException(excMsg);
}
return;
}
/**
* Clone this object.
*
* @return an independent clone.
*/
try {
} catch (IllegalArgumentException exc) {
return null; // :)
}
}
/**
* Return a string describing this object.
*
* @return a description of this RoleUnresolved object.
*/
objNameIter.hasNext();) {
if (objNameIter.hasNext()) {
}
}
}
}
/**
* Deserializes a {@link RoleUnresolved} from an {@link ObjectInputStream}.
*/
throws IOException, ClassNotFoundException {
if (compat)
{
// Read an object serialized in the old serial form
//
{
throw new NullPointerException("myRoleName");
}
{
throw new NullPointerException("myRoleValue");
}
{
throw new NullPointerException("myPbType");
}
}
else
{
// Read an object serialized in the new serial form
//
}
}
/**
* Serializes a {@link RoleUnresolved} to an {@link ObjectOutputStream}.
*/
throws IOException {
if (compat)
{
// Serializes this instance in the old serial form
//
out.writeFields();
}
else
{
// Serializes this instance in the new serial form
//
}
}
}