springs.common
Interface ConfigurationParameters

All Superinterfaces:

Debug

All Known Implementing Classes:

Context, ReferenceServer, RegionNameServer_RMIImpl, RMIParameters, RMIUtilities

public interface ConfigurationParameters

extends Debug

Configuration parameters.

Author:

Sergio Ilarri Artigas

Field Summary

static springs.persistence.Persistence	_persistence The persistence mechanism.
static boolean	ACTIVATE_AUTOMATIC_REFERENCES_UPDATES A boolean indicating whether the agent references will be automatically updated.
static boolean	ACTIVATE_NAMING_SERVICE A boolean indicating whether the naming service will be activated.
static java.lang.String	AGENT_REFERENCES_UPDATER_NAME The name of the remote references updater.
static int	BACKLOG Maximum size of the queue for a ServerSocket (the default is 50).
static boolean	BLOCK_UNTIL_REFERENCE_UPDATED_IF_NEEDED When the call to an agent through a reference fails because the agent has moved, set this to to true if we want the retring mechanism to block until the reference is updated.
static boolean	COLLECT_LOGS_CALLS A boolean indicating whether logs of call retries should be collected for statistical purpose.
static java.lang.String	CONTEXT_MANAGER_NAME The name of the agent context manager.
static long	CONTEXT_WATCHING_PERIOD The number of milliseconds for the RNS to watch the contexts.
static boolean	CRASH_WHEN_NOT_ENOUGH_MEMORY Set to true if we want the JVM to crash if there is not enough memory to create a new agent.
static boolean	CREATE_AGENTS_IN_BACKGROUND A boolean that indicates whether the agents should be created in the background.
static int	DEFAULT_PORT_NUMBER_FOR_CONTEXTS The default port number for a context.
static boolean	DELAY_DEPARTURES_IF_NEEDED The minimum number of milliseconds that an agent is forced to stay in a context, and the number of stays used to compute the average stay time.
static boolean	DISABLE_LOGGER Disables the logger.
static int	EXPORT_RETRIAL
static boolean	FORCE_REMOVALS Force the removals from the RMIRegistry.
static boolean	HYBRID_STRATEGY_PROXY_UPDATE
static java.lang.String	INITIAL_SEPARATOR_URL
static boolean	LAZY_UPDATE_AGENT_OBJECT A boolean indicating whether agent references should be lazily updated.
static long	LEASE_VALUE
static long	MAX_MILLIS_TO_WAIT_FOR_ARU ARU that adapts in order to select the time to wait between reference updates.
static long	MAX_MILLIS_TO_WAIT_FOR_UPDATE_REFERENCE
static int	MAX_TRIES_ASSIGNING_THREAD_TO_AGENT Maximum number of retries when assigning a thread to an agent (it could fail if there is not enough memory), and the time between retries.
static int	MAXIMUM_NUMBER_OF_CONSECUTIVE_FAILED_PINGS Maximum number of consecutive pings by the RNS for a context to be considered unavailable.
static long	MILLIS_TO_KEEP_MARKED_TO_REMOVE_REFERENCES
static long	MILLIS_TO_KEEP_UNUSED_LOCAL_REFERENCES
static long	MILLIS_TO_WAIT_FOR_CLASS_SERVER_READY The number of milliseconds to wait to "make sure" that the class server is ready.
static long	MILLIS_TO_WAIT_FOR_RMI_REGISTRY_CREATION The number of milliseconds to wait to "make sure" that a context has been created.
static long	MINIMUM_MILLIS_STAY_AT_CONTEXT
static int	NUM_STAYS_TO_COMPUTE_AVERAGE_STAY
static long	PERIOD_LARC
static int	REBIND_RETRIAL Number of milliseconds between failed rebind()'s.
static java.lang.String	REGION_NAME_SERVER_NAME The name of the Region Name Server.
static springs.util.retries.RetryingStrategy	RETRYING_STRATEGY_FOR_AGENT_SEARCHING
static springs.util.retries.RetryingStrategy	RETRYING_STRATEGY_FOR_CREATIONS
static springs.util.retries.RetryingStrategy	RETRYING_STRATEGY_FOR_INVOKATIONS Strategies for retries.
static springs.util.retries.RetryingStrategy	RETRYING_STRATEGY_FOR_REMOTE_REFERENCE_UPDATING
static boolean	RETURN_CALL_RESULTS_WITH_STATISTICS Indicates whether as a result of a call to an agent's method the statistics could also be returned.
static java.lang.String	RMI_PROTOCOL
static java.lang.String	SECURITY_POLICY
static long	TIME_BETWEEN_TRIES_ASSIGNING_THREAD_TO_AGENT
static int	TIMEOUT_CONNECTION_RMI
static int	TIMEOUT_RMI
static boolean	TRACE_RMI_SERVERS RMI Parameters.
static int	TRACKING_FACTOR Tracking factor for agents.
static boolean	UPDATE_REFERENCES_IN_BACKGROUND A boolean indicating whether the references should be updated in background using a thread in the context that is in charge of this.
static boolean	UPDATE_REFERENCES_WITH_AUXILIARY_THREAD
static boolean	USE_CACHE_OF_CLASSES Put it to true in order to use a cache of classes remotely loaded.
static boolean	USE_SOCKETS_COUNTING_BYTES
static boolean	USE_SPECIFIC_SOCKET_FACTORY
static boolean	WAIT_UNTIL_REFERENCES_UPDATED
static boolean	WRITE_CONTEXT_LOGS_IN_STDOUT Indicates whether logging about the contexts should be shown on the standard output.

