/* * Copyright (c) 2000, 2008, 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.relation;import com.sun.jmx.mbeanserver.GetPropertyAction;import java.io.IOException;import java.io.ObjectInputStream;import java.io.ObjectOutputStream;import java.io.ObjectStreamField;import java.io.Serializable;import java.security.AccessController;import java.util.Iterator;/** * Represents the result of a multiple access to several roles of a relation * (either for reading or writing). * * <p>The <b>serialVersionUID</b> of this class is <code>-6304063118040985512L</code>. * * @since 1.5 */@SuppressWarnings("serial")public class RoleResult implements Serializable { // 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 private static final long oldSerialVersionUID = 3786616013762091099L; // // Serial version for new serial form private static final long newSerialVersionUID = -6304063118040985512L; // // Serializable fields in old serial form private static final ObjectStreamField[] oldSerialPersistentFields = { new ObjectStreamField("myRoleList", RoleList.class), new ObjectStreamField("myRoleUnresList", RoleUnresolvedList.class) }; // // Serializable fields in new serial form private static final ObjectStreamField[] newSerialPersistentFields = { new ObjectStreamField("roleList", RoleList.class), new ObjectStreamField("unresolvedRoleList", RoleUnresolvedList.class) }; // // Actual serial version and serial form private static final long serialVersionUID; /** * @serialField roleList RoleList List of roles successfully accessed * @serialField unresolvedRoleList RoleUnresolvedList List of roles unsuccessfully accessed */ private static final ObjectStreamField[] serialPersistentFields; private static boolean compat = false; static { try { GetPropertyAction act = new GetPropertyAction("jmx.serial.form"); String form = AccessController.doPrivileged(act); compat = (form != null && form.equals("1.0")); } catch (Exception e) { // OK : Too bad, no compat with 1.0 } if (compat) { serialPersistentFields = oldSerialPersistentFields; serialVersionUID = oldSerialVersionUID; } else { serialPersistentFields = newSerialPersistentFields; serialVersionUID = newSerialVersionUID; } } // // END Serialization compatibility stuff // // Private members // /** * @serial List of roles successfully accessed */ private RoleList roleList = null; /** * @serial List of roles unsuccessfully accessed */ private RoleUnresolvedList unresolvedRoleList = null; // // Constructor // /** * Constructor. * * @param list list of roles successfully accessed. * @param unresolvedList list of roles not accessed (with problem * descriptions). */ public RoleResult(RoleList list, RoleUnresolvedList unresolvedList) { setRoles(list); setRolesUnresolved(unresolvedList); return; } // // Accessors // /** * Retrieves list of roles successfully accessed. * * @return a RoleList * * @see #setRoles */ public RoleList getRoles() { return roleList; } /** * Retrieves list of roles unsuccessfully accessed. * * @return a RoleUnresolvedList. * * @see #setRolesUnresolved */ public RoleUnresolvedList getRolesUnresolved() { return unresolvedRoleList; } /** * Sets list of roles successfully accessed. * * @param list list of roles successfully accessed * * @see #getRoles */ public void setRoles(RoleList list) { if (list != null) { roleList = new RoleList(); for (Iterator<?> roleIter = list.iterator(); roleIter.hasNext();) { Role currRole = (Role)(roleIter.next()); roleList.add((Role)(currRole.clone())); } } else { roleList = null; } return; } /** * Sets list of roles unsuccessfully accessed. * * @param unresolvedList list of roles unsuccessfully accessed * * @see #getRolesUnresolved */ public void setRolesUnresolved(RoleUnresolvedList unresolvedList) { if (unresolvedList != null) { unresolvedRoleList = new RoleUnresolvedList(); for (Iterator<?> roleUnresIter = unresolvedList.iterator(); roleUnresIter.hasNext();) { RoleUnresolved currRoleUnres = (RoleUnresolved)(roleUnresIter.next()); unresolvedRoleList.add((RoleUnresolved)(currRoleUnres.clone())); } } else { unresolvedRoleList = null; } return; } /** * Deserializes a {@link RoleResult} from an {@link ObjectInputStream}. */ private void readObject(ObjectInputStream in) throws IOException, ClassNotFoundException { if (compat) { // Read an object serialized in the old serial form // ObjectInputStream.GetField fields = in.readFields(); roleList = (RoleList) fields.get("myRoleList", null); if (fields.defaulted("myRoleList")) { throw new NullPointerException("myRoleList"); } unresolvedRoleList = (RoleUnresolvedList) fields.get("myRoleUnresList", null); if (fields.defaulted("myRoleUnresList")) { throw new NullPointerException("myRoleUnresList"); } } else { // Read an object serialized in the new serial form // in.defaultReadObject(); } } /** * Serializes a {@link RoleResult} to an {@link ObjectOutputStream}. */ private void writeObject(ObjectOutputStream out) throws IOException { if (compat) { // Serializes this instance in the old serial form // ObjectOutputStream.PutField fields = out.putFields(); fields.put("myRoleList", roleList); fields.put("myRoleUnresList", unresolvedRoleList); out.writeFields(); } else { // Serializes this instance in the new serial form // out.defaultWriteObject(); } }}
/*
* Copyright (c) 2000, 2008, 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.relation;
import com.sun.jmx.mbeanserver.GetPropertyAction;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
import java.io.ObjectStreamField;
import java.io.Serializable;
import java.security.AccessController;
import java.util.Iterator;
/**
* Represents the result of a multiple access to several roles of a relation
* (either for reading or writing).
*
* <p>The <b>serialVersionUID</b> of this class is <code>-6304063118040985512L</code>.
*
* @since 1.5
*/
@SuppressWarnings("serial")
public class RoleResult implements Serializable {
// 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
private static final long oldSerialVersionUID = 3786616013762091099L;
//
// Serial version for new serial form
private static final long newSerialVersionUID = -6304063118040985512L;
//
// Serializable fields in old serial form
private static final ObjectStreamField[] oldSerialPersistentFields =
{
new ObjectStreamField("myRoleList", RoleList.class),
new ObjectStreamField("myRoleUnresList", RoleUnresolvedList.class)
};
//
// Serializable fields in new serial form
private static final ObjectStreamField[] newSerialPersistentFields =
{
new ObjectStreamField("roleList", RoleList.class),
new ObjectStreamField("unresolvedRoleList", RoleUnresolvedList.class)
};
//
// Actual serial version and serial form
private static final long serialVersionUID;
/**
* @serialField roleList RoleList List of roles successfully accessed
* @serialField unresolvedRoleList RoleUnresolvedList List of roles unsuccessfully accessed
*/
private static final ObjectStreamField[] serialPersistentFields;
private static boolean compat = false;
static {
try {
GetPropertyAction act = new GetPropertyAction("jmx.serial.form");
String form = AccessController.doPrivileged(act);
compat = (form != null && form.equals("1.0"));
} catch (Exception e) {
// OK : Too bad, no compat with 1.0
}
if (compat) {
serialPersistentFields = oldSerialPersistentFields;
serialVersionUID = oldSerialVersionUID;
} else {
serialPersistentFields = newSerialPersistentFields;
serialVersionUID = newSerialVersionUID;
}
}
//
// END Serialization compatibility stuff
//
// Private members
//
/**
* @serial List of roles successfully accessed
*/
private RoleList roleList = null;
/**
* @serial List of roles unsuccessfully accessed
*/
private RoleUnresolvedList unresolvedRoleList = null;
//
// Constructor
//
/**
* Constructor.
*
* @param list list of roles successfully accessed.
* @param unresolvedList list of roles not accessed (with problem
* descriptions).
*/
public RoleResult(RoleList list,
RoleUnresolvedList unresolvedList) {
setRoles(list);
setRolesUnresolved(unresolvedList);
return;
}
//
// Accessors
//
/**
* Retrieves list of roles successfully accessed.
*
* @return a RoleList
*
* @see #setRoles
*/
public RoleList getRoles() {
return roleList;
}
/**
* Retrieves list of roles unsuccessfully accessed.
*
* @return a RoleUnresolvedList.
*
* @see #setRolesUnresolved
*/
public RoleUnresolvedList getRolesUnresolved() {
return unresolvedRoleList;
}
/**
* Sets list of roles successfully accessed.
*
* @param list list of roles successfully accessed
*
* @see #getRoles
*/
public void setRoles(RoleList list) {
if (list != null) {
roleList = new RoleList();
for (Iterator<?> roleIter = list.iterator();
roleIter.hasNext();) {
Role currRole = (Role)(roleIter.next());
roleList.add((Role)(currRole.clone()));
}
} else {
roleList = null;
}
return;
}
/**
* Sets list of roles unsuccessfully accessed.
*
* @param unresolvedList list of roles unsuccessfully accessed
*
* @see #getRolesUnresolved
*/
public void setRolesUnresolved(RoleUnresolvedList unresolvedList) {
if (unresolvedList != null) {
unresolvedRoleList = new RoleUnresolvedList();
for (Iterator<?> roleUnresIter = unresolvedList.iterator();
roleUnresIter.hasNext();) {
RoleUnresolved currRoleUnres =
(RoleUnresolved)(roleUnresIter.next());
unresolvedRoleList.add((RoleUnresolved)(currRoleUnres.clone()));
}
} else {
unresolvedRoleList = null;
}
return;
}
/**
* Deserializes a {@link RoleResult} from an {@link ObjectInputStream}.
*/
private void readObject(ObjectInputStream in)
throws IOException, ClassNotFoundException {
if (compat)
{
// Read an object serialized in the old serial form
//
ObjectInputStream.GetField fields = in.readFields();
roleList = (RoleList) fields.get("myRoleList", null);
if (fields.defaulted("myRoleList"))
{
throw new NullPointerException("myRoleList");
}
unresolvedRoleList = (RoleUnresolvedList) fields.get("myRoleUnresList", null);
if (fields.defaulted("myRoleUnresList"))
{
throw new NullPointerException("myRoleUnresList");
}
}
else
{
// Read an object serialized in the new serial form
//
in.defaultReadObject();
}
}
/**
* Serializes a {@link RoleResult} to an {@link ObjectOutputStream}.
*/
private void writeObject(ObjectOutputStream out)
throws IOException {
if (compat)
{
// Serializes this instance in the old serial form
//
ObjectOutputStream.PutField fields = out.putFields();
fields.put("myRoleList", roleList);
fields.put("myRoleUnresList", unresolvedRoleList);
out.writeFields();
}
else
{
// Serializes this instance in the new serial form
//
out.defaultWriteObject();
}
}
}