org.apache.river.outrigger

Interface ConstrainableJavaSpaceAdmin

All Superinterfaces:

DestroyAdmin, JavaSpaceAdmin, JoinAdmin

Deprecated.

The JavaSpace05.contents method can be used to view the space's contents.

public interface ConstrainableJavaSpaceAdmin
extends JavaSpaceAdmin

Sub-interface of JavaSpaceAdmin that adds a method that allows iterators to be created with a given set of constraints.

Since:

2.0

Author:

Sun Microsystems, Inc.

Field Summary

Fields inherited from interface org.apache.river.outrigger.JavaSpaceAdmin

USE_DEFAULT

Method Summary

Modifier and Type	Method and Description
AdminIterator	contents(Entry tmpl, Transaction txn) Deprecated. 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.
AdminIterator	contents(Entry tmpl, Transaction txn, int fetchSize) Deprecated. 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.
AdminIterator	contents(Entry tmpl, Transaction txn, int fetchSize, MethodConstraints constrains) Deprecated. 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.

Methods inherited from interface org.apache.river.outrigger.JavaSpaceAdmin

space

Methods inherited from interface net.jini.admin.JoinAdmin

addLookupAttributes, addLookupGroups, addLookupLocators, getLookupAttributes, getLookupGroups, getLookupLocators, modifyLookupAttributes, removeLookupGroups, removeLookupLocators, setLookupGroups, setLookupLocators

Methods inherited from interface org.apache.river.admin.DestroyAdmin

destroy

Method Detail

contents

AdminIterator contents(Entry tmpl,
                       Transaction txn)
                throws TransactionException,
                       RemoteException

Deprecated.

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.

The interactions between other operations on the space and the returned iterator are undefined

Note, because this is a convenience method for contents(Entry, Transaction, int, MethodConstraints) the constraints associated with contents(Entry, Transaction, int, MethodConstraints) are used for any calls though this method, not the constraints associated with this method.

Specified by:

contents in interface JavaSpaceAdmin

Parameters:

tmpl - The iterator should return only entries that match tmpl

txn - The iterator should return only entries that match this transaction

Returns:

AdminIterator

Throws:

RemoteException - if communications with the server is necessary and it can not be completed.

TransactionException - if there is a problem with txn.

SecurityException - If the space is performing access control and it can not be confirmed that the subject making this call has permission to create an AdminIterator with the specified template and transaction.

contents

AdminIterator contents(Entry tmpl,
                       Transaction txn,
                       int fetchSize)
                throws TransactionException,
                       RemoteException

Deprecated.

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.

The interactions between other operations on the space and the returned iterator are undefined

Note, because this is a convenience method for contents(Entry, Transaction, int, MethodConstraints) the constraints associated with contents(Entry, Transaction, int, MethodConstraints) are used for any calls though this method, not the constraints associated with this method.

Specified by:

contents in interface JavaSpaceAdmin

Parameters:

tmpl - The iterator should return only entries that match tmpl

txn - The iterator should return only entries that match this transaction

fetchSize - advice on how many entries to fetch when the iterator has to go to the server for more entries.

Returns:

AdminIterator

Throws:

RemoteException - if communications with the server is necessary and it can not be completed.

TransactionException - if there is a problem with txn.

SecurityException - If the space is performing access control and it can not be confirmed that the subject making this call has permission to create an AdminIterator with the specified template and transaction.

IllegalArgumentException - if fetchSize is not postive, or USE_DEFUALT.

contents

AdminIterator contents(Entry tmpl,
                       Transaction txn,
                       int fetchSize,
                       MethodConstraints constrains)
                throws TransactionException,
                       RemoteException

Deprecated.

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. 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

Parameters:

tmpl - The iterator should return only entries that match tmpl

txn - The iterator should return only entries that match this transaction

fetchSize - advice on how many entries to fetch when the iterator has to go to the server for more entries.

constrains - the MethodConstraints the returned proxy should enforce.

Returns:

An object that can be used to iterate over entries in the space.

Throws:

RemoteException - if communications with the server is necessary and it can not be completed.

TransactionException - if there is a problem with txn.

SecurityException - If the space is performing access control and it can not be confirmed that the subject making this call has permission to create an AdminIterator with the specified template and transaction.

IllegalArgumentException - if fetchSize is not postive, or USE_DEFUALT.