| Space Interface |
Space is a virtual storage area for entries.
Namespace: Com.Tibco.As.Space
Assembly: TIBCO.ActiveSpaces.Common (in TIBCO.ActiveSpaces.Common.dll) Version: 2.0.0.0 (2.1.5.12)
SyntaxThe Space type exposes the following members.
Methods| Name | Description | |
|---|---|---|
 | Browse(BrowserDefBrowserType) | Creates a browser over multiple entries in the Space. |
| Browse(BrowserDefBrowserType, BrowserDef) | Creates a browser over multiple entries in the Space. |
| Browse(BrowserDefBrowserType, BrowserDef, String) | Creates a browser over multiple entries in the Space which match the specified filter. |
| BrowseEvents(EventBrowserDef) | Creates an EventBrowser. |
| BrowseEvents(EventBrowserDef, String) | Creates an EventBrowser over all the events in the Space which match the specified filter. |
| Clear |
Deletes all tuples in the Space. Equivalent to Clear("")
|
| Clear(String) |
Deletes from the Space the tuples that match the specified filter on a "best effort" basis.
If no filter is specified, all tuples are deleted.
This operation does not block other space operations while it is ongoing, so if other clients
perform write operations on entries already removed but before the clear finishes, it might be
the case that the space contains tuples that match the filter after the clear completes. Thus,
it is up to the application to synchronize its clients to guarantee that no write operations
happen while the clear is ongoing if the intent is to clear all entries present in the space at the
time clear is invoked.
Persistence behaviour
When share-all persistence is used, this method does not trigger onWrite callbacks.
It is user's responsibility to perform clear on the back-end database.
When share-nothing persistence is used, the in memory space data is kept synchronized with
the persistence files and entries are removed from file as well.
Listener behaviour
Listeners do not get callbacks for takes performed along with clear execution.
|
| Close |
Invalidates this Space reference with the distribution role it initialized with. If this is the last
reference, current process will leave the space.
|
| CloseAll |
Forcefully leaves the space and stops and invalidates existing listeners and browsers created on the space.
|
| CompareAndPut(Tuple, Tuple) |
Specifies a tuple to look for. If the old value is unmodified, replaces the existing tuple with the
specified value. If there is a mismatch returns the existing value. User does not need to do another get
to retrieve the current value in Space.
|
| CompareAndPut(Tuple, Tuple, PutOptions) |
Same as CompareAndPut(Tuple, Tuple) with PutOptions to specify put options
|
| CompareAndPutAll(ICollectionTuple, ICollectionTuple) |
Batch CompareAndPut operation
|
| CompareAndPutAll(ICollectionTuple, ICollectionTuple, PutOptions) |
Batch CompareAndPut operation with PutOptions
|
| CompareAndPutAll(ICollectionTuple, ICollectionTuple, ICollectionPutOptions) |
Batch CompareAndPut operation with PutOptions
|
| CompareAndTake(Tuple) |
Looks for a tuple containing a specified value, and if it is found, takes the tuple value. If there is
no mismatch compareAndTake returns same java object given as oldTuple
|
| CompareAndTake(Tuple, TakeOptions) |
Looks for a tuple containing a specified value, and if it is found, takes the tuple value. If there is
no mismatch compareAndTake returns same java object given as oldTuple
|
| CompareAndTakeAll(ICollectionTuple) |
Batch CompareAndTake operation
|
| CompareAndTakeAll(ICollectionTuple, TakeOptions) |
Batch CompareAndTake operation with TakeOptions
|
| Get(String) |
The list of matching entries
|
| Get(Tuple) |
Get the tuple
|
| Get(Tuple, GetOptions) |
Get the tuple
|
| GetAll |
Batch Get operation
|
| Invoke(Tuple, InvokeOptions) |
Invokes the appropriate invoke method of the specified class on the Member that seeds (or would seed if there is currently no entry stored in the space for that key) the entry associated with the key specified in tuple
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| Invoke(Tuple, String, Tuple) | Obsolete.
Invokes the appropriate invoke method of the specified class on the Member that seeds (or would seed if there is currently no entry stored in the space for that key) the entry associated with the key specified in tuple
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| Invoke(Tuple, String, Tuple, InvokeOptions) | Obsolete.
Invokes the appropriate invoke method of the specified class on the Member that seeds (or would seed if there is currently no entry stored in the space for that key) the entry associated with the key specified in tuple
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| Invoke(Tuple, String, Tuple, InvokeResultHandler) | Obsolete.
Invokes the appropriate invoke method of the specified class on the Member that seeds (or would seed if there is currently no entry stored in the space for that key) the entry associated with the key specified in tuple
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| Invoke(Tuple, String, Tuple, InvokeResultHandler, InvokeOptions) | Obsolete.
Invokes the appropriate invoke method of the specified class on the Member that seeds (or would seed if there is currently no entry stored in the space for that key) the entry associated with the key specified in tuple
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeT(Tuple, Tuple) | Obsolete.
Invokes the appropriate invoke method of the specified class on the Member that seeds (or would seed if there is currently no entry stored in the space for that key) the entry associated with the key specified in tuple
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeT(Tuple, Tuple, InvokeOptions) | Obsolete.
Invokes the appropriate invoke method of the specified class on the Member that seeds (or would seed if there is currently no entry stored in the space for that key) the entry associated with the key specified in tuple
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeT(Tuple, Tuple, InvokeResultHandler) | Obsolete.
Invokes the appropriate invoke method of the specified class on the Member that seeds (or would seed if there is currently no entry stored in the space for that key) the entry associated with the key specified in tuple
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeT(Tuple, Tuple, InvokeResultHandler, InvokeOptions) | Obsolete.
Invokes the appropriate invoke method of the specified class on the Member that seeds (or would seed if there is currently no entry stored in the space for that key) the entry associated with the key specified in tuple
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeLeeches(InvokeOptions) |
Invokes the appropriate invoke method of the specified class on all the leeches
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeLeeches(Tuple, String) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's leech members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeLeeches(Tuple, String, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's leech members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeLeeches(Tuple, String, InvokeResultListHandler) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's seeding members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeLeeches(Tuple, String, InvokeResultListHandler, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's seeding members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeLeechesT(Tuple) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's leech members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeLeechesT(Tuple, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's leech members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeLeechesT(Tuple, InvokeResultListHandler) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's seeding members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeLeechesT(Tuple, InvokeResultListHandler, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's seeding members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMember(Member, InvokeOptions) |
Invokes the appropriate invoke method of the specified class on the specified Member
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMember(Member, String, Tuple) | Obsolete.
Invokes the appropriate invoke method of the specified class on the specific space member passed as an argument.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMember(Member, String, Tuple, InvokeOptions) | Obsolete.
Invokes the appropriate invoke method of the specified class on the specific space member passed as an argument.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMember(Member, String, Tuple, InvokeResultHandler) | Obsolete.
Invokes the appropriate invoke method of the specified class on the specific space member passed as an argument.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMember(Member, String, Tuple, InvokeResultHandler, InvokeOptions) | Obsolete.
Invokes the appropriate invoke method of the specified class on the specific space member passed as an argument.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMemberT(Member, Tuple) | Obsolete.
Invokes the appropriate invoke method of the specified class on the specific space member passed as an argument.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMemberT(Member, Tuple, InvokeOptions) | Obsolete.
Invokes the appropriate invoke method of the specified class on the specific space member passed as an argument.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMemberT(Member, Tuple, InvokeResultHandler) | Obsolete.
Invokes the appropriate invoke method of the specified class on the specific space member passed as an argument.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMemberT(Member, Tuple, InvokeResultHandler, InvokeOptions) | Obsolete.
Invokes the appropriate invoke method of the specified class on the specific space member passed as an argument.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMembers(InvokeOptions) |
Invokes the appropriate invoke method of the specified class on all the Members (Seeders and Leeches)
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMembers(ICollectionMember, InvokeOptions) |
Invokes the appropriate invoke method of the specified class on the specified Members
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMembers(Tuple, String) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMembers(ICollectionMember, Tuple, String) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMembers(Tuple, String, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMembers(Tuple, String, InvokeResultListHandler) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMembers(ICollectionMember, Tuple, String, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMembers(ICollectionMember, Tuple, String, InvokeResultListHandler) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMembers(Tuple, String, InvokeResultListHandler, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMembers(ICollectionMember, Tuple, String, InvokeResultListHandler, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMembersT(Tuple) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMembersT(ICollectionMember, Tuple) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMembersT(Tuple, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMembersT(Tuple, InvokeResultListHandler) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMembersT(ICollectionMember, Tuple, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMembersT(ICollectionMember, Tuple, InvokeResultListHandler) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMembersT(Tuple, InvokeResultListHandler, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeMembersT(ICollectionMember, Tuple, InvokeResultListHandler, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeRemoteMembers(InvokeOptions) |
Invokes the appropriate invoke method of the specified class on all the remote members
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeRemoteMembers(Tuple, String) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's remote clients.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeRemoteMembers(Tuple, String, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's remote clients.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeRemoteMembers(Tuple, String, InvokeResultListHandler) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's seeding members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeRemoteMembers(Tuple, String, InvokeResultListHandler, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's seeding members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeRemoteMembersT(Tuple) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's remote clients.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeRemoteMembersT(Tuple, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's remote clients.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeRemoteMembersT(Tuple, InvokeResultListHandler) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's seeding members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeRemoteMembersT(Tuple, InvokeResultListHandler, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's seeding members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeSeeders(InvokeOptions) |
Invokes the appropriate invoke method of the specified class on all the seeders
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeSeeders(Tuple, String) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's seeding members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeSeeders(Tuple, String, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's seeding members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeSeeders(Tuple, String, InvokeResultListHandler) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's seeding members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeSeeders(Tuple, String, InvokeResultListHandler, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's seeding members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeSeedersT(Tuple) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's seeding members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeSeedersT(Tuple, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's seeding members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeSeedersT(Tuple, InvokeResultListHandler) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's seeding members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| InvokeSeedersT(Tuple, InvokeResultListHandler, InvokeOptions) | Obsolete.
Invokes in parallel the appropriate invoke method of the specified class on all of the space's seeding members.
Note that this member MUST have the invoked class present in it's CLASSPATH for the invocation to succeed!
|
| Listen(Listener) | Returns a listener on a space for receiving event notifications. |
| Listen(Listener, ListenerDef) |
Returns a listener on a space for receiving event notifications.
Listener definition can also be supplied to specify the distribution and time scopes.
|
| Listen(Listener, String) |
Returns a listener on a space for receiving notifications on events that match the specified filter.
|
| Listen(Listener, ListenerDef, String) |
Returns a listener on a space for receiving notifications on events that match the specified filter.
Listener definition can also be supplied to specify the distribution and time scopes.
|
| Load |
This function is typically used in an implementation of the Persister.OnLoad() function to load the space.
|
| LoadAll |
Batch Load operation
|
| Lock(Tuple) |
Locks the entry stored in the Space which has the key specified in the given Tuple
|
| Lock(Tuple, LockOptions) |
Locks the entry stored in the Space which has the key specified in the given Tuple
|
| LockAll(ICollectionTuple) |
Batch Lock operation
|
| LockAll(ICollectionTuple, LockOptions) |
Batch lock operation with LockOptions
|
| Put(Tuple) |
Stores a Tuple into the Space and returns the corresponding entry
|
| Put(Tuple, PutOptions) |
Stores a tuple into the space and returns the corresponding entry, and allows you to specify
a lock wait value, lock or unlock value, and a forget value.
|
| PutAll(ICollectionTuple) |
Batch Put operation
|
| PutAll(ICollectionTuple, PutOptions) |
Batch Put operation with PutOptions
|
| PutAll(ICollectionTuple, ICollectionPutOptions) |
Batch Put operation with PutOptions
|
| Size |
Returns number of entries in the space which match a given filter
|
| Size(String) |
Returns number of entries in the space which match a given filter
|
| StopListener | Stops a listener and associated thread that was previously created. |
| StopPersister | Stops the persister and associated thread that was previously created |
| StopRouter | Stops the persister and associated thread that was previously created |
| Take(Tuple) |
Returns and atomically removes from the space the tuple (if one exists) whose Tuple key fields match the
key fields of the Tuple provided.
|
| Take(Tuple, TakeOptions) |
Returns and atomically removes from the space the tuple (if one exists) whose Tuple key fields match the
key fields of the Tuple provided. This method allows you to specify lock wait, lock/unlock/forget options
|
| TakeAll(ICollectionTuple) |
Batch Take operation
|
| TakeAll(ICollectionTuple, TakeOptions) |
Batch Take operation with TakeOptions
|
| Unlock(Tuple) |
Unlocks the tuple associated with a key tuple value
|
| Unlock(Tuple, UnlockOptions) |
Unlocks the tuple associated with a key tuple value
|
| UnlockAll(ICollectionTuple) |
Batch Unlock operation
|
| UnlockAll(ICollectionTuple, UnlockOptions) |
Batch Unlock operation with UnlockOptions
|
| WaitForReady |
blocks the client code until space is ready for space operations
|
| WaitForReady(Int64) |
blocks the client until space is ready or timeout happens
|
Properties| Name | Description | |
|---|---|---|
 | Count | Get the number of entries in the Space |
| DistributionRole | Sets the space member's distribution role in the Space to leech or seeder. |
| IsReady |
Gets a value indicating whether the space is ready.
|
| Leeches |
Gets the leeches.
|
| Members |
Gets the members.
|
| Metaspace |
Get the metaspace that the space belongs to
|
| MetaspaceName |
Get the metaspace name
|
| Name | The space name |
| Persister | Returns a persister on a space for receiving persistence actions |
| RemoteMembers |
Gets the remote memebrs.
|
| Router | Returns a router on a space for receiving routing actions |
| Seeders |
Gets the seeders.
|
| SpaceDef | The Space Definition of the sace |
| SpaceState |
Gets the state of the space.
|
Remarks
A space has the following attributes:
-
Name: Space Space name should be unique within a Metaspace and should conform to
the following rules:
- Cannot start with a '$','.' or '_'
- Cannot contain a '>' and '*'
- Space Definition: A space has a definition SpaceDef specified by an ActiveSpaces application or through the ActiveSpace Administration tool
-
Joining a space: an ActiveSpaces application joins a Space with a role. When an ActiveSpaces application joins
a Space, it becomes a Member of the space. Space has state and needs to be in
SpaceState.READY state in order to allow operations on the space. An application can join the space in
either of the following roles:
- ROLE_SEEDER: The Member is willing to store (seed) entries put into the Space by any Member.
- ROLE_LEECH: The Member is not willing to store any entries put into the Space by any Member.
-
Space distribution:
- Distributed: Storage of entries is distributed amongst all seeding Members. Agents automatically join the Space as seeding Members.
- Non-distributed: One of the seeding Members stores all the entries. Agents do not automatically join the space.
-
Tuple storage and retrieval:
- Put: stores a Tuple into the Space
- Get: returns the Tuple (if one exists) whose key fields match the key fields of the Tuple provided.
- Take: returns the Tuple and atomically removes from the Space (if one exists) whose key fields match the key fields of the Tuple provided.
- CompareAndPut: compare and put operation.
- CompareAndTake: compare and take operation.
- Locking: Entries in a Space can be made read-only by locking them. If a Member attempts an operation that will modify a locked key, this operation will block until the lock is cleared or for a maximum amount of time specified in the LockWait SpaceDef attribute.
-
Listeners: ActiveSpaces applications can have callbacks invoked when certain events occur. Following events
can cause callbacks to be invoked:
- Put events: When a Put happens and a new tuple is stored in the Space
- Take events: When a Take happens and a new tuple is stored in the Space
- Expire events: When a Expire happens and a new tuple is stored in the Space
- Browsers: Allow retrieval and operations over multiple entries in the Space. Browsers can be continuously updated according to changes in the Space (i.e. they are always coherent with the space unless the browser's timescope is SNAPSHOT). Operations such as Get, Take and Lock can be invoked on the entries being browsed according to the type of the Browser (TAKE and LOCK browsers are always consistent with the space being browsed).
See Also