org.apache.river.mercury

Class Registration.ConstrainableRegistration

java.lang.Object

org.apache.river.mercury.Registration

org.apache.river.mercury.Registration.ConstrainableRegistration

All Implemented Interfaces:

Serializable, RemoteMethodControl, MailboxPullRegistration, MailboxRegistration, ReferentUuid

Enclosing class:

Registration

static final class Registration.ConstrainableRegistration
extends Registration
implements RemoteMethodControl

A subclass of Registration that implements RemoteMethodControl.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.river.mercury.Registration

Registration.ConstrainableRegistration

Field Summary

Fields

Modifier and Type	Field and Description
private MethodConstraints	methodConstraints The client constraints placed on this proxy or null.
private static Method[]	methodMap1
private static long	serialVersionUID

Fields inherited from class org.apache.river.mercury.Registration

lease, listener, mailbox, registrationID

Constructor Summary

Constructors

Modifier	Constructor and Description
private	ConstrainableRegistration(Uuid id, MailboxBackEnd server, Lease lease, MethodConstraints methodConstraints) Creates an instance of this class.

Method Summary

Modifier and Type	Method and Description
private static MailboxBackEnd	constrainServer(MailboxBackEnd server, MethodConstraints methodConstraints) Returns a copy of the server proxy with the specified client constraints and methods mapping.
MethodConstraints	getConstraints() Returns the client constraints placed on this proxy.
private ProxyTrustIterator	getProxyTrustIterator() Returns a proxy trust iterator that is used in ProxyTrustVerifier to retrieve this object's trust verifier.
RemoteEventIterator	getRemoteEvents(long maxEvents, long timeout)
private void	readObject(ObjectInputStream s) Verifies that the registrationID, lease and mailbox fields are not null, that mailbox implements RemoteMethodControl, and that the mailbox proxy has the appropriate method constraints.
RemoteMethodControl	setConstraints(MethodConstraints constraints) Returns a new copy of this proxy with the client constraints set to the specified constraints.

Methods inherited from class org.apache.river.mercury.Registration

addUnknownEvents, create, disableDelivery, enableDelivery, equals, getLease, getListener, getReferentUuid, getRemoteEvents, hashCode

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

methodMap1

private static final Method[] methodMap1

methodConstraints

private MethodConstraints methodConstraints

The client constraints placed on this proxy or null.

Constructor Detail

ConstrainableRegistration

private ConstrainableRegistration(Uuid id,
                                  MailboxBackEnd server,
                                  Lease lease,
                                  MethodConstraints methodConstraints)

Creates an instance of this class.

Method Detail

getRemoteEvents

public RemoteEventIterator getRemoteEvents(long maxEvents,
                                           long timeout)
                                    throws RemoteException

Throws:

RemoteException

constrainServer

private static MailboxBackEnd constrainServer(MailboxBackEnd server,
                                              MethodConstraints methodConstraints)

Returns a copy of the server proxy with the specified client constraints and methods mapping.

setConstraints

public RemoteMethodControl setConstraints(MethodConstraints constraints)

Returns a new copy of this proxy with the client constraints set to the specified constraints. These constraints completely replace (in the copy) any client constraints previously placed on this proxy; calling the getConstraints method of the copy returns the identical constraints instance. The original proxy is not modified. A null value is interpreted as mapping all methods to empty constraints (one that has no requirements and no preferences). For any given remote call, the specific client requirements and preferences to be satisfied are given by the return value of invoking the getConstraints method of the specified MethodConstraints instance with a Method object representing the remote method.

Client constraints placed on a proxy are included in the serialized state of the proxy. This allows third-party services to be transparent to the client's needs. For example, if remote object s1 obtains a proxy for remote object s2, and passes that proxy to remote object s3, expecting s3 to invoke a remote method on s2, then s1 can control that call by placing its constraints directly on the proxy before passing it to s3. If s3 does not wish to be transparent in this way, then it should explicitly replace the client constraints on received proxies with whatever constraints are appropriate to implement its own policy.

Specified by:

setConstraints in interface RemoteMethodControl

Parameters:

constraints - client constraints, or null

Returns:

a new copy of this proxy with the client constraints set to the specified constraints

See Also:

RemoteMethodControl.getConstraints()

getConstraints

public MethodConstraints getConstraints()

Returns the client constraints placed on this proxy. The return value can be null, which is interpreted as mapping all methods to empty constraints (one that has no requirements and no preferences).

Specified by:

getConstraints in interface RemoteMethodControl

Returns:

the client constraints, or null

See Also:

RemoteMethodControl.setConstraints(net.jini.core.constraint.MethodConstraints)

getProxyTrustIterator

private ProxyTrustIterator getProxyTrustIterator()

Returns a proxy trust iterator that is used in ProxyTrustVerifier to retrieve this object's trust verifier.

readObject

private void readObject(ObjectInputStream s)
                 throws IOException,
                        ClassNotFoundException

Verifies that the registrationID, lease and mailbox fields are not null, that mailbox implements RemoteMethodControl, and that the mailbox proxy has the appropriate method constraints.

Throws:

InvalidObjectException - if registrationID, lease or mailbox is null, if mailbox does not implement RemoteMethodControl, or if server has the wrong constraints

IOException

ClassNotFoundException