Fields inherited from interface springs.common.Debug

DEBUG_ACCESS_SERVICE, DEBUG_BASIC, DEBUG_CLASS_LOADING, DEBUG_CONTEXT_MANAGER, DEBUG_CONTEXT_STATUS_WHEN_MEMORY_ERROR, DEBUG_CREATION, DEBUG_DELETING, DEBUG_NAMING_SERVICE, DEBUG_PROBLEMS_WITH_RMI_CLASS_LOADING, DEBUG_REFERENCE_UPDATER, DEBUG_REMOVAL, DEBUG_RMI, DEBUG_RMI_FAILURES, DEBUG_RNS, DEBUG_SEARCHING, DEBUG_SENDING, DEBUG_TIMES, LOG_CONTEXT_INFO, PRINT_EXCEPTION_FAILED_REMOTE_CALLS, PRINT_FAILED_MOVEMENTS, PRINT_FAILED_REMOTE_CALLS, PRINT_FAILED_REMOTE_REFERENCE_UPDATING, PRINT_FAILED_SEARCHINGS, PRINT_RETRYING_TASK_FAILURES, PROXY_QUEUE

Field Detail

CREATE_AGENTS_IN_BACKGROUND

public static final boolean CREATE_AGENTS_IN_BACKGROUND

A boolean that indicates whether the agents should be created in the background.

See Also:

Constant Field Values

MAX_MILLIS_TO_WAIT_FOR_ARU

public static final long MAX_MILLIS_TO_WAIT_FOR_ARU

ARU that adapts in order to select the time to wait between reference updates.

See Also:

Constant Field Values

MAXIMUM_NUMBER_OF_CONSECUTIVE_FAILED_PINGS

public static final int MAXIMUM_NUMBER_OF_CONSECUTIVE_FAILED_PINGS

Maximum number of consecutive pings by the RNS for a context to be considered unavailable.

See Also:

Constant Field Values

REBIND_RETRIAL

public static final int REBIND_RETRIAL

Number of milliseconds between failed rebind()'s.

See Also:

Constant Field Values

EXPORT_RETRIAL

public static final int EXPORT_RETRIAL

See Also:

Constant Field Values

DEFAULT_PORT_NUMBER_FOR_CONTEXTS

public static final int DEFAULT_PORT_NUMBER_FOR_CONTEXTS

The default port number for a context.

See Also:

Constant Field Values

WRITE_CONTEXT_LOGS_IN_STDOUT

public static final boolean WRITE_CONTEXT_LOGS_IN_STDOUT

Indicates whether logging about the contexts should be shown on the standard output.

See Also:

Constant Field Values

CRASH_WHEN_NOT_ENOUGH_MEMORY

public static final boolean CRASH_WHEN_NOT_ENOUGH_MEMORY

Set to true if we want the JVM to crash if there is not enough memory to create a new agent. This makes no sense in the final version, but only for debugging purposes!

See Also:

Constant Field Values

MAX_TRIES_ASSIGNING_THREAD_TO_AGENT

public static final int MAX_TRIES_ASSIGNING_THREAD_TO_AGENT

Maximum number of retries when assigning a thread to an agent (it could fail if there is not enough memory), and the time between retries.

