com.sun.jini.mahalo
Class TxnMgrProxy.ConstrainableTxnMgrProxy

java.lang.Object
  extended by com.sun.jini.mahalo.TxnMgrProxy
      extended by com.sun.jini.mahalo.TxnMgrProxy.ConstrainableTxnMgrProxy
All Implemented Interfaces:
Serializable, Remote, Administrable, RemoteMethodControl, TransactionConstants, TransactionManager, ReferentUuid
Enclosing class:
TxnMgrProxy

static final class TxnMgrProxy.ConstrainableTxnMgrProxy
extends TxnMgrProxy
implements RemoteMethodControl

A subclass of TxnMgrProxy that implements RemoteMethodControl.


Nested Class Summary
 
Nested classes/interfaces inherited from class com.sun.jini.mahalo.TxnMgrProxy
TxnMgrProxy.ConstrainableTxnMgrProxy
 
Nested classes/interfaces inherited from interface net.jini.core.transaction.server.TransactionManager
TransactionManager.Created
 
Field Summary
private static long serialVersionUID
           
 
Fields inherited from class com.sun.jini.mahalo.TxnMgrProxy
backend, proxyID
 
Fields inherited from interface net.jini.core.transaction.server.TransactionConstants
ABORTED, ACTIVE, COMMITTED, NOTCHANGED, PREPARED, VOTING
 
Constructor Summary
private TxnMgrProxy.ConstrainableTxnMgrProxy(TxnManager txnMgr, Uuid id, MethodConstraints methodConstraints)
          Creates an instance of this class.
 
Method Summary
private static TxnManager constrainServer(TxnManager txnMgr, 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.
private  void readObject(ObjectInputStream s)
          Performs various functions related to the trust verification process for the current instance of this proxy class, as detailed in the description for this class.
 RemoteMethodControl setConstraints(MethodConstraints constraints)
          Returns a new copy of this proxy with the client constraints set to the specified constraints.
 
Methods inherited from class com.sun.jini.mahalo.TxnMgrProxy
abort, abort, commit, commit, create, create, equals, getAdmin, getReferentUuid, getState, hashCode, join
 
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
Constructor Detail

TxnMgrProxy.ConstrainableTxnMgrProxy

private TxnMgrProxy.ConstrainableTxnMgrProxy(TxnManager txnMgr,
                                             Uuid id,
                                             MethodConstraints methodConstraints)
Creates an instance of this class.

Method Detail

constrainServer

private static TxnManager constrainServer(TxnManager txnMgr,
                                          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
Performs various functions related to the trust verification process for the current instance of this proxy class, as detailed in the description for this class.

Throws:
InvalidObjectException - if any of the requirements for trust verification (as detailed in the class description) are not satisfied.
IOException
ClassNotFoundException


Copyright 2007-2010, multiple authors.
Licensed under the Apache License, Version 2.0, see the NOTICE file for attributions.