co.paralleluniverse.galaxy.quasar

Class StoreImpl

java.lang.Object

co.paralleluniverse.galaxy.quasar.StoreImpl

All Implemented Interfaces:

Store

public class StoreImpl
extends Object
implements Store

Constructor Summary

Constructors

Constructor and Description
StoreImpl(co.paralleluniverse.galaxy.Store store)

Method Summary

Modifier and Type	Method and Description
void	abort(co.paralleluniverse.galaxy.StoreTransaction txn) Ends a transaction after a failure.
long	alloc(int count, co.paralleluniverse.galaxy.StoreTransaction txn) Allocates one or more new (and empty) items in the store. When allocating a single item, it's better to use put(), but some data structures might require allocating an array of items.
co.paralleluniverse.galaxy.StoreTransaction	beginTransaction() Creates a new transaction.
void	commit(co.paralleluniverse.galaxy.StoreTransaction txn) Ends a transaction, and makes all updates visible by all other nodes in the cluster.
void	del(long id, co.paralleluniverse.galaxy.StoreTransaction txn) Deletes an item from the store.
byte[]	get(long id) Retrieves a given data item.
void	get(long id, co.paralleluniverse.common.io.Persistable object) Retrieves a given data item into a Persistable.
byte[]	get(long id, short nodeHint) Retrieves a given data item, using a hint as to its owner in the cluster. If the item is indeed found on the hinted node, the retrieval performance might be superior.
void	get(long id, short nodeHint, co.paralleluniverse.common.io.Persistable object) Retrieves a given data item into a Persistable, using a hint as to its owner in the cluster. If the item is indeed found on the hinted node, the retrieval performance might be superior.
byte[]	getFromOwner(long id, long ownerOf) Retrieves a given data item, using a hint as to its owner in the cluster.
void	getFromOwner(long id, long ownerOf, co.paralleluniverse.common.io.Persistable object) Retrieves a given data item, using a hint as to its owner in the cluster.
int	getMaxItemSize() Returns the maximum size, in bytes, of a data item in the grid.
long	getRoot(String rootName, long id, co.paralleluniverse.galaxy.StoreTransaction txn) Gets or possibly creates a root data item.
long	getRoot(String rootName, co.paralleluniverse.galaxy.StoreTransaction txn) Gets or possibly creates a root data item.
void	gets(long id, co.paralleluniverse.common.io.Persistable object, co.paralleluniverse.galaxy.StoreTransaction txn) Retrieves a given data item into a Persistable, and pins the shared (cached) instance to this node.
void	gets(long id, short nodeHint, co.paralleluniverse.common.io.Persistable object, co.paralleluniverse.galaxy.StoreTransaction txn) Retrieves a given data item into a Persistable with a hint as to its owner in the cluster, and pins the shared (cached) instance to this node.
byte[]	gets(long id, short nodeHint, co.paralleluniverse.galaxy.StoreTransaction txn) Retrieves a given data item with a hint as to its owner in the cluster, and pins the shared (cached) instance to this node.
byte[]	gets(long id, co.paralleluniverse.galaxy.StoreTransaction txn) Retrieves a given data item, and pins the shared (cached) instance to this node.
void	getsFromOwner(long id, long ownerOf, co.paralleluniverse.common.io.Persistable object, co.paralleluniverse.galaxy.StoreTransaction txn) Retrieves a given data item with a hint as to its owner in the cluster, and pins the shared (cached) instance to this node.
byte[]	getsFromOwner(long id, long ownerOf, co.paralleluniverse.galaxy.StoreTransaction txn) Retrieves a given data item with a hint as to its owner in the cluster, and pins the shared (cached) instance to this node.
co.paralleluniverse.galaxy.ItemState	getState(long id) Returns an item's state in the local store.
long	getVersion(long id) Item version
void	getx(long id, co.paralleluniverse.common.io.Persistable object, co.paralleluniverse.galaxy.StoreTransaction txn) Retrieves a given data item into a Persistable, makes this node its exclusive owner, and pins it.
void	getx(long id, short nodeHint, co.paralleluniverse.common.io.Persistable object, co.paralleluniverse.galaxy.StoreTransaction txn) Retrieves a given data item with a hint as to its owner in the cluster, makes this node its exclusive owner, and pins it.
byte[]	getx(long id, short nodeHint, co.paralleluniverse.galaxy.StoreTransaction txn) Retrieves a given data item with a hint as to its owner in the cluster, makes this node its exclusive owner, and pins it.
byte[]	getx(long id, co.paralleluniverse.galaxy.StoreTransaction txn) Retrieves a given data item, makes this node its exclusive owner, and pins it.
void	getxFromOwner(long id, long ownerOf, co.paralleluniverse.common.io.Persistable object, co.paralleluniverse.galaxy.StoreTransaction txn) Retrieves a given data item with a hint as to its owner in the cluster, makes this node its exclusive owner, and pins it.
byte[]	getxFromOwner(long id, long ownerOf, co.paralleluniverse.galaxy.StoreTransaction txn) Retrieves a given data item with a hint as to its owner in the cluster, makes this node its exclusive owner, and pins it.
<T> T	invoke(long id, co.paralleluniverse.galaxy.LineFunction<T> function)
boolean	isPinned(long id) Tests whether an item is pinned on this node.
boolean	isRootCreated(long rootId, co.paralleluniverse.galaxy.StoreTransaction txn) Tests whether a root item has been newly created.
void	push(long id, short... toNodes) Makes the given item available in the given nodes' cache.
void	pushx(long id, short toNode) Makes the given item available in the given node's cache, and makes that node the owner of the item.
long	put(byte[] data, co.paralleluniverse.galaxy.StoreTransaction txn) Puts a new item into the store and returns its (newly allocated) ID.
long	put(ByteBuffer data, co.paralleluniverse.galaxy.StoreTransaction txn) Puts a new item into the store and returns its (newly allocated) ID.
long	put(co.paralleluniverse.common.io.Persistable object, co.paralleluniverse.galaxy.StoreTransaction txn) Puts a new item into the store and returns its (newly allocated) ID.
void	release(long id) Releases a line that's been pinned to this node by one of the gets, getx, put operations.
void	rollback(co.paralleluniverse.galaxy.StoreTransaction txn) Reverts set operations that were performed during the transactions.
void	send(long id, byte[] msg) Sends a message to an item, which will be received by CacheListener.messageReceived on the item's owning node.
void	send(long id, co.paralleluniverse.common.io.Streamable msg) Sends a message to an item, which will be received by CacheListener.messageReceived on the item's owning node.
void	set(long id, byte[] data, co.paralleluniverse.galaxy.StoreTransaction txn) Gains ownership of an item and sets its contents.
void	set(long id, ByteBuffer data, co.paralleluniverse.galaxy.StoreTransaction txn) Gains ownership of an item and sets its contents.
void	set(long id, co.paralleluniverse.common.io.Persistable object, co.paralleluniverse.galaxy.StoreTransaction txn) Gains ownership of an item and sets its contents.
void	setListener(long id, co.paralleluniverse.galaxy.CacheListener listener) Sets a listener listening for local cache events on the given item.
co.paralleluniverse.galaxy.CacheListener	setListenerIfAbsent(long id, co.paralleluniverse.galaxy.CacheListener listener) Sets a listener listening for local cache events on the given item if absent.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

