net.jini.core.constraint

Class ClientMaxPrincipalType

java.lang.Object

net.jini.core.constraint.ClientMaxPrincipalType

All Implemented Interfaces:

Serializable, InvocationConstraint

public final class ClientMaxPrincipalType
extends Object
implements InvocationConstraint, Serializable

Represents a constraint on the client, such that if the client authenticates itself, then it may only authenticate itself as principals that are instances of one or more of the specified classes. The mechanisms and credentials used to authenticate the client as those principals are not specified by this constraint. A client can use this constraint to limit how much of its identity is exposed in remote calls. For example, if the client's subject contains sufficient information to authenticate as two distinct principals of different types, the client might wish to limit authentication to just one of the two types, if the client believes the other is unnecessary for authorization at the server and wants to avoid revealing that part of its identity to the server.

The use of an instance of this class does not directly imply a ClientAuthentication.YES constraint; that must be specified separately to ensure that the client actually authenticates itself. Because this constraint is conditional on client authentication, it does not conflict with ClientAuthentication.NO.

Since:

2.0

Author:

Sun Microsystems, Inc.

See Also:

ClientAuthentication, ClientMaxPrincipal, ClientMinPrincipal, ClientMinPrincipalType, AuthenticationPermission, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private Class[]	classes The classes.
private static ObjectStreamField[]	serialPersistentFields
private static long	serialVersionUID

Constructor Summary

Constructors

Constructor and Description
ClientMaxPrincipalType(Class clazz) Creates a constraint containing the specified class.
ClientMaxPrincipalType(Class[] classes) Creates a constraint containing the specified classes, with redundant classes removed.
ClientMaxPrincipalType(Collection c) Creates a constraint containing the specified classes, with redundant classes removed.

Method Summary

Modifier and Type	Method and Description
Set	elements() Returns an immutable set of all of the classes.
boolean	equals(Object obj) Two instances of this class are equal if they have the same classes (ignoring order).
int	hashCode() Returns a hash code value for this object.
private void	readObject(ObjectInputStream s) Verifies that there is at least one class, that none of the classes is null, primitive types, array types, or final classes that do not have Principal as a superinterface, and that no class is assignable to any other class.
String	toString() Returns a string representation of this object.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

serialPersistentFields

private static final ObjectStreamField[] serialPersistentFields

classes

private final Class[] classes

The classes.

Constructor Detail

ClientMaxPrincipalType

public ClientMaxPrincipalType(Class clazz)

Creates a constraint containing the specified class. This constructor is equivalent to calling a constructor with a single-element array containing the specified class.

Parameters:

clazz - the class

Throws:

NullPointerException - if the argument is null

IllegalArgumentException - if the argument is a primitive type, an array type, or a final class that does not have Principal as a superinterface

ClientMaxPrincipalType

public ClientMaxPrincipalType(Class[] classes)

Creates a constraint containing the specified classes, with redundant classes removed. Redundant classes are removed as follows: for any two specified classes c1 and c2, if c1.isAssignableFrom(c2) is true, then c2 is removed. That is, duplicates and subtypes are removed. The argument passed to the constructor is neither modified nor retained; subsequent changes to that argument have no effect on the instance created.

Parameters:

classes - the classes

Throws:

IllegalArgumentException - if the argument is empty, or if any element is a primitive type, an array type, or a final class that does not have Principal as a superinterface

NullPointerException - if the argument is null or any element is null

ClientMaxPrincipalType

public ClientMaxPrincipalType(Collection c)

Creates a constraint containing the specified classes, with redundant classes removed. Redundant classes are removed as follows: for any two specified classes c1 and c2, if c1.isAssignableFrom(c2) is true, then c2 is removed. That is, duplicates and subtypes are removed. The argument passed to the constructor is neither modified nor retained; subsequent changes to that argument have no effect on the instance created.

Parameters:

c - the classes

Throws:

IllegalArgumentException - if the argument is empty, or if any element is not a Class, or is a primitive type, an array type, or a final class that does not have Principal as a superinterface

NullPointerException - if the argument is null or any element is null

Method Detail

elements

public Set elements()

Returns an immutable set of all of the classes. Any attempt to modify the set results in an UnsupportedOperationException being thrown.

Returns:

an immutable set of all of the classes

hashCode

public int hashCode()

Returns a hash code value for this object.

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Two instances of this class are equal if they have the same classes (ignoring order).

Overrides:

equals in class Object

toString

public String toString()

Returns a string representation of this object.

Overrides:

toString in class Object

readObject

private void readObject(ObjectInputStream s)
                 throws IOException,
                        ClassNotFoundException

Verifies that there is at least one class, that none of the classes is null, primitive types, array types, or final classes that do not have Principal as a superinterface, and that no class is assignable to any other class.

Throws:

InvalidObjectException - if there are no classes, or any class is null, a primitive type, array type, or final class that does not have Principal as a superinterface, or if any class is assignable to any other class

IOException

ClassNotFoundException