net.jini.core.constraint

Class ServerMaxPrincipal

java.lang.Object

net.jini.core.constraint.ServerMaxPrincipal

All Implemented Interfaces:

Serializable, InvocationConstraint

public final class ServerMaxPrincipal
extends Object
implements InvocationConstraint, Serializable

Represents a constraint on the server, such that if the server authenticates itself, then it may only authenticate itself as one or more of the specified principals. The mechanisms and credentials used to authenticate the server as those principals are not specified by this constraint. A server can use this constraint to limit how much of its identity is exposed in remote calls. For example, if the server's subject contains sufficient information to authenticate as two distinct principals, the server might wish to limit authentication to just one of the two, if the server 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 ServerAuthentication.YES constraint; that must be specified separately to ensure that the server actually authenticates itself. Because this constraint is conditional on server authentication, it does not conflict with ServerAuthentication.NO.

Since:

2.0

Author:

Sun Microsystems, Inc.

See Also:

ServerAuthentication, ServerMinPrincipal, AuthenticationPermission, Serialized Form

Constructor Summary

Constructors

Constructor and Description
ServerMaxPrincipal(AtomicSerial.GetArg arg) AtomicSerial constructor.
ServerMaxPrincipal(Collection c) Creates a constraint containing the specified principals, with duplicates removed.
ServerMaxPrincipal(Principal p) Creates a constraint containing the specified principal.
ServerMaxPrincipal(Principal[] principals) Creates a constraint containing the specified principals, with duplicates removed.

Method Summary

Modifier and Type	Method and Description
Set	elements() Returns an immutable set of all of the principals.
boolean	equals(Object obj) Two instances of this class are equal if they have the same principals (ignoring order).
int	hashCode() Returns a hash code value for this object.
String	toString() Returns a string representation of this object.

Methods inherited from class java.lang.Object

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

Constructor Detail

ServerMaxPrincipal

public ServerMaxPrincipal(AtomicSerial.GetArg arg)
                   throws IOException

AtomicSerial constructor.

Parameters:

arg - atomic deserialization parameter

Throws:

IOException - if there are I/O errors while reading from GetArg's underlying InputStream

InvalidObjectException - if object invariants aren't satisfied.

ServerMaxPrincipal

public ServerMaxPrincipal(Principal p)

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

Parameters:

p - the principal

Throws:

NullPointerException - if the argument is null

ServerMaxPrincipal

public ServerMaxPrincipal(Principal[] principals)

Creates a constraint containing the specified principals, with duplicates 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:

principals - the principals

Throws:

IllegalArgumentException - if the argument is empty

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

ServerMaxPrincipal

public ServerMaxPrincipal(Collection c)

Creates a constraint containing the specified principals, with duplicates 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 principals

Throws:

IllegalArgumentException - if the argument is empty or the elements do not all implement the Principal interface

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 principals. Any attempt to modify the set results in an UnsupportedOperationException being thrown.

Returns:

an immutable set of all of the principals

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 principals (ignoring order).

Overrides:

equals in class Object

toString

public String toString()

Returns a string representation of this object.

Overrides:

toString in class Object