StoreImpl

public StoreImpl(co.paralleluniverse.galaxy.Store store)

Method Detail

alloc

public long alloc(int count,
                  co.paralleluniverse.galaxy.StoreTransaction txn)
           throws co.paralleluniverse.galaxy.TimeoutException,
                  co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Allocates one or more new (and empty) items in the store.

When allocating a single item, it's better to use put(), but some data structures might require allocating an array of items.

Specified by:

alloc in interface Store

Parameters:

count - The number of items to allocate.

txn - The current transaction. May not be null.

Returns:

The id of the first item in the allocated array. The following count - 1 IDs belong to the following elements of the array.

Throws:

co.paralleluniverse.galaxy.TimeoutException

co.paralleluniverse.fibers.SuspendExecution

put

public long put(byte[] data,
                co.paralleluniverse.galaxy.StoreTransaction txn)
         throws co.paralleluniverse.galaxy.TimeoutException,
                co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Puts a new item into the store and returns its (newly allocated) ID.

Specified by:

put in interface Store

Parameters:

data - The item's contents.

txn - The current transaction. May be null, in which case you must later call release(id).

Returns:

The item's (newly allocated) ID.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

put

public long put(ByteBuffer data,
                co.paralleluniverse.galaxy.StoreTransaction txn)
         throws co.paralleluniverse.galaxy.TimeoutException,
                co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Puts a new item into the store and returns its (newly allocated) ID.

Specified by:

put in interface Store

Parameters:

data - The item's contents.

txn - The current transaction. May be null, in which case you must later call release(id).

Returns:

The item's (newly allocated) ID.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

put

public long put(co.paralleluniverse.common.io.Persistable object,
                co.paralleluniverse.galaxy.StoreTransaction txn)
         throws co.paralleluniverse.galaxy.TimeoutException,
                co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Puts a new item into the store and returns its (newly allocated) ID.

Specified by:

put in interface Store

Parameters:

object - The item's contents.

txn - The current transaction. May be null, in which case you must later call release(id).

Returns:

The item's (newly allocated) ID.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

get

public byte[] get(long id)
           throws co.paralleluniverse.galaxy.TimeoutException,
                  co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Retrieves a given data item.

Specified by:

get in interface Store

Parameters:

id - The item's ID.

Returns:

The contents of the item.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

get

public void get(long id,
                co.paralleluniverse.common.io.Persistable object)
         throws co.paralleluniverse.galaxy.TimeoutException,
                co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Retrieves a given data item into a Persistable.

Specified by:

get in interface Store

Parameters:

id - The item's ID.

object - The object into which the contents of the item will be written.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

get

public byte[] get(long id,
                  short nodeHint)
           throws co.paralleluniverse.galaxy.TimeoutException,
                  co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Retrieves a given data item, using a hint as to its owner in the cluster.
If the item is indeed found on the hinted node, the retrieval performance might be superior. If not, the method will still work, but performance may be worse.

Specified by:

get in interface Store

Parameters:

id - The item's ID.

nodeHint - The ID of the node the data item is probably owned by.

Returns:

The contents of the item.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

get

public void get(long id,
                short nodeHint,
                co.paralleluniverse.common.io.Persistable object)
         throws co.paralleluniverse.galaxy.TimeoutException,
                co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Retrieves a given data item into a Persistable, using a hint as to its owner in the cluster.
If the item is indeed found on the hinted node, the retrieval performance might be superior. If not, the method will still work, but performance may be worse.

Specified by:

get in interface Store

Parameters:

id - The item's ID.

nodeHint - The ID of the node the data item is probably owned by.

object - The object into which the contents of the item will be written.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

getFromOwner

public byte[] getFromOwner(long id,
                           long ownerOf)
                    throws co.paralleluniverse.galaxy.TimeoutException,
                           co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Retrieves a given data item, using a hint as to its owner in the cluster. Unlike the direct hint given in get(long, short), the hinted node here is the owner of a given item.
If the item is indeed found on the hinted node, the retrieval performance might be superior. If not, the method will still work, but performance may be worse.

Specified by:

getFromOwner in interface Store

Parameters:

id - The item's ID.

ownerOf - The ID of an item whose owner is probably the owner of the requested item as well.

Returns:

The contents of the item.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

getFromOwner

public void getFromOwner(long id,
                         long ownerOf,
                         co.paralleluniverse.common.io.Persistable object)
                  throws co.paralleluniverse.galaxy.TimeoutException,
                         co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Retrieves a given data item, using a hint as to its owner in the cluster. Unlike the direct hint given in get(long, short, Persistable), the hinted node here is the owner of a given item.
If the item is indeed found on the hinted node, the retrieval performance might be superior. If not, the method will still work, but performance may be worse.

Specified by:

getFromOwner in interface Store

Parameters:

id - The item's ID.

ownerOf - The ID of an item whose owner is probably the owner of the requested item as well.

object - The object into which the contents of the item will be written.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

gets

public byte[] gets(long id,
                   co.paralleluniverse.galaxy.StoreTransaction txn)
            throws co.paralleluniverse.galaxy.TimeoutException,
                   co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Retrieves a given data item, and pins the shared (cached) instance to this node. What this means is that while other nodes will be able to read the same item, no node will be able to update it until until we end the transaction or release it.

Specified by:

gets in interface Store

Parameters:

id - The item's ID.

txn - The current transaction. May be null, in which case you must later call release(id).

Returns:

The contents of the item.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

gets

public void gets(long id,
                 co.paralleluniverse.common.io.Persistable object,
                 co.paralleluniverse.galaxy.StoreTransaction txn)
          throws co.paralleluniverse.galaxy.TimeoutException,
                 co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Retrieves a given data item into a Persistable, and pins the shared (cached) instance to this node. What this means is that while other nodes will be able to read the same item, no node will be able to update it until until we end the transaction or release it.

Specified by:

gets in interface Store

Parameters:

id - The item's ID.

object - The object into which the contents of the item will be written.

txn - The current transaction. May be null, in which case you must later call release(id).

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

gets

public byte[] gets(long id,
                   short nodeHint,
                   co.paralleluniverse.galaxy.StoreTransaction txn)
            throws co.paralleluniverse.galaxy.TimeoutException,
                   co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Retrieves a given data item with a hint as to its owner in the cluster, and pins the shared (cached) instance to this node. What this means is that while other nodes will be able to read the same item, no node will be able to update it until until we end the transaction or release it.
If the item is indeed found on the hinted node, the retrieval performance might be superior. If not, the method will still work, but performance may be worse.

Specified by:

gets in interface Store

Parameters:

id - The item's ID.

nodeHint - The ID of the node the data item is probably owned by.

txn - The current transaction. May be null, in which case you must later call release(id).

Returns:

The contents of the item.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

gets

public void gets(long id,
                 short nodeHint,
                 co.paralleluniverse.common.io.Persistable object,
                 co.paralleluniverse.galaxy.StoreTransaction txn)
          throws co.paralleluniverse.galaxy.TimeoutException,
                 co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Retrieves a given data item into a Persistable with a hint as to its owner in the cluster, and pins the shared (cached) instance to this node. What this means is that while other nodes will be able to read the same item, no node will be able to update it until until we end the transaction or release it.
If the item is indeed found on the hinted node, the retrieval performance might be superior. If not, the method will still work, but performance may be worse.

Specified by:

gets in interface Store

Parameters:

id - The item's ID.

nodeHint - The ID of the node the data item is probably owned by.

object - The object into which the contents of the item will be written.

txn - The current transaction. May be null, in which case you must later call release(id).

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

getsFromOwner

public byte[] getsFromOwner(long id,
                            long ownerOf,
                            co.paralleluniverse.galaxy.StoreTransaction txn)
                     throws co.paralleluniverse.galaxy.TimeoutException,
                            co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Retrieves a given data item with a hint as to its owner in the cluster, and pins the shared (cached) instance to this node. What this means is that while other nodes will be able to update it until until we end the transaction or release it. Unlike the direct hint given in Store.gets(long, short, StoreTransaction), the hinted node here is the owner of a given item.
If the item is indeed found on the hinted node, the retrieval performance might be superior. If not, the method will still work, but performance may be worse.

Specified by:

getsFromOwner in interface Store

Parameters:

id - The item's ID.

ownerOf - The ID of an item whose owner is probably the owner of the requested item as well.

txn - The current transaction. May be null, in which case you must later call release(id).

Returns:

The contents of the item.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

getsFromOwner

public void getsFromOwner(long id,
                          long ownerOf,
                          co.paralleluniverse.common.io.Persistable object,
                          co.paralleluniverse.galaxy.StoreTransaction txn)
                   throws co.paralleluniverse.galaxy.TimeoutException,
                          co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Retrieves a given data item with a hint as to its owner in the cluster, and pins the shared (cached) instance to this node. What this means is that while other nodes will be able to read the same item, no node will be able to update it until until we end the transaction or release it.
Unlike the direct hint given in Store.gets(long, short, Persistable, StoreTransaction), the hinted node here is the owner of a given item.
If the item is indeed found on the hinted node, the retrieval performance might be superior. If not, the method will still work, but performance may be worse.

Specified by:

getsFromOwner in interface Store

Parameters:

id - The item's ID.

ownerOf - The ID of an item whose owner is probably the owner of the requested item as well.

object - The object into which the contents of the item will be written.

txn - The current transaction. May be null, in which case you must later call release(id).

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

getx

public byte[] getx(long id,
                   co.paralleluniverse.galaxy.StoreTransaction txn)
            throws co.paralleluniverse.galaxy.TimeoutException,
                   co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Retrieves a given data item, makes this node its exclusive owner, and pins it. What this means is that no other node will be able to read or update the same item until until we end the transaction or release it. it.