See Also:

Constant Field Values

TIME_BETWEEN_TRIES_ASSIGNING_THREAD_TO_AGENT

public static final long TIME_BETWEEN_TRIES_ASSIGNING_THREAD_TO_AGENT

See Also:

Constant Field Values

TRACKING_FACTOR

public static final int TRACKING_FACTOR

Tracking factor for agents. It indicates the number of locationServer contexts that will be allocated for a single agent.

See Also:

Constant Field Values

DELAY_DEPARTURES_IF_NEEDED

public static final boolean DELAY_DEPARTURES_IF_NEEDED

The minimum number of milliseconds that an agent is forced to stay in a context, and the number of stays used to compute the average stay time.

See Also:

Constant Field Values

MINIMUM_MILLIS_STAY_AT_CONTEXT

public static final long MINIMUM_MILLIS_STAY_AT_CONTEXT

See Also:

Constant Field Values

NUM_STAYS_TO_COMPUTE_AVERAGE_STAY

public static final int NUM_STAYS_TO_COMPUTE_AVERAGE_STAY

See Also:

Constant Field Values

RETURN_CALL_RESULTS_WITH_STATISTICS

public static final boolean RETURN_CALL_RESULTS_WITH_STATISTICS

Indicates whether as a result of a call to an agent's method the statistics could also be returned.

See Also:

Constant Field Values

ACTIVATE_NAMING_SERVICE

public static final boolean ACTIVATE_NAMING_SERVICE

A boolean indicating whether the naming service will be activated.

See Also:

Constant Field Values

ACTIVATE_AUTOMATIC_REFERENCES_UPDATES

public static final boolean ACTIVATE_AUTOMATIC_REFERENCES_UPDATES

A boolean indicating whether the agent references will be automatically updated. References will not be updated (even if this variable is true) unless the naming service is also active.

See Also:

Constant Field Values

COLLECT_LOGS_CALLS

public static final boolean COLLECT_LOGS_CALLS

A boolean indicating whether logs of call retries should be collected for statistical purpose.

See Also:

Constant Field Values

DISABLE_LOGGER

public static final boolean DISABLE_LOGGER

Disables the logger.

See Also:

Constant Field Values

UPDATE_REFERENCES_IN_BACKGROUND

public static final boolean UPDATE_REFERENCES_IN_BACKGROUND

A boolean indicating whether the references should be updated in background using a thread in the context that is in charge of this. If true, WAIT_UNTIL_REFERENCES_UPDATED indicates whether the agent should block until its references have been updated. If not, UPDATE_REFERENCES_WITH_AUXILIARY_THREAD indicates whether the reference should be updated using an auxiliary thread or not.

See Also:

Constant Field Values

WAIT_UNTIL_REFERENCES_UPDATED

public static final boolean WAIT_UNTIL_REFERENCES_UPDATED

See Also:

Constant Field Values

UPDATE_REFERENCES_WITH_AUXILIARY_THREAD

public static final boolean UPDATE_REFERENCES_WITH_AUXILIARY_THREAD

See Also:

Constant Field Values

HYBRID_STRATEGY_PROXY_UPDATE

public static final boolean HYBRID_STRATEGY_PROXY_UPDATE

See Also:

Constant Field Values

BLOCK_UNTIL_REFERENCE_UPDATED_IF_NEEDED

public static final boolean BLOCK_UNTIL_REFERENCE_UPDATED_IF_NEEDED

When the call to an agent through a reference fails because the agent has moved, set this to to true if we want the retring mechanism to block until the reference is updated. This has a potential disadvantage: imagine that the reference is never updated... then the agent will block forever. For that reason, we set a timeout for the wait.

See Also:

Constant Field Values

MAX_MILLIS_TO_WAIT_FOR_UPDATE_REFERENCE

public static final long MAX_MILLIS_TO_WAIT_FOR_UPDATE_REFERENCE

See Also:

Constant Field Values

LAZY_UPDATE_AGENT_OBJECT

public static final boolean LAZY_UPDATE_AGENT_OBJECT

A boolean indicating whether agent references should be lazily updated.

See Also:

Constant Field Values

RETRYING_STRATEGY_FOR_INVOKATIONS

public static final springs.util.retries.RetryingStrategy RETRYING_STRATEGY_FOR_INVOKATIONS

Strategies for retries.

See Also:

