final class ConstrainableAdminProxy extends AdminProxy implements RemoteMethodControl
Modifier and Type | Field and Description |
---|---|
private MethodConstraints |
constraints
Client constraints for this proxy, or null
|
private static Method[] |
methodMappings
Mappings between public admin methods and Registrar methods
|
private static long |
serialVersionUID |
registrarID, server
Constructor and Description |
---|
ConstrainableAdminProxy(Registrar server,
ServiceID registrarID,
MethodConstraints constraints)
Creates new ConstrainableAdminProxy with given server reference, service
ID and client constraints.
|
Modifier and Type | Method and Description |
---|---|
MethodConstraints |
getConstraints()
Returns the client constraints placed on this proxy.
|
private ProxyTrustIterator |
getProxyTrustIterator()
Returns iterator used by ProxyTrustVerifier to retrieve a trust verifier
for this object.
|
private void |
readObject(ObjectInputStream in)
Verifies that the client constraints for this proxy are consistent with
those set on the underlying server ref.
|
RemoteMethodControl |
setConstraints(MethodConstraints constraints)
Returns a new copy of this proxy with the client constraints set to the
specified constraints.
|
addLookupAttributes, addLookupGroups, addLookupLocators, addMemberGroups, destroy, equals, getInstance, getLookupAttributes, getLookupGroups, getLookupLocators, getMemberGroups, getReferentUuid, getUnicastPort, hashCode, modifyLookupAttributes, removeLookupGroups, removeLookupLocators, removeMemberGroups, setLookupGroups, setLookupLocators, setMemberGroups, setUnicastPort, toString
private static final long serialVersionUID
private static final Method[] methodMappings
private final MethodConstraints constraints
ConstrainableAdminProxy(Registrar server, ServiceID registrarID, MethodConstraints constraints)
public RemoteMethodControl setConstraints(MethodConstraints constraints)
RemoteMethodControl
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.
setConstraints
in interface RemoteMethodControl
constraints
- client constraints, or null
RemoteMethodControl.getConstraints()
public MethodConstraints getConstraints()
RemoteMethodControl
null
, which is interpreted as mapping all
methods to empty constraints (one that has no requirements and no
preferences).getConstraints
in interface RemoteMethodControl
null
RemoteMethodControl.setConstraints(net.jini.core.constraint.MethodConstraints)
private ProxyTrustIterator getProxyTrustIterator()
private void readObject(ObjectInputStream in) throws IOException, ClassNotFoundException
IOException
ClassNotFoundException
Copyright 2007-2013, multiple authors.
Licensed under the Apache License, Version 2.0, see the NOTICE file for attributions.