org.apache.river.outrigger

Interface JavaSpaceAdmin

All Superinterfaces:

DestroyAdmin, JoinAdmin

All Known Subinterfaces:

ConstrainableJavaSpaceAdmin

Deprecated.

Invoke the JoinAdmin and DestroyAdmin methods though those interfaces. A view of the space contents can be obtained through the JavaSpace05.contents method.

public interface JavaSpaceAdmin
extends JoinAdmin, DestroyAdmin

This interface contains all the administrative methods that Outrigger provides to control its JavaSpaces^TM service.

Author:

Sun Microsystems, Inc.

Field Summary

Fields

Modifier and Type	Field and Description
static int	USE_DEFAULT Deprecated. Can be passed to contents to indicate no preference for the fetch size.

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.
JavaSpace	space() Deprecated. Return the space that this administrative object governs.

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

Field Detail

USE_DEFAULT

static final int USE_DEFAULT

Deprecated.

Can be passed to contents to indicate no preference for the fetch size.

See Also:

Constant Field Values

Method Detail

space

JavaSpace space()
         throws RemoteException

Deprecated.

Return the space that this administrative object governs.

Returns:

JavaSpace

Throws:

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

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

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

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 positive, or USE_DEFAULT.