final class ConstrainableAdminProxy extends AdminProxy implements RemoteMethodControl, ConstrainableJavaSpaceAdmin
AdminProxy
Modifier and Type | Field and Description |
---|---|
private MethodConstraints |
methodConstraints
Client constraints placed on this proxy (may be
null |
private static Method[] |
methodMapArray
Array containing element pairs in which each pair of elements
represents a mapping between two methods having the following
characteristics:
the first element in the pair is one of the public, remote
method(s) that may be invoked by the client through
AdminProxy . |
(package private) static long |
serialVersionUID |
admin, spaceUuid
USE_DEFAULT
Constructor and Description |
---|
ConstrainableAdminProxy(OutriggerAdmin admin,
Uuid spaceUuid,
MethodConstraints methodConstraints)
Create a new
ConstrainableAdminProxy . |
Modifier and Type | Method and Description |
---|---|
private static OutriggerAdmin |
constrainServer(OutriggerAdmin server,
MethodConstraints constraints)
Returns a copy of the given
OutriggerAdmin proxy
having the client method constraints that result after
mapping defined by methodMapArray is applied. |
AdminIterator |
contents(Entry tmpl,
Transaction tr,
int fetchSize)
Override super class to create secure
IteratorProxy s |
AdminIterator |
contents(Entry tmpl,
Transaction txn,
int fetchSize,
MethodConstraints constraints)
Return an
AdminIterator that will iterate over all
the entries in the space that match the given template and are
visible under the given transaction. |
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) |
RemoteMethodControl |
setConstraints(MethodConstraints constraints)
Returns a new copy of this proxy with the client constraints set to the
specified constraints.
|
addLookupAttributes, addLookupGroups, addLookupLocators, contents, destroy, equals, getLookupAttributes, getLookupGroups, getLookupLocators, getReferentUuid, hashCode, modifyLookupAttributes, removeLookupGroups, removeLookupLocators, setLookupGroups, setLookupLocators, space, toString
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
contents
space
addLookupAttributes, addLookupGroups, addLookupLocators, getLookupAttributes, getLookupGroups, getLookupLocators, modifyLookupAttributes, removeLookupGroups, removeLookupLocators, setLookupGroups, setLookupLocators
destroy
static final long serialVersionUID
private static final Method[] methodMapArray
AdminProxy
.
private final MethodConstraints methodConstraints
null
ConstrainableAdminProxy(OutriggerAdmin admin, Uuid spaceUuid, MethodConstraints methodConstraints)
ConstrainableAdminProxy
.admin
- reference to remote server for the space.spaceUuid
- universal unique ID for the space.methodConstraints
- the client method constraints to place on
this proxy (may be null
).NullPointerException
- if admin
or
spaceUuid
is null
.ClassCastException
- if admin
does not implement RemoteMethodControl
.private static OutriggerAdmin constrainServer(OutriggerAdmin server, MethodConstraints constraints)
OutriggerAdmin
proxy
having the client method constraints that result after
mapping defined by methodMapArray is applied.server
- The proxy to attach constrains too.constraints
- The source method constraints.NullPointerException
- if server
is
null
.ClassCastException
- if server
does not implement RemoteMethodControl
.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()
ProxyTrustVerifier
to retrieve this object's
trust verifier.private void readObject(ObjectInputStream s) throws IOException, ClassNotFoundException
IOException
ClassNotFoundException
public AdminIterator contents(Entry tmpl, Transaction tr, int fetchSize) throws TransactionException, RemoteException
IteratorProxy
scontents
in interface ConstrainableJavaSpaceAdmin
contents
in interface JavaSpaceAdmin
contents
in class AdminProxy
tmpl
- The iterator should return only entries that match
tmpltr
- The iterator should return only entries that match
this transactionfetchSize
- advice on how many entries to fetch when the iterator
has to go to the server for more entries.TransactionException
- if there is a problem with
txn
.RemoteException
- if communications with the
server is necessary and it can not be completed.public AdminIterator contents(Entry tmpl, Transaction txn, int fetchSize, MethodConstraints constraints) throws TransactionException, RemoteException
ConstrainableJavaSpaceAdmin
AdminIterator
that will iterate over all
the entries in the space that match the given template and are
visible under the given transaction. The returned iterator
will support proxy trust verification and will enforce
the specified MethodConstraints
.
The interactions between other operations on the space and the returned iterator are undefined
contents
in interface ConstrainableJavaSpaceAdmin
tmpl
- The iterator should return only entries that match
tmpltxn
- The iterator should return only entries that match
this transactionfetchSize
- advice on how many entries to fetch when the
iterator has to go to the server for more entries.constraints
- the MethodConstraints
the
returned proxy should enforce.TransactionException
- if there is a problem with
txn
.RemoteException
- if communications with the
server is necessary and it can not be completed.Copyright 2007-2013, multiple authors.
Licensed under the Apache License, Version 2.0, see the NOTICE file for attributions.