Specified by:

getx in interface Store

Parameters:

id - The item's ID.

txn - The current transaction. May be null, in which case you must later call release(id).

Returns:

The contents of the item.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

getx

public void getx(long id,
                 co.paralleluniverse.common.io.Persistable object,
                 co.paralleluniverse.galaxy.StoreTransaction txn)
          throws co.paralleluniverse.galaxy.TimeoutException,
                 co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Retrieves a given data item into a Persistable, makes this node its exclusive owner, and pins it. What this means is that no other node will be able to read or update the same item until until we end the transaction or release it.

Specified by:

getx in interface Store

Parameters:

id - The item's ID.

object - The object into which the contents of the item will be written.

txn - The current transaction. May be null, in which case you must later call release(id).

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

getx

public byte[] getx(long id,
                   short nodeHint,
                   co.paralleluniverse.galaxy.StoreTransaction txn)
            throws co.paralleluniverse.galaxy.TimeoutException,
                   co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Retrieves a given data item with a hint as to its owner in the cluster, makes this node its exclusive owner, and pins it. What this means is that no other node will be able to read or update the same item until until we end the transaction or release it.
If the item is indeed found on the hinted node, the retrieval performance might be superior. If not, the method will still work, but performance may be worse.

Specified by:

getx in interface Store

Parameters:

id - The item's ID.

nodeHint - The ID of the node the data item is probably owned by.

txn - The current transaction. May be null, in which case you must later call release(id).

Returns:

The contents of the item.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

getx

public void getx(long id,
                 short nodeHint,
                 co.paralleluniverse.common.io.Persistable object,
                 co.paralleluniverse.galaxy.StoreTransaction txn)
          throws co.paralleluniverse.galaxy.TimeoutException,
                 co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Retrieves a given data item with a hint as to its owner in the cluster, makes this node its exclusive owner, and pins it. What this means is that no other node will be able to read or update the same item until we end the transaction or release it.
If the item is indeed found on the hinted node, the retrieval performance might be superior. If not, the method will still work, but performance may be worse.

Specified by:

getx in interface Store

Parameters:

id - The item's ID.

nodeHint - The ID of the node the data item is probably owned by.

object - The object into which the contents of the item will be written.

txn - The current transaction. May be null, in which case you must later call release(id).

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

getxFromOwner

public byte[] getxFromOwner(long id,
                            long ownerOf,
                            co.paralleluniverse.galaxy.StoreTransaction txn)
                     throws co.paralleluniverse.galaxy.TimeoutException,
                            co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Retrieves a given data item with a hint as to its owner in the cluster, makes this node its exclusive owner, and pins it. What this means is that no other node will be able to read or update the same item until we end the transaction or release it. Unlike the direct hint given in Store.getx(long, short, StoreTransaction), the hinted node here is the owner of a given item.
If the item is indeed found on the hinted node, the retrieval performance might be superior. If not, the method will still work, but performance may be worse.

Specified by:

getxFromOwner in interface Store

Parameters:

id - The item's ID.

ownerOf - The ID of an item whose owner is probably the owner of the requested item as well.

txn - The current transaction. May be null, in which case you must later call release(id).

Returns:

The contents of the item.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

getxFromOwner

public void getxFromOwner(long id,
                          long ownerOf,
                          co.paralleluniverse.common.io.Persistable object,
                          co.paralleluniverse.galaxy.StoreTransaction txn)
                   throws co.paralleluniverse.galaxy.TimeoutException,
                          co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Retrieves a given data item with a hint as to its owner in the cluster, makes this node its exclusive owner, and pins it. What this means is that no other node will be able to read or update the same item until we end the transaction or release it. Unlike the direct hint given in Store.getx(long, short, Persistable, StoreTransaction), the hinted node here is the owner of a given item.
If the item is indeed found on the hinted node, the retrieval performance might be superior. If not, the method will still work, but performance may be worse.

Specified by:

getxFromOwner in interface Store

Parameters:

id - The item's ID.

ownerOf - The ID of an item whose owner is probably the owner of the requested item as well.

object - The object into which the contents of the item will be written.

txn - The current transaction. May be null, in which case you must later call release(id).

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

set

public void set(long id,
                byte[] data,
                co.paralleluniverse.galaxy.StoreTransaction txn)
         throws co.paralleluniverse.galaxy.TimeoutException,
                co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Gains ownership of an item and sets its contents. Upon return from this method, the item will be pinned if and only if it had been pinned when the method was called.

Specified by:

set in interface Store

Parameters:

id - The item's ID.

data - The contents to write into the item.

txn - The current transaction. May be null.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

set

public void set(long id,
                ByteBuffer data,
                co.paralleluniverse.galaxy.StoreTransaction txn)
         throws co.paralleluniverse.galaxy.TimeoutException,
                co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Gains ownership of an item and sets its contents. Upon return from this method, the item will be pinned if and only if it had been pinned when the method was called.

Specified by:

set in interface Store

Parameters:

id - The item's ID.

data - The contents to write into the item.

txn - The current transaction. May be null.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

set

public void set(long id,
                co.paralleluniverse.common.io.Persistable object,
                co.paralleluniverse.galaxy.StoreTransaction txn)
         throws co.paralleluniverse.galaxy.TimeoutException,
                co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Gains ownership of an item and sets its contents. Upon return from this method, the item will be pinned if and only if it had been pinned when the method was called.

Specified by:

set in interface Store

Parameters:

id - The item's ID.

object - The contents to write into the item.

txn - The current transaction. May be null.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

invoke

public <T> T invoke(long id,
                    co.paralleluniverse.galaxy.LineFunction<T> function)
             throws co.paralleluniverse.galaxy.TimeoutException,
                    co.paralleluniverse.fibers.SuspendExecution

Specified by:

invoke in interface Store

Throws:

co.paralleluniverse.galaxy.TimeoutException

co.paralleluniverse.fibers.SuspendExecution

del

public void del(long id,
                co.paralleluniverse.galaxy.StoreTransaction txn)
         throws co.paralleluniverse.galaxy.TimeoutException,
                co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Deletes an item from the store.

Specified by:

del in interface Store

txn - The current transaction. May be null.

Throws:

co.paralleluniverse.galaxy.TimeoutException

co.paralleluniverse.fibers.SuspendExecution

getVersion

public long getVersion(long id)

Description copied from interface: Store

Item version

Specified by:

getVersion in interface Store

Parameters:

id - The item's ID.

getMaxItemSize

public int getMaxItemSize()

Description copied from interface: Store

Returns the maximum size, in bytes, of a data item in the grid. Attempts to store larger items will result in an exception. This limit is set in the cache spring-bean configuration.

Specified by:

getMaxItemSize in interface Store

Returns:

The maximum size, in bytes, of a data item in the grid.

beginTransaction

public co.paralleluniverse.galaxy.StoreTransaction beginTransaction()

Description copied from interface: Store

Creates a new transaction.

A transaction can be used by more than one thread.

Specified by:

beginTransaction in interface Store

Returns:

A newly created transaction.

commit

public void commit(co.paralleluniverse.galaxy.StoreTransaction txn)
            throws InterruptedException

Description copied from interface: Store

Ends a transaction, and makes all updates visible by all other nodes in the cluster.

Specified by:

commit in interface Store

Parameters:

txn - The current transaction, which we wish to complete.

Throws:

InterruptedException

abort

public void abort(co.paralleluniverse.galaxy.StoreTransaction txn)
           throws InterruptedException

Description copied from interface: Store

Ends a transaction after a failure.

This method must be called only after rollback() has been called, or a manual rollback has been done.

Specified by:

abort in interface Store

Parameters:

txn - The current transaction, which we wish to complete after failure.

Throws:

InterruptedException

rollback

public void rollback(co.paralleluniverse.galaxy.StoreTransaction txn)

Description copied from interface: Store

Reverts set operations that were performed during the transactions.

This method does not complete the transaction. endTransaction() must still be called.

Specified by:

rollback in interface Store

Parameters:

txn - The current transaction.

release

public void release(long id)

Description copied from interface: Store

Releases a line that's been pinned to this node by one of the gets, getx, put operations.

This method must be called to release a line used in one of the gets, getx, put operations, if they were called with a null transaction.

Specified by:

release in interface Store

getRoot

public long getRoot(String rootName,
                    co.paralleluniverse.galaxy.StoreTransaction txn)
             throws co.paralleluniverse.galaxy.TimeoutException

Description copied from interface: Store

Gets or possibly creates a root data item. The same item ID will be returned when this method is called on any cluster node with the same root name.

You can test if the root has been newly created by this transaction by calling .

Specified by:

getRoot in interface Store

Parameters:

rootName - The root's name.

txn - The current transaction. May not be null.

Returns:

The root item's ID.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

getRoot

public long getRoot(String rootName,
                    long id,
                    co.paralleluniverse.galaxy.StoreTransaction txn)
             throws co.paralleluniverse.galaxy.TimeoutException

Description copied from interface: Store

Gets or possibly creates a root data item. The same item ID will be returned when this method is called on any cluster node with the same root name.

You can test if the root has been newly created by this transaction by calling .

Specified by:

getRoot in interface Store

Parameters:

rootName - The root's name.

id - If the root does not yet exist, it will be created and given this ID.

txn - The current transaction. May not be null.

Returns:

The root item's ID.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

isRootCreated

public boolean isRootCreated(long rootId,
                             co.paralleluniverse.galaxy.StoreTransaction txn)

Description copied from interface: Store

Tests whether a root item has been newly created.

Specified by:

isRootCreated in interface Store

Parameters:

rootId - The root item's ID.

txn - The current transaction.

Returns:

true if the root has been created by the current transaction; false if it existed before current transaction.

setListener

public void setListener(long id,
                        co.paralleluniverse.galaxy.CacheListener listener)

Description copied from interface: Store

Sets a listener listening for local cache events on the given item.

Specified by:

setListener in interface Store

Parameters:

id - The item's ID.

listener - The listener.

setListenerIfAbsent

public co.paralleluniverse.galaxy.CacheListener setListenerIfAbsent(long id,
                                                                    co.paralleluniverse.galaxy.CacheListener listener)

Description copied from interface: Store

Sets a listener listening for local cache events on the given item if absent.

Specified by:

setListenerIfAbsent in interface Store

Parameters:

id - The item's ID.

listener - The listener.

Returns:

The given listener if it was set or the existing one otherwise.

push

public void push(long id,
                 short... toNodes)

Description copied from interface: Store

Makes the given item available in the given nodes' cache.
While this method is never necessary for the correct operation of the grid, in some special circumstances it might improve performance if we know that the given nodes will soon be interested in reading the item (e.g. as a result of a message we're about to send them).

Specified by:

push in interface Store

Parameters:

id - The ID of item to push.

toNodes - The nodes to which the item is to be pushed.

pushx

public void pushx(long id,
                  short toNode)

Description copied from interface: Store

Makes the given item available in the given node's cache, and makes that node the owner of the item.
While this method is never necessary for the correct operation of the grid, in some special circumstances it might improve performance if we know that the given node will soon be interested in reading or updating the item (e.g. as a result of a message we're about to send it).

Specified by:

pushx in interface Store

Parameters:

id - The ID of item to push.

toNode - The node to which the item is to be pushed.

isPinned

public boolean isPinned(long id)

Description copied from interface: Store

Tests whether an item is pinned on this node.

Specified by:

isPinned in interface Store

Parameters:

id - The item's ID.

Returns:

true if the item is pinned; false otherwise.

getState

public co.paralleluniverse.galaxy.ItemState getState(long id)

Description copied from interface: Store

Returns an item's state in the local store.

Specified by:

getState in interface Store

Parameters:

id - The item's ID.

Returns:

The item's state.

send

public void send(long id,
                 co.paralleluniverse.common.io.Streamable msg)
          throws co.paralleluniverse.galaxy.TimeoutException,
                 co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Sends a message to an item, which will be received by CacheListener.messageReceived on the item's owning node.

Specified by:

send in interface Store

Parameters:

id - The item's ID.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution

send

public void send(long id,
                 byte[] msg)
          throws co.paralleluniverse.galaxy.TimeoutException,
                 co.paralleluniverse.fibers.SuspendExecution

Description copied from interface: Store

Sends a message to an item, which will be received by CacheListener.messageReceived on the item's owning node.

Specified by:

send in interface Store

Parameters:

id - The item's ID.

msg - The message.

Throws:

co.paralleluniverse.galaxy.TimeoutException - This exception is thrown if the operation has times-out.

co.paralleluniverse.fibers.SuspendExecution