com.sun.jini.mahalo
Class TxnMgrProxy.ConstrainableTxnMgrProxy
java.lang.Object
com.sun.jini.mahalo.TxnMgrProxy
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.
Methods inherited from class com.sun.jini.mahalo.TxnMgrProxy |
abort, abort, commit, commit, create, create, equals, getAdmin, getReferentUuid, getState, hashCode, join |
serialVersionUID
private static final long serialVersionUID
- See Also:
- Constant Field Values
TxnMgrProxy.ConstrainableTxnMgrProxy
private TxnMgrProxy.ConstrainableTxnMgrProxy(TxnManager txnMgr,
Uuid id,
MethodConstraints methodConstraints)
- Creates an instance of this class.
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.