RetryingStrategy

RETRYING_STRATEGY_FOR_AGENT_SEARCHING

public static final springs.util.retries.RetryingStrategy RETRYING_STRATEGY_FOR_AGENT_SEARCHING

RETRYING_STRATEGY_FOR_CREATIONS

public static final springs.util.retries.RetryingStrategy RETRYING_STRATEGY_FOR_CREATIONS

RETRYING_STRATEGY_FOR_REMOTE_REFERENCE_UPDATING

public static final springs.util.retries.RetryingStrategy RETRYING_STRATEGY_FOR_REMOTE_REFERENCE_UPDATING

FORCE_REMOVALS

public static final boolean FORCE_REMOVALS

Force the removals from the RMIRegistry. If the parameter is true, the object is forcibly unexported even if there are pending calls to the remote object or the remote object still has calls in progress. Unexport removes the remote object, obj, from the RMI runtime. If successful, the object can no longer accept incoming RMI calls.

See Also:

Constant Field Values

USE_CACHE_OF_CLASSES

public static final boolean USE_CACHE_OF_CLASSES

Put it to true in order to use a cache of classes remotely loaded.

See Also:

Constant Field Values

_persistence

public static final springs.persistence.Persistence _persistence

The persistence mechanism.

See Also:

Persistence

CONTEXT_MANAGER_NAME

public static final java.lang.String CONTEXT_MANAGER_NAME

The name of the agent context manager.

See Also:

Constant Field Values

REGION_NAME_SERVER_NAME

public static final java.lang.String REGION_NAME_SERVER_NAME

The name of the Region Name Server.

See Also:

Constant Field Values

AGENT_REFERENCES_UPDATER_NAME

public static final java.lang.String AGENT_REFERENCES_UPDATER_NAME

The name of the remote references updater.

See Also:

Constant Field Values

MILLIS_TO_WAIT_FOR_RMI_REGISTRY_CREATION

public static final long MILLIS_TO_WAIT_FOR_RMI_REGISTRY_CREATION

The number of milliseconds to wait to "make sure" that a context has been created.

See Also:

Constant Field Values

BACKLOG

public static final int BACKLOG

Maximum size of the queue for a ServerSocket (the default is 50).

See Also:

Constant Field Values

CONTEXT_WATCHING_PERIOD

public static final long CONTEXT_WATCHING_PERIOD

The number of milliseconds for the RNS to watch the contexts.

See Also:

Constant Field Values

MILLIS_TO_WAIT_FOR_CLASS_SERVER_READY

public static final long MILLIS_TO_WAIT_FOR_CLASS_SERVER_READY

The number of milliseconds to wait to "make sure" that the class server is ready.

See Also:

Constant Field Values

PERIOD_LARC

public static final long PERIOD_LARC

See Also:

Constant Field Values

MILLIS_TO_KEEP_UNUSED_LOCAL_REFERENCES

public static final long MILLIS_TO_KEEP_UNUSED_LOCAL_REFERENCES

See Also:

Constant Field Values

MILLIS_TO_KEEP_MARKED_TO_REMOVE_REFERENCES

public static final long MILLIS_TO_KEEP_MARKED_TO_REMOVE_REFERENCES

See Also:

Constant Field Values

TRACE_RMI_SERVERS

public static final boolean TRACE_RMI_SERVERS

RMI Parameters.

See Also:

Constant Field Values

USE_SOCKETS_COUNTING_BYTES

public static final boolean USE_SOCKETS_COUNTING_BYTES

See Also:

Constant Field Values

USE_SPECIFIC_SOCKET_FACTORY

public static final boolean USE_SPECIFIC_SOCKET_FACTORY

See Also:

Constant Field Values

SECURITY_POLICY

public static final java.lang.String SECURITY_POLICY

See Also:

Constant Field Values

LEASE_VALUE

public static final long LEASE_VALUE

See Also:

Constant Field Values

TIMEOUT_RMI

public static final int TIMEOUT_RMI

See Also:

Constant Field Values

TIMEOUT_CONNECTION_RMI

public static final int TIMEOUT_CONNECTION_RMI

See Also:

Constant Field Values

RMI_PROTOCOL

public static final java.lang.String RMI_PROTOCOL

See Also:

Constant Field Values

INITIAL_SEPARATOR_URL

public static final java.lang.String INITIAL_SEPARATOR_URL

See Also:

Constant Field Values