com.goldencode.p2j.util

Interface RemoteMultiplexer<K>

Type Parameters:

K - Type of key to be provided, which is to be mapped to an integral ID.

All Known Subinterfaces:

DirtyShareMultiplexer, IdentityManagerMultiplexer, LockManagerMultiplexer<T>

All Known Implementing Classes:

DatabaseMultiplexer, DirtyShareMultiplexerImpl, IdentityManagerMultiplexerImpl, LockManagerMultiplexerImpl

public interface RemoteMultiplexer<K>

Interface which is implemented by classes which must associate a generic key with an integral identifier, intended to enable the multiplexing of remote service requests.

We multiplex on an integral ID primarily for performance reasons, since this interface is intended to support remote object multiplexing:

• The ID is expected to travel across the network with every service request. Using an integer is much more efficient than serializing an arbitrary object.
• Using an integer allows for a very efficient lookup strategy to be employed by implementors. For instance, the ID can be implemented as an index in an array-based list, providing a much more efficient (and simpler) lookup strategy than say, a hash table with an arbitrary object key.

Author:

ECF

Method Summary

Modifier and Type	Method and Description
int	getMultiplexID(K key) Retrieve a unique ID for the given key.

Method Detail

getMultiplexID

int getMultiplexID(K key)

Retrieve a unique ID for the given key. The ID is guaranteed to be unique within the context of the current server instance and must map consistently to the given key. The intent is that the ID will be used for subsequent service requests which must be multiplexed by the logical construct represented by the key.

Parameters:

key - An object for which a unique ID is needed.

Returns:

ID associated with the given key, which is unique for the server.

Throws:

java.lang.IllegalArgumentException - if key cannot be mapped to an ID